OrgManager takes Github Organization invites to a new level! Read more about OrgManager on Medium.
Not everyone can afford a server, nor do they have the skills to set up a modern PHP application, so OrgManager provides a hosted version you can use for FREE. You can access the hosted version at https://orgmanager.miguelpiedrafita.com. In return, please report any bugs you encounter, so we can continue improving!
As you may have guessed, you can use OrgManager to join the OrgManager organization.
These instructions will get you the beta version of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
To install OrgManager you'll need:
- A web server of your choice - (We recommend hotel, as it is easy to setup and doesn't require any configuration.)
- PHP - (At least v5.6.4, although v7.* is recommended. Installing PHP)
- Some PHP libraries - (OpenSSL, PDO, Mbstring, Tokenizer, XML) (Google is your friend π)
- Composer - (Install Composer)
- MySQL database - (You can get one online for free)
- Git - (Install GIT)
Now that you've verified that you have that, let's start...
- Download beta version (Just clone the master branch)
Just open your terminal/console and run
git clone https://github.com/orgmanager/orgmanager
and you'll have the beta version on your new orgmanager
folder.
- Add OrgManager to your server.
Just google instructions for your server. If you're using hotel, just open the OrgManager folder with the terminal/console and run
hotel add 'php artisan serve --port $PORT'
Now, if you configured custom domains, you can now access orgmanager.{yourtld}
. If you didn't, access localhost:2000
and click OrgManager. Yeah, it should be showing that huge error, don't worry π
- Setup .env
Copy the .env.example
file to a .env
file. Open the .env file with your favorite text editor/IDE and fill the database, reCaptcha and GitHub settings. (You can leave the rest as they are)
- Finish the setup
Open the OrgManager folder with the terminal/console and run
php artisan key:generate && php artisan migrate
- Done!
You have now the OrgManager beta version up an running in your server! (Note that OrgManager is not auto-updated, read the updating section for more info).
We use the Laravel testing functionalities and PHPUnit to add automated testing to OrgManager.
By default, the tests will run in a special database called orgmanager_test
in localhost
with username root
and password root
. If you need to change this, edit the .env.testing
file. This is an example of a customized .env.testing file:
APP_ENV=testing
APP_KEY=base64:GIkaQ57IIVtTeTQOIh7eAFo1FAcoWkfwYPkfcOyusW4=
DB_CONNECTION=travis
DB_TEST_HOST=database_host
DB_TEST_DATABASE=database_name
DB_TEST_USERNAME=database_username
DB_TEST_PASSWORD=database_password
CACHE_DRIVER=array
SESSION_DRIVER=array
QUEUE_DRIVER=sync
Once you've customized your .env.testing file, you have to migrate the database to your test database. You can do this by running php artisan migrate --env=testing
.
To run the tests, just run composer test
.
These instructions will get you the lastest stable version of the project up and running on your server for production purposes. See the development version section for notes on how to setup the beta version on your local machine.
To install OrgManager you'll need:
- A web server of your choice - (We recommend Apache or Nginx for production, but any web server you have should work).
- PHP - (At least v5.6.4, although v7.* is recommended. Installing PHP)
- Some PHP libraries - (OpenSSL, PDO, Mbstring, Tokenizer, XML) (Google is your friend π)
- Composer - (Install Composer)
- MySQL database - (Although this isn't recommended for a production enviroment, you can get them online for free)
- SSH access to your server (physical access is also valid)
Now that you've verified that you have that, let's start...
- Download lastest stable version
Download the lastest release and unzip it on your server.
- Add OrgManager to your server.
Just google instructions for your server. Yeah, it should be showing that huge error after setup, don't worry π
- Setup .env
Copy the .env.example
file to a .env
file. Open the .env file with your favorite text editor/IDE and fill the database, reCaptcha and GitHub settings. (You can leave the rest as they are, although it is recommended setting up Bugsnag in production).
REMEMBER TO SET DEBUG TO FALSE, AND TO CHANGE APP_ENV TO PROD IF THEY AREN'T!
- Finish the setup
Open the OrgManager folder with the terminal/console and run
composer install
and
php artisan key:generate && php artisan migrate
- Done!
You have now the lastest OrgManager stable version up an running in your server! (Note that OrgManager is not auto-updated, read the updating section for more info).
OrgManager is under active development, and that means it gets lots of updates, bug fixes and new features. Follow the guides below to update OrgManager to the lastest version:
This is the easiest one.
- Get lastest code
Open the orgmanager folder in the terminal/console and run
git pull origin master
and you're done.
FOR NEW RELEASES, REMEMBER TO CHECK THE UPGRADING GUIDE, IF ANY. YOU CAN FIND IT IN THE RELEASES PAGE.
New features deserve it, go ahead!
- Download lastest stable version
Download the lastest release and unzip it on your server.
REMEMBER TO FOLLOW THE UPGRADING GUIDE, IF ANY. YOU CAN FIND IT IN THE RELEASE PAGE.
- PHP - The programming language used.
- MySQL - Database software used.
- Laravel 5.3 - The web framework used.
- Composer - The Dependency Management software used.
- Github - Thank you for your awesome API, and to the awesome people at Github Support!
- Eloquent OAuth (Laravel 5) - The OAuth library used.
- PHP Github API & Laravel Version - The API clients used
- PHP reCaptcha - The reCaptcha Client
- PrimerCSS, Bootstrap & MaterializeCSS - The frontend frameworks used
- Octicons - The icons used
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the releases page.
Facing an issue? Want to meet other OrgManager users? Just want to say hello?
Here are the official support channels we provide:
- Github Issues - You can open an issue for things like requesting new features or reporting bugs.
- Hosted Version Chat - If you've used the hosted version, you might have noticed that there is a chat icon on the bottom right corner. That chat is used for things related to the hosted version.
- Gittler chat - We have a little Gitter chatroom for discussing things about the project, meeting other users and anything else you think of. Don't be afraid to say hello!
- Email - You can send a mail to orgmanager@miguelpiedrafita.com to discuss anything with the main developer, Miguel Piedrafita.
Does your organization use OrgManager? Ask your manager or marketing team if you're interested in supporting our project. Support will allow the maintainers to dedicate more time for maintenance and new features for everyone. Also, your company's logo will show on GitHub and on our site --who doesn't want a little extra exposure?
- Miguel Piedrafita - Idea, Code & Hosting
See also the list of contributors who participated in this project.
This project is licensed under the Mozilla Public License - see the LICENSE.md file for details
- Laracasts & The Laravel Community - You are fantastic!
- @simonv3 and @jancborchardt - Your issues have helped OrgManager improve lots of things!
- Elio Qoshi - You made the OrgManager branding great!