Awesome Open Source
Awesome Open Source


Build Status

A Volunteer Management Software for Jacksonville Refugee services

##Installation JRCS Can be easily installed on a local environment. Simply open up a command line utility navigate to the directory where you want JRCS installed and type git clone

This will clone the JRCS repository onto your local computer.

Next Navigate to the root directory of JRCS in your command line utility e.g. cd laravel-jrcs

Run php artisan serve this will launch the JRCS application on Php's built it webserver using artisan. You can view the application at http://localhost:8000/

##Configuring the Database Contact @cbartram if you have any issues with the database or want to setup a local copy instead. By default JRCS will connect to the database set up in the development environment on Heroku, however, this may not be ideal for testing application components which require inserting or updating large quantities of data in the database.

##Common Issues Ensure that you install composer (dependency manager) for php correctly from

Run this in a command prompt or terminal php -r "copy('', 'composer-setup.php');" php composer-setup.php php -r "unlink('composer-setup.php');"

The basic script above:

  • Downloads the installer to the current directory
  • Verifies the installer SHA-384 Hash
  • Runs the installer
  • Removes the installer

(If it gives you an error run the commands as sudo)

Now that you have composer installed run php composer-setup.php --filename=composer

On Mac you can simply do sudo mv composer.phar /usr/local/bin/composer to move composer to your classpath. Access composer in terminal using the cmd composer from wherever you are!

On Windows follow this tutorial

Navigate to your root directory for JRCS and run composer update after composer has been updated run php artisan serve to access your local webserver at http://localhost:8000/

If your still recieving errors try following the composer installation guide from the beginning on their website at

##Version Log ###Version 1.0.0

  • initial commit
  • created user php class
  • added local database connection

###Version 1.0.1

  • added jquery and js to asych login users
  • added php file to log in users based on which button they clicked
  • added staff abiliity to log into all 3 volunteer sites

###Version 1.0.2

  • Cleaned up volunteer_profile UI
  • added additional methods to query db
  • cleaned up db design
  • added code documentation for User.Class.php

###Version 1.0.3

  • Added Travis.yml file for CI
  • Added Heroku PHP App for deployable dev environment
  • Added Seamless transitioning between volunteer groups
  • App only shows groups that are available to the user

###Version 1.0.4

  • Added Admin Login for a high level overview
  • Added Slim Micro framework to map php callback functions to HTTP Requests for Restful API
  • Bug fixes
  • Changed Directory structure to accomodate autoload.php and Composer.json

###Version 1.0.5

  • Added DB_migrations SQL
  • Added Slim framework compatibility for Routing URI's to specific HTTP req's
  • Fixed Bug with Card titles showing volunteers group
  • Wrote JS API to query backend and reuturn JSON Objects

###Version 2.0.0

  • JRCS 2.0 is here!!!
  • New and more stable Frontend js api
  • Eloquent query building api
  • correct composer.json so project dependencies can be managed added and deleted like a breeze!
  • Fully correct MVC Design structure
  • Blade templating engine added
  • Laravel framework and support built right in!
  • Simplified database design
  • Increased security
  • SQL Injection protection
  • CRSF Tokenization
  • Sitewide encryption
  • XSS & JS Protection Protection
  • So so so much more!

###Version 2.0.1

  • Added Password Reset functionality
  • Added ability for staff to add new volunteers to their respective groups
  • Fixed several bugs and security issues
  • Added account settings panel which gives staff several ways to manage their account

###Version 2.1.0

  • Added Redis functionality
  • Rewrote UI across the entire site
  • Show/Hide for all panels
  • New and easy to use navbar
  • Added Additional Account Settings
  • Highcharts integration
  • FullCalendar integration
  • Persistant storage for account settings instead of using sessions
  • Event, Calendar, and event logging functionality added
  • Donation, donation approva/denial functionality added
  • More expressive definitions between staff and admin
  • Volunteer Drag and Drop to switch and copy volunteers between group
  • Volunteer drag and drop to delete volunteers

###Version 2.1.1

  • Multiple Bug fixes
  • Much more verbose JS API
    • includes functions to: interact with events (CRUD), authenticate user emails and passwords, check-in and check-out volunteers, and open, close, approve, and deny donations
  • Functions to interact with volunteer events, donations, data and more
  • Account settings update to include showing drag and drop for all groups
  • bulk checkout feature for staff members
  • ability to delete/re-open a previously approved donation
  • dynamic programs and events (ability to remove events from the calendar, and add and delete programs)
  • More controls for the calendar on the profile page
  • client requested changes (2 password reset fields, nationality, switching login and cico pages etc...)
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Php (285,849
Html (241,166
Laravel (40,826
Git (34,477
Mysql (31,046
Bootstrap (27,680
Jquery (26,475
Redis (23,836
Version (20,788
Group (19,777
Sass (14,599
Mvc (10,146
Installer (6,747