Skip to content

openplans/planbox

Folders and files

NameName
Last commit message
Last commit date
Jan 14, 2015
Jan 10, 2014
Sep 11, 2014
Jan 10, 2014
Jan 10, 2014
Jan 16, 2015
Oct 24, 2014
Sep 29, 2014
Jan 9, 2014
Jan 12, 2015
Jan 9, 2014
Jan 23, 2014
Dec 17, 2014
Nov 11, 2014
Nov 14, 2014
Apr 27, 2014
Aug 20, 2014
Jan 12, 2015

Repository files navigation

Planbox

Build Status Requirements Status

Planbox is a platform for getting the word out about your planning projects. Its beautiful and easy to use interface will help you get your project online in no time.

Features

  • Create project
  • Quickly and easily edit details
  • Timeline of progress

Requirements

Describe the technology stack and any dependencies.

Local Setup

Clone this repo

git clone git@github.com:openplans/planbox.git

Install dependencies

 cd planbox
 virtualenv env
 source env/bin/activate
 pip install -r requirements.txt
 bower install
 cp src/planbox/local_settings.py.template src/planbox/local_settings.py

Start your local server

 src/manage.py runserver

Configure your S3 bucket

This is used for uploading images and attachments. Add a CORS Configuration that roughly matches this:

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
        <AllowedOrigin>http://localhost:8000</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedMethod>POST</AllowedMethod>
        <AllowedMethod>DELETE</AllowedMethod>
        <MaxAgeSeconds>3000</MaxAgeSeconds>
        <AllowedHeader>*</AllowedHeader>
    </CORSRule>
</CORSConfiguration>

Note that you will have to add an AllowedOrigin element for each domain your application will run on. You can use wildcard asterisks (*) in the origin if you wish, but it will mean that anyone can write to your bucket.

Deploy to Heroku

Create the app

  1. Create a Heroku app for your Hatch git repo heroku apps:create my-app-name
  2. Make sure you add the following Heroku Add-ons
  • Postgresql
  • Rediscloud (or your favorite Redis add-on)
  • Heroku Scheduler

Next thing

TBD

Supported Browsers

Desktop

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Internet Explorer (8-10)

Mobile

  • IOS Safari 6+
  • Android Browser 4+
  • Chrome

Google Analytics configuration

Planbox stores the request domain information using two additional variables (dimensions):

  • Dimension 1 : Domain
  • Dimension 2 : Root Path

Refer to the Google Analytics documentation on setting up custom dimensions to configure your account appropriately.

Copyright

Copyright (c) 2014 OpenPlans