django-blog-zinnia 0.5

Applications

Then register zinnia, and these following applications in the INSTALLED_APPS section of your project’s settings.

>>> INSTALLED_APPS = (
...   # Your favorites apps
...   'django.contrib.contenttypes',
...   'django.contrib.comments',
...   'django.contrib.sites',
...   'django.contrib.admin',
...   'tagging',
...   'zinnia',)

Template Context Processors

Add these following template context processors if not already present.

>>> TEMPLATE_CONTEXT_PROCESSORS = (
...      'django.core.context_processors.auth',
...      'django.core.context_processors.i18n',
...      'django.core.context_processors.request',
...      'django.core.context_processors.media',
...      'zinnia.context_processors.media',
...   )

Media Files

You have to make a symbolic link from zinnia/media/zinnia directory to your media directory or make a copy named zinnia, but if want to change this value, define ZINNIA_MEDIA_URL in the settings.py as appropriate.

And don’t forget to serve this url.

Urls

Add the following lines to your project’s urls.py in order to display the blog.

>>> url(r'^weblog/', include('zinnia.urls')),
>>> url(r'^comments/', include('django.contrib.comments.urls')),

Note that the default zinnia urlset is provided for convenient usage, but you can customize your urls if you want. Here’s how :

>>> url(r'^weblog/feeds/', include('zinnia.urls.feeds')),
>>> url(r'^weblog/authors/', include('zinnia.urls.authors')),
>>> url(r'^weblog/categories/', include('zinnia.urls.categories')),
>>> url(r'^weblog/search/', include('zinnia.urls.search')),
>>> url(r'^weblog/', include('zinnia.urls.entries')),
>>> url(r'^comments/', include('django.contrib.comments.urls')),

Sitemap

One of the cool features of Django is the sitemap application, so if you want to fill your website’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('django.contrib.sitemaps.views',
...                         (r'^sitemap.xml$', 'index',
...                          {'sitemaps': sitemaps}),
...                         (r'^sitemap-(?P<section>.+)\.xml$', 'sitemap',
...                          {'sitemaps': sitemaps}),
...                         )

Akismet

By default the Akismet spam protection is enabled when anyone leaves a comment.

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

>>> AKISMET_API_KEY = 'your key'

If you don’t want spam protection for comments, you can disable it with this setting.

>>> ZINNIA_AKISMET_COMMENT = False

Bit.ly

You find Bit.ly 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 bit.ly login'
>>> BITLY_API_KEY = 'your bit.ly api key'

Zinnia will do the rest.

Twitter

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 Bit.ly support like described above.

Then install python-twitter and add these settings.

>>> TWITTER_USER = 'your twitter username'
>>> TWITTER_PASSWORD = 'your twitter password'

Now in admin, you have the possibilty to post an update containing your entry’s title and the shortened url of your entry.

Django-CMS

If you use django-cms, Zinnia can be integrated into your pages, with the plugins system.

For doing that simply register zinnia.plugins in the INSTALLED_APPS section of your project’s settings.