Django project for QGIS related activities such as plugin repository
CSS Python HTML JavaScript XSLT Makefile Shell
Failed to load latest commit information.
scripts Adding future versions also Nov 5, 2016
.gitmodules Removed Pootle as a submodule and included in master. May 31, 2012
Makefile Proxy "check" rule from the top-level Makefile Nov 12, 2011
REQUIREMENTS.txt Added user map Jun 7, 2016 Added create script and tweaked setup notes Nov 17, 2010
readme.rst Update readme.rst Jul 19, 2016 Set executable flag Jul 22, 2016



This directory contains the source code for django apps used in the QGIS project.

For licensing information, please read COPYING file included in this directory.

For setup and installation notes, please read INSTALL included in this directory.

To contribute to this project, please contact Tim Sutton -

Tim Sutton

November 2010

QGIS Django Project This document describes the procedure for setting up the QGIS Django Project. Tim Sutton 2010


For the terminally lazy

For a readonly checkout do:

sudo apt-get install libldap2-dev libsasl2-dev python-gdal libxml2-dev \
git clone
cd qgis-django
sudo easy_install virtualenv
virtualenv venv
source vebv/bin/activate
pip install -r REQUIREMENTS.txt


Important note: the server currently use python 2.5, due to some strange incompatibilities between compressed egg format and Django init machinery, in order to recognise "haystack" search stuff, the cab EGG must be uncompressed such as the final directories (in the virtualenv) are:


Install PostGIS:

sudo apt-get install postgresql-8.4-postgis

Copy the settings template:

cd qgis

Then run the createdb script:



If you already have postgis installed in your template1 db, just do the following command rather than running the createdb script:

createdb qgis-trunk


Remember to source the activate script to enabled the python virtual environment:

source venv/bin/activate

Modify to include the correct username and pwd for the db connection and then sync the database:

cd qgis-app
python syncdb

Then run the project using the embedded test server:

python runserver

Then point your browser at:


Deploying a live site using wsgi

We need to configure Apache for having wsgi support:

cd /etc/apache/sites-available
sudo cp <path to qgis-django>/apache/apache.virtenv.conf.example

Now modify qgis-django.conf to your needs (making sure paths and web url are correct) then:

sudo a2ensite qgis-django.conf
sudo /etc/init.d/apache2 reload

Updating the search indexes

The haystack search indexes should be created after initial install:

python create_index

There after they should be updated regularly e.g. using a 5 min cron job:

python update_index

Cache setup

We will use database based caching here (see django (caching) <>.

Make sure your virtual env is set up and then create a cache table:

python createcachetable cache_table


The cache backend is required for the planet / feedjack to work properly

Feedjack Update

The Blog Planet requires to run at regular intervals to keep the site fresh. The shell script sets up the environment and runs

The script requires you to set SITE_DIR to point at the Django site directory prior to first use.

The script must be run by a user that has permissions to the site directory.

To install as a cron, use the following (adjust the paths for your site):

*/15 * * * * cd /home/plugins/QGIS-Django;./ \
1>>/tmp/planet_update.log 2>>/tmp/planet_update.err

Planned applications

  • plugins - a django app for managing the QGIS python plugin repository
  • users - a django app for creating a community map and some demographics
  • snippets - a django app for users to share python and c++ snippets showing howi to program QGIS
  • styles - a django app for users to publish the QGIS styles they have created
  • symbols - a django app for users to publish symbols (svg/png etc) they have created
  • planet - a blog aggregator for people blogging with QGIS related stuff
  • gallery - a gallery of maps made with QGIS
  • web links - a list of sites, articles etc. that feature QGIS prominantly
  • pootle - a django project for managing localization of QGI documentation