An application to quickly collect commute mode information from participants.
Features:
- Survey form for commute data like startpoint, endpoint and modes
- Leaderboard page overviews participating companies
- QRcode sent by email to receive "goodies" from to sponsors and partners
The project was originally developed at MAPC by Mariana Arcaya, Tim Reardon and Christian Spanring for the Green Streets Initiative. Since 2013 a group of volunteers is maintaining the code base and deployment.
Past and present volunteer developers include:
The project is using PostgreSQL/PostGIS as database to store commute
locations. Install PostGIS according to the instructions for your operating
system - on Mac OS X I like to use Homebrew, using brew install postgres
and brew install postgis
.
The project is built using Django, a python based web framework. Install Python according to the instructions for your operating system.
Project dependencies are handled with pip. Install pip according to the instructions for your operating system.
It is recommended to use a virtual environments for Django projects. Install virtualenvwrapper according to the instructions for your operating system.
Once the main dependencies are installed, you can clone the project, ...
$ git clone https://github.com/greenstreetsinitiative/checkin.git checkin
$ cd checkin
setup a virtual environment ...
$ mkvirtualenv greenstreets
$ workon greenstreets
and then install the required python (Django) modules:
$ pip install -r requirements.txt
You'll need to make a database. Get your postgres server running and then:
$ createuser someusername
$ createdb -O someusername somedatabasename
$ psql -d somedatabasename -c "ALTER USER someusername WITH PASSWORD 'somepassword';"
$ psql -d somedatabasename -c "CREATE EXTENSION postgis;"
Using the database name, username and password you just used, you'll need to set a few environment variables in your virtual environment postactivate
, which you can find in VIRTUAL_ENV_HOME/greenstreets/bin/
. Just paste them in:
export SECRET_KEY="abcdef"
export DB_NAME="somedatabasename"
export DB_USER="someusername"
export DB_PASSWORD="somepassword"
export DB_PORT="5432"
export DB_HOST="localhost"
Now you're set up!
Then you can let Django setup your database ...
$ python manage.py syncdb
And you can import data if desired:
$ python manage.py loaddata THE_FIXTURE_FILE.json
To run the development server:
$ python manage.py runserver
You should now see the project at http://localhost:8000.
Copyright 2014 Green Streets Initiative