Find out and have your say about development applications in your area.

This is the code for the web application side of things written using Ruby on Rails. The original code from PlanningAlerts.com, which this app is based on, was written using PHP.

If you're interested in contributing a scraper it might be best do that on ScraperWiki or by adding it to our planningalerts-parsers repository. Give us a shout on the mailing list and we'll point you in the right direction.

PlanningAlerts is brought to you by the OpenAustralia Foundation. It was adapted for Australia by Matthew Landauer and Katherine Szuminska, and is based on the UK site PlanningAlerts.com, built by Richard Pope, Mikel Maron, Sam Smith, Duncan Parkes, Tom Hughes and Andy Armstrong.

Install Dependencies

• Install MySql - On OSX download dmg from http://dev.mysql.com/downloads/
• Install Sphinx - brew install sphinx

Checkout The Project

• Fork the project on Github
• Checkout the project

Install Ruby Dependencies

• Install bundler - gem install bundler
• Install dependencies - bundle install

Setup The Database

• Create your own database config file - cp config/database.yml.example config/database.yml
• Update the config/database.yml with your root mysql credentials
• If you are on OSX change the socket to /tmp/mysql.sock
• Create the databases - rake db:create
• Load the database schema - rake db:schema:load

Run The Tests

• Run the test suite - rake

Step 1 - Seed authorities table

• Change INTERNAL_SCRAPERS_INDEX_URL in app/models/configuration.rb to point to : http://www.planningalerts.org.au/scrapers/
• Load the authorities - rake planningalerts:authorities:load

Step 2 - Scrape DAs

• Run - rake planningalerts:applications:scrape['marrickville']

Step 3 - Setup an Alert

• Start the rails server - rails s
• Start MailCatcher - mailcatcher
• Hit the home page - http://localhost:3000
• Enter an address e.g. 638 King St, Newtown NSW 2042
• Click the "Email me" link and setup an alert
• Open MailCatcher and click the confirm link: http://localhost:1080/

Step 4 - Send email alerts

• Run - rake planningalerts:applications:email
• Check the email in your browser: http://localhost:1080/
• To resend alerts during testing, just set the last_sent attribute of your alert to nil

• Fork the project on GitHub.
• Make a topic branch from the master branch.
• Make your changes and write tests.
• Commit the changes without making changes to any files that aren't related to your enhancement or fix.
• Send a pull request against the master branch.

Our awesome contributors can be found on the PlanningAlerts site.

GPLv2, see the LICENSE file for full details.