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.

The landing page index.php is very minimal - it loads site config from include/common.php and then loads the MAINPAGE. By default currently, MAINPAGE = view3week.php.

view3week.php provides a 3-week calendar view with all 3 weeks of the event data listed at the bottom. links from the calendar to event data are included and navigable without talking to the server, after the page loads. It has links to a simple search form (viewsearch.php) and a full-month view (viewmonth.php), and allows you to move between months.

to add an event, you start at 'calform.php' to fill out one of three versions of the event info page. it submits to calsubmit.php and uses the verification code in vfyaddress.php and vfyvenue.php (these being broken is non-fatal), but vfydates.php is needed as it parses and accepts date specifications like "first thursdays" or "first of every month except december".

pedalpalooza event viewing and editing has a fair # of files associated with it, which makes sense, since pedalpalooza usage is more than the rest of the year combined. The most-used files are ppcurrent.php which redirects to whatever year of pedalpalooza is specified as current in include/common.php - eg viewpp2015.php. The other functionality in the PP stuff: a counter for # of events which is embedded in the PP overview page, a calendar exporter, helpers to view single days/events, and make a personalized calendar.

See the doc/notes/code_manifest.txt file for more info about each php file in the project

Minimally you'll need to do the following:

• be running PHP <5.7 >=5.4
• enable PHP and the mysql module (deprecated in PHP 5.5 but still works)
• checkout the source code and stick it in your document root, in a directory called shiftcal
• adjust the database settings in include/accout.php
• untar includes.tgz in your document root (shiftcal/../include)
• run mysql < init.sql to create an empty database
• profit! (aka load http://localhost/shiftcal)

• Install php

  • brew tap homebrew/dupes
  • brew tap homebrew/homebrew-php
  • brew install php56

• enable php and mysql

  • sudo apachectl start
  • Open http://localhost/ in a browser. If page doesn't say "It works!", see below
  • cd /library/webserver/documents
  • In text editor, make sure index.php says: <?php phpinfo(); ?> and in /etc/apache2/httpd.conf, this line is not commented out: LoadModule php5_module libexec/apache2/libphp5.so
  • sudo apachectl restart

• Clone source code

  • git clone https://github.com/ShiftGithub/shiftcal.git

• Install and adjust MySQL database

  • Download and install mysql-5.6.26-osx10.9-x86_64.tar.gz
  • In Mac System Preferences, create an instance of MySQL server by double clicking on icon
  • sudo mkdir /var/mysql
  • sudo ln -s /tmp/mysql.sock /var/mysql

• Untar includes.tgz

  • cd /library/webserver/documents
  • sudo tar xzf shiftcal/includes.tgz

• Create an empty MySQL database

  • /usr/local/mysql/bin/mysql -uroot < init.sql

Please fork the code, make a pull request, and we'll try to merge it!