Skip to main content

Integrate Diazo in Django using WSGI middleware and add/change themes using the Django Admin interface.

Project description

Integrate Diazo in Django using WSGI middleware and add/change themes using the Django Admin interface.

The code is maintained on GitHub (


Install the package:

pip install django-diazo

Add the app to your project:


Add middleware (or WSGI, see below):

    'django_diazo.middleware.DjangoCmsDiazoMiddleware',  # Toolbar on/off switch, if you use Django CMS 3

If you want to know if Django-Diazo is turned on in your templates add:


The variable DIAZO_ENABLED is now available in your templates.

!! IMPORTANT !! Note that when using the Django middleware instrumentation the Diazo <notheme /> rules won’t work. You have to provide regular expression patterns in Theme.pattern to prevent some pages (by url) to be themed. When you want to disable theming for certain pages by content based rules for <notheme />, you need to use the WSGI middleware instead.

If you rather use WSGI than Django middleware or you have to (at the moment) since you use exotic <notheme /> rules, add the following lines to your file:

# Apply WSGI middleware here.
from django_diazo.wsgi import DiazoMiddlewareWrapper
application = DiazoMiddlewareWrapper(application)

Database (South migrations)

Migrate the database:

python migrate django_diazo

Create a built-in theme

You might want to supply your Django application with an out-of-the-box theme, probably also managed in a VCS.

Create a new app with a file in its root. The contents of this file is should be something like this:

from django_diazo.theme import DiazoTheme, registry

class SomeTheme(DiazoTheme):
    name = 'Some Theme'
    slug = 'some_theme'
    pattern = '^(?!.*admin)'  # Theme everything but /admin

Don’t forget to put your assets in the static folder, like an index.html and a rules.xml. You can find a rules.xml example in django_diazo/examples.

To synchronize the built-in themes with the database/application run the following command:

python syncthemes

Upload themes

By default, the .zip files that are uploaded are extracted in the media folder. You might want to serve these files via Django. Add the following to your

urlpatterns += patterns('',
    url(r'^media/(?P<path>.*)$', 'django.views.static.serve', {'document_root': settings.MEDIA_ROOT}),

For production environments it is not recommended to serve files from the media folder. This implementation only servers files in the themes folder within the media folder but it would be better to serve these files using a web server and not via Django. The same holds for your static folder.

Example themes / application

Take a look at and for examples of built-in themes and an integration example.

Our blog post also covers these examples and some more background.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (343.7 kB) Copy SHA256 hash SHA256 Source None May 20, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page