Programmes Plant

The Programmes Plant is part of the XCRI-CAP project at the University of Kent, and is a replacement for the existing Programmes Factory.

It is written in Laravel and using Twitter Bootstrap.

Build Status

master

develop

Development Setup

The following are instructions on running the Programmes Plant on a local machine for development.

Method 1

Install this in one line? Why of course! Should work on any sensible Unix like system with Git installed.

curl -s https://raw.github.com/unikent/programmes-plant/setup/setup.sh > temp.sh && sh temp.sh && rm temp.sh

Method 2

Clone this repository. Change into the directory.
Obtain Laravel as a submodule by running git submodule init then git submodule update, unless you have done a recursive clone. Note that this app uses the University of Kent Laravel fork, because this contains important performance enhancements as yet not pulled into the Laravel core. This fork is generally kept up to date with the Laravel master branch, so including it as a submodule should give you the latest version of Laravel. We also use the Verify Laravel bundle as a sub-module but maintain our own fork.
Install Composer and run composer.phar install --dev to install dependencies.
You need to setup the application by editing all the sample files in config/ and moving them to config/local/ filling in as appropriate. To move the files in one command, run:

mkdir application/config/local && cp application/config/*.sample application/config/local && ls application/config/local/*.sample | while read file; do mv $file  `echo $file | sed s/.sample//`; done

You will need to create a MySQL database. Create this database and add the credentials to application/config/local/database.php.
The application requires an authentication driver to be used. The details of this can be setup in application/config/local/auth.php. We use our own LDAP Verify driver. If you decide to use our bundled LDAP Verify driver, the server settings can go in application/config/local/ldap.php.
Run php artisan migrate:install --env=local to setup the migtations table. Then run php artisan migrate --env=local to run all the migrations to setup your database.
Run php artisan setinitialuser <your username> --env=local to setup the hyperadmininistrator (the user with all access on the application - a.k.a The Big Cheese). This user must correspond to a valid LDAP user if you are using LDAP.
Point a web server at the public/ folder. If the domain you have aliased locally is not like 'localhost' or '*.dev' then Laravel will not be able to work out that you are running in the local environment and it will throw an exception on every page. If you want to use something other than these, add your environment to the array at 'local' => on line 25 of ./paths.php at the root of this repository.
Point a browser to the URL of the Programmes Plant!

Seeding the data

We have provided some data seeds to allow you to get going with some sample data, particularly for programme data.

To run all the seeds type php artisan seed --env=local.

Testing

Unit tests are written in PHPUnit. To run the tests run php artisan test. The tests use an in memory SQLite database to make them significantly faster.

Other Projects

Want to consume the data from a Programmes Plant API? Consider using our PHP library for this.

Want to see what a front-end to this data might look like using this library? See Of Course.

Licensing

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

msf4-unikent / programmes-plant Goto Github PK