Homestead

On-campus Housing Management

Homestead is a web-application for managing on-campus student housing.

Development Setup

• Install phpwebsite using postgresql
• Clone this repo into the phpwebsite/mod into an hms directory: git clone git@github.com:AppStateESS/homestead.git hms
• Install the HMS module from the phpwebsite control panel
• Copy mod/hms/inc/hms_defines.php and mod/hms/inc/SOAPDataOverride.php to phpwebsite/inc/
• In the phpwebsite/inc/hms_defines.php file you just copied, change the following values to true:
• HMS_DEBUG (causes uncaught exceptions to be echoed to the browser, instead of caught, logged, and emailed)
• SOAP_INFO_TEST_FLAG (forces use of hard-coded student info in TestSOAP.php)
• EMAIL_TEST_FLAG (causes emails to be logged to phpwebsite/log/email.log)
• Install Composer
• Install dependencies with Composer -- from inside the hms directory: ./composer.phar install
• Install Node.js (includes npm) (Something like sudo yum install npm should work)
• Bower
• Use npm to install Bower: sudo npm install -g bower
• Use Bower to install dependencies -- from inside the hms directory: bower install
• Setup the Postgresql Fuzzy String Matching Extensions:
• sudo yum install postgresql-contrib
• From the psql command line on the Homestead database: create extension FUZZYSTRMATCH;