Advanced Configuration


One of the cool features of Django is the sitemap application, so if you want to fill your Web site’s sitemap with the entries of your blog, follow these steps.

  • Register django.contrib.sitemaps in the INSTALLED_APPS section.

  • Edit your project’s URLs and add this code:

    from zinnia.sitemaps import TagSitemap
    from zinnia.sitemaps import EntrySitemap
    from zinnia.sitemaps import CategorySitemap
    from zinnia.sitemaps import AuthorSitemap
    sitemaps = {'tags': TagSitemap,
                'blog': EntrySitemap,
                'authors': AuthorSitemap,
                'categories': CategorySitemap,}
    urlpatterns += patterns(
        url(r'^sitemap.xml$', 'index',
            {'sitemaps': sitemaps}),
        url(r'^sitemap-(?P<section>.+)\.xml$', 'sitemap',
            {'sitemaps': sitemaps}),)

Akismet Anti-Spam

If you want to benefit of the Akismet spam protection on your comments, it’s possible to do it by installing the akismet Python module, and add this setting:

ZINNIA_SPAM_CHECKER_BACKENDS = ('zinnia.spam_checker.backends.automattic',)


You need an API key. If you don’t have any, get one for free at then set it in your project’s settings like this:


TypePad Anti-Spam

It’s also possible to benefit of the TypePad AntiSpam service to fight the spam. Like the Akismet protection you need to install the akismet Python module.

Then register the TypePad AntiSpam protection with this setting:

ZINNIA_SPAM_CHECKER_BACKENDS = ('zinnia.spam_checker.backends.typepad',)


You need an API key. If you don’t have any, get one for free at then set it in your project’s settings like this:


Mollom Anti-Spam

Another approach to fight the spam is provided by Mollom, Zinnia implement a backend to use this spam filtering service. Before configuring the service, you need to install the PyMollom Python library and then register the Mollom spam checking protection with this setting:

ZINNIA_SPAM_CHECKER_BACKENDS = ('zinnia.spam_checker.backends.mollom',)


You need a private and public keys to use this service. Get a free account at then set your keys in your project’s settings like this:

MOLLOM_PUBLIC_KEY = 'your public key'
MOLLOM_PRIVATE_KEY = 'your private key'

You find useful and want to use it for your blog entries ?

It’s simple, install django-bitly in your project’s settings and add these settings:

BITLY_LOGIN = 'your login'
BITLY_API_KEY = 'your api key'
ZINNIA_URL_SHORTENER_BACKEND = 'zinnia.url_shortener.backends.bitly'

Zinnia will do the rest.


When you post a new entry on your blog you might want to tweet it as well.

In order to do that, you first need to activate the support like described above.

Then install tweepy and add these settings.

TWITTER_CONSUMER_KEY = 'Your Consumer Key'
TWITTER_CONSUMER_SECRET = 'Your Consumer Secret'
TWITTER_ACCESS_KEY = 'Your Access Key'
TWITTER_ACCESS_SECRET = 'Your Access Secret'

Note that the authentification for Twitter has changed since September 2010. The actual authentification system is based on oAuth. That’s why now you need to set these 4 settings. If you don’t know how to get these information, follow this excellent tutorial at:

Now in the admin, you can post an update containing your entry’s title and the shortened URL of your entry.


If you use django-CMS 2.0, Zinnia can be integrated into your pages, thanks to the plugin system.


Changed in version 0.10.1.

zinnia.plugins has been removed in favor of cmsplugin_zinnia.

Simply refer to cmsplugin_zinnia‘s documentation for more information about the install instructions and possibilities.


If you want to replace WYMEditor by TinyMCE install django-tinymce and follow the installation instructions.

TinyMCE can be customized by overriding the admin/zinnia/entry/tinymce_textareas.js template.

Markup languages

If you doesn’t want to write your entries in HTML, because you are an über coder knowing more than 42 programming languages, you have the possibility to use a custom markup language for editing the entries.

Currently MarkDown, Textile and reStructuredText are supported, so if you want to use one of these languages, simply set this variable as appropriate in your project’s settings.

ZINNIA_MARKUP_LANGUAGE = 'restructuredtext'

Note that the name of the language must be in lowercase.

More informations about the dependencies in django.contrib.markup.


Zinnia provides few Webservices via XML-RPC, but before using it, you need to install django-xmlrpc.

Then register django_xmlrpc in your INSTALLED_APPS section of your project’s settings.

Now add these lines in your project’s settings.

from zinnia.xmlrpc import ZINNIA_XMLRPC_METHODS

ZINNIA_XMLRPC_METHODS is a simple list of tuples containing all the Webservices embedded in Zinnia.

If you only want to use the Pingback service import ZINNIA_XMLRPC_PINGBACK, or if you want you just want to enable the MetaWeblog API import ZINNIA_XMLRPC_METAWEBLOG.

You can also use your own mixins.

Finally we need to register the URL of the XML-RPC server. Insert something like this in your project’s

url(r'^xmlrpc/$', 'django_xmlrpc.views.handle_xmlrpc'),


For the Pingback service check if your site is enabled for pingback detection. More information at

Project Versions

Table Of Contents

Previous topic


Next topic

Upgrading Zinnia

This Page