Welcome to Workshop Manager.
This project was originally build to create a tools and learn Play! framework at the same time... some part of the code are maybe not perfect.
It was also an internal project at that time, so some comments are in French (which will be fixed quickly) but sadly most of the GIT commit comments too, and that can't be fixed...
Finally, the project was hosted in Bitbucket, and during the import of bug trackers some errors occured (because of our french accents ^^), then the ID in Github are (Bitbucket ID + 2) which help to understand some GIT comments
Getting Started
Requirements
- Download Play! framework 2.2.0 and add it to your path environment variable
- Install a MySQL environment (if your not familiar with Play! Framework it will simplify the WorkshopManager configuration)
Installation
- Two quick start options are available:
- Download the latest release
- Clone the repo:
git clone https://github.com/sqlilabs/WorkshopManager.git
.
Configuration
- Edit application.conf:
- CHANGE THE KEY !!!! it's important to change the secret key, you can use that tool for example: CodeIgniter Encryption Keys
application.langs="en,fr"
english and french are available, add yours if needed by translating theconf/messages.en
orconf/messages.fr
- Database configuration: you have to set the db properties
db.default.driver
,db.default.url
,db.default.user
,db.default.password
- Edit the
mail.filter
property. No value means everybody can log in,mail.filter="@sqli.com"
means that only people from the domainsqli
can connect to the application - Edit the default role if necessary:
default.role
roles are [ADMIN, STANDARD] - Change the OpenId properties if you want to use something else than Google:
openID.provider.url
openID.redirect.url
- Create the database schema:
- go to your installation path
- execute the following command: play run
- open a browser at the location:
http://localhost:9000
- follow the Play! Framework instruction
- Users
- At the first login (the only OpenID provider available for now is Google), the user is created in the database if he accept the agreement with the default role: "standard"
- There is a user administration page, but the first admin user must be declare in the database, just replace "standard" by "admin" in the table USER
- Need data ?
database/populate.sql
will inject some fake data in your database to test the system
Online demo
You can find an online demo on Cloudbees.
Authors and Contributors
Yannick Chartois (@ychartois), RĂ©mi Goyard (@mimiz), Christian Alonso Chavez (@cachavezley), Miguel Diez Garcia, Christophe Opoix (@copoix).