The Open Event Orga Server enables organizers to manage events from concerts to conferences and meet-ups. It offers features for events with several tracks and venues. Event managers can create invitation forms for speakers and build schedules in a drag and drop interface. The event information is stored in a database. The system provides API endpoints to fetch the data, and to modify and update it. Organizers can import and export event data in a standard compressed file format that includes the event data in JSON and binary media files like images and audio.
Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/open-event
Our chat channel is on Gitter here: gitter.im/fossasia/open-event-orga-server
A demo version is automatically deployed from our repositories:
- Deployment from the master branch - open-event.herokuapp.com
- Deployment from the development branch - open-event-dev.herokuapp.com
The Open Event Orga Server can be easily deployed on a variety of platforms. Detailed platform specific installation instructions have been provided below.
- Generic Installation Instructions
- Local Installation
- Vagrant Installation
- Deployment on Google Compute Engine
- Deployment on Google Container Engine (Kubernetes)
- Deployment on AWS EC2
- Deployment on Digital Ocean
- Deployment with Docker
- Deployment on Heroku
One-click Heroku deployment is also available:
Please get familiar with the components of the project in order to be able to contribute.
- Database - PostgreSQL
- Web framework - Flask
- App server - uWSGI
- Web Server - NGINX
OAuth is used to get information from Facebook and Google accounts, that enables users to sign in with their respective credentials:
- Google - https://accounts.google.com/o/oauth2/auth
- Facebook - https://graph.facebook.com/oauth
Twitter feed integration is provided in the public event pages.
Required keys can be obtained from https://dev.twitter.com/overview/documentation
It is possible to extend the functionality and offer images from Instagram in the event service.
Required keys can be obtained from https://www.instagram.com/developer/authentication/.
Google maps is used to get information about location (info about country, city, latitude and longitude).
Required keys can be obtained from https://maps.googleapis.com/maps/api.
Media (like audio, avatars and logos) can be stored either Locally or on Amazon S3 or on Google Storage.
The server can send emails via SMTP or using the sendgrid API.
- SMTP can be configured directly at
admin/settings - Obtaining Sendgrid API Token.
If the application is deployed on Heroku, we use the heroku API to obtain the latest release and also to display the heroku.
Required token can be obtained from https://devcenter.heroku.com/articles/authentication.
For ticket sales the service integrates payment gateways:
- Stripe - Obtaining Keys.
- Paypal - Obtaining Credentials.
The Open Event Orga Server exposes a well documented REST API that can be used by external services (like the Open Event App generators for example) to access the data.
API Documentation:
- Every installation of the project includes the API docs with Swagger, (e.g. here on the test install http://open-event-dev.herokuapp.com/api/v2).
- A hosted version of the API docs is available in the
gh-pagesbranch of the repository at https://fossasia.github.io/open-event-orga-server/api/v2/. - The data of events is provided over API endpoints as described here.
Import:
Open Event Orga server supports multiple formats as a valid source for import.
- A zip archive with JSON (matching the API structure) and binary media files. Read more about this here.
- The Pentabarf XML format is also supported as a valid import source. (Sample file).
Export:
The event data and the sessions can be exported in various formats.
- A zip archive with JSON (matching the API structure) and binary media files. Read more about this here.
- The Pentabarf XML format. (Sample file).
- The iCal format. (Sample file).
- The xCal format. (Sample file).
The system has two kind of role type.
- System roles are related to the Open Event organization and operator of the application.
- Event Roles are related to the users of the system with their different permissions.
Read more here.
To enable development mode (development Flask config), set APP_CONFIG environment variable to "config.DevelopmentConfig".
export APP_CONFIG=config.DevelopmentConfig
When writing changes to models. Use migrations.
# To generate a migration after doing a model update
python manage.py db migrate
# To sync Database
python manage.py db upgrade
# To rollback
python manage.py db downgrade
When checking in code for models, please update migrations as well.
Clone the repo and set up the server according to the steps listed. Make sure you have installed are the dependencies required for testing by running
pip install -r requirements/tests.txt
- Go to the project directory and run the following command:
python -m unittest discover tests/unittests/
-
It will run each test one by one.
-
You can also use the following command to run tests using nosetests :
nosetests tests/unittests/
- Make sure you have FireFox installed
- Start your local flask server instance.
- Go to the project directory and Run the tests by using the following command.
robot -v SERVER:{server_name} -v SUPERUSER_USERNAME:{super_user_email_here} -v SUPERUSER_PASSWORD:{super_user_password} tests/robot
Change all the parameters inside {} as per your local server. The final command would look like:
robot -v SERVER:localhost:5000 -v SUPERUSER_USERNAME:[email protected] -v SUPERUSER_PASSWORD:test_password tests/robot
- Once the tests are completed, a report and a log would be generated at
report.htmlandlog.htmlrespectively in your root directory.
Certain information is being logged and stored in the database for future reference, resolving conflicts in case of hacks and for maintaining an overview of the system. Read more about logging here.
Open Event is being translated using Weblate, a web tool designed to ease translating for both developers and translators.
If you would like to contribute to translation of Open Event, you need to register on this server.
Once you have activated your account just proceed to the translation section.
This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. Please report issues here https://github.com/fossasia/open-event-orga-server/issues
We have the following branches
- development All development goes on in this branch. If you're making a contribution, you are supposed to make a pull request to development. PRs to master must pass a build check and a unit-test check on Travis
- master This contains shipped code. After significant features/bug-fixes are accumulated on development, we make a version update, and make a release.
This project is currently licensed under the GNU General Public License v3. A copy of LICENSE.md should be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.