The electionleaflets folder has to be hosted on an Apache HTTP server. A
sample Apache configuration file is supplied in
electionleaflets/config/dev.electionleaflets.org.au.
The includes, includes/PEAR and config folders must be added to the
PHP include_path variable which is set in the example Apache configuration
file or can be set in an Apache .htaccess file
eg. https://groups.google.com/d/topic/openaustralia-dev/fg1dENEjm18/discussion
The timezone must also be set as a PHP variable eg.
php_value date.timezone "America/Chicago" in a .htaccess file.
Requires cURL, php5-imap, php5-gd, php-mbstring
Create a MySQL database and user:
echo "CREATE DATABASE electionleaflets" | mysql --user=root --password
echo "GRANT USAGE ON *.* TO 'electionleaflets'@'localhost' IDENTIFIED BY 'electionleaflets'" | mysql --user=root --password
echo "GRANT ALL PRIVILEGES ON electionleaflets.* TO 'electionleaflets'@'localhost'" | mysql --user=root --password
The create the database schema using the script in schema/electionleaflets.sql
and schema/australian_postcodes.sql
cat schema/electionleaflets.sql | mysql --user=root --password electionleaflets
cat schema/australian_postcodes.sql | mysql --user=root --password electionleaflets
Make a copy of config/general.php.example as config/general.php then edit the variables for you local setup.
You must point it to the MySQL database you just created and set ROOT_DIR,
VHOST_DIR, WWW_SERVER, ADMIN_SERVER, and DOMAIN appropriately.
Run these commands to create the following folders:
mkdir -p data/smarty_compile
mkdir -p data/cache
mkdir -p data/temp
mkdir -p data/images
mkdir -p data/images/small
mkdir -p data/images/original
mkdir -p data/images/large
mkdir -p data/images/medium
mkdir -p data/images/thumbnail
Also ensure they are writable by the webserver.
On a SELinux based distro (Fedora, RHEL, CentOS etc.) you will also have to give these folders the correct security context
chcon -Rv -t httpd_sys_content_t data
To run Election Leaflets you need to collect and upload some data about the election, things like its name and what parties are running candidates.
You'll need to collect the following data before you begin:
- Election name and date
- A list of parties running candidates
- A list of categories important to this election
- A list of constituency names
- Mappings between postcodes and constituency names (e.g.
2042, Sydney)
There is an admin interface available at /admin/ of every Election Leaflets
install. To access it you need to set a username password in the general.php
configuration file. From there it should be pretty self-explanatory.
It's important to note that elections created via this interface are not
immediately visible. In the election table you will need to set the
enabled field to '1' for it to go live - think of this as a final sanity
check.
You have the ability to edit elections. If there are already leaflets uploaded for an election this is probably Not A Good Idea as you can remove parties and categories that may already have data uploaded.
With great power...
If you need any help, contact the OpenAustralia Community list.
The map is actually a separate django application. To get this working you will need the following installed:
python-django
python-mysqldb
libgeos-c1
python-gdal
proj
libapache2-mod-python
python-imaging
cd docs php -d include_path=".:../includes:../includes/PEAR:../config" -d date.timezone="Australia/Sydney" -S localhost:8000