shiftcal

This is the source code for the Shift calendar.

It has been sanitized of passwords from the copy running at http://shift2bikes.org/cal , but if you'd like to see it in action that's where to check it out.

Basic Architecture

The front-end uses jQuery, Mustache templates, and Bootstrap.

The back-end uses Flourish php and MySQL.

How to setup & run locally

Anyone who wants to run the site locally will need the following to start with:

PHP version < 5.7 and >= 5.4. You can find this by running "php -i" or making a webpage that calls phpinfo();
mysql installed and running and accessible from your dev environment
The 'mysql' module enabled for PHP (there is a line that is uncommented in the correct php.ini to the effect of 'extension=mysql.so'). This module has been deprecated in 5.5 and 5.6 but still works. IT WILL NOT WORK IN PHP 5.7!
enabled the apache module for PHP

Once you've gotten all that sorted, you should be able to create a page with just the code:

<?php phpinfo(); ?>

and have the output contain a page that shows the correct version of php (at the top of the output) and that the mysql.so extension is enabled (there is a section titled 'mysql')

Now that your environment is ready, let's get the source code installed and setup:

checkout the source code and stick it in your document root, in a directory called shiftcal: git clone "https://github.com/ShiftGithub/shiftcal.git"
adjust the database settings in include/account.php to reference your own DB setup: DBHOST, DBUSER, DBPASSWORD, DBDATABASE.
untar the file includes.tgz from your source code. Place it in your document root (shiftcal/../include)
run mysql < init.sql to create an empty database

For additional explanation, expansion, and clarification of these instructions for those using XAMPP and/or OSX, see https://github.com/ShiftGithub/shiftcal/wiki/in-depth-setup-instructions

To do list

You can see our plans for improvements here

How to make improvements to integration with Facebook

The Facebook app ID is 135930960098034.

How to propose changes

Please fork the master branch of the ShiftGithub/shiftcal code into a branch in your own account, commit your changes to that branch, make a pull request against the master branch of ShiftGithub/shiftcal, and we'll try to merge it!

bvanderveen / shiftcal