User Guide

Requirements

• Google Maps API
• Disqus Account
• Python 2.7
• Django 1.5.4
• dj-database-url 0.2.2
• dj-static 0.0.5
• django-form-utils 1.0.1
• django-toolbelt 0.0.1
• gunicorn 18.0
• psycopg2 2.5.1
• python-dateutil 2.2
• python-mimeparse 0.1.4
• six 1.4.1
• sqlparse 0.1.10
• static 0.4
• wsgiref 0.1.2

Installation

1. Ensure that python 2.7 is installed on the web server.

   • Skip this step if python is already installed on the web server.
   • See http://www.python.org/getit for installation instructions.

2. Ensure that pip is installed on the web server.

   • Pip is a python package manager that will help install the requirements for healthyhome.
   • See http://www.pip-installer.org for installation instructions.

3. Upload the healthyhome files to the server using one of the following steps:

   1. FTP
      • Download an archive of the application from https://github.com/CSC301H-Fall2013/healthyhome/archive/master.zip.
      • Upload the archive to server and unzip it.
   2. Git
      • Use URL https://github.com/CSC301H-Fall2013/healthyhome.git

4. Install the packages required by healthyhome.

   • SSH into the server.
   • cd into the healthyhome directory.
   • Run pip install -r requirements.txt to install the requirements.

5. Follow the Deploying Django instructions to setup healthyhome for the current server environment.

Submitting a Complaint

Replace http://www.example.com with the base URL (the URL healthyhome is accessible from) in the instructions below.

1. Report complaints at http://www.example.com/report.
2. Enter in a valid address, city and province.
3. Select at least one problem to complain about.
4. Click submit.
5. Confirm the complaint, or go back to edit the address.

Moderation

Replace http://www.example.com with the base URL (the URL healthyhome is accessible from) in the instructions.

1. Access the admin area of the website at http://www.healthyhome.com/admin
2. Login with default admin account 'healthyhome' and password 'fiber'.
3. Delete a building or complaint.
   • Delete a building by clicking on the 'Building' link, selecting the building, and choosing 'Delete selected buildings' from the Action dropdown.
   • Delete a complaint by clicking on the 'Complaint' link, selecting the complaint, and choosing 'Delete selected complaint' from the Action dropdown.

Using the application

Replace http://www.example.com with the base URL (the URL healthyhome is accessible from) in the instructions.

Refer to the help page at http://www.example.com/help for instructions on using healthyhome.

Disqus

Healthyhome uses Disqus for building page comments. By default, healthyhome is setup to work with the 'healthyhome' Disqus account. To change to a new account follow these steps.

1. Setup a Disqus account using http://disqus.com.
2. Edit the template page templates/complaints/building_page.html, replacing the disqus_shortname variable with shortname associated with the new Disqus account.

To moderate comments, login to the Disqus account from (http://disqus.com).