List of settings

Zinnia has a lot of parameters to configure the application accordingly to your needs. Knowing this list of settings can save you a lot of time.

Here’s a full list of all available settings, and their default values.

All settings described here can be found in zinnia/settings.py.

Entry

ZINNIA_ENTRY_BASE_MODEL

Default value: 'zinnia.models_bases.entry.AbstractEntry' (Empty string)

String defining the base model path for the Entry model. See Extending Entry model for more informations.

ZINNIA_ENTRY_DETAIL_TEMPLATES

Default value: [] (Empty list)

List of tuple for extending the list of templates availables for rendering the entry detail view. By using this setting, you can change the look and feel of an entry page directly in the admin interface. Example:

ZINNIA_ENTRY_DETAIL_TEMPLATES = [('entry_detail_alternate.html',
                                  gettext('Alternative template')),]

ZINNIA_ENTRY_CONTENT_TEMPLATES

Default value: [] (Empty list)

List of tuple for extending the list of templates availables for rendering the content of an entry. By using this setting, you can change the look and feel of an entry directly in the admin interface. Example:

ZINNIA_ENTRY_CONTENT_TEMPLATES = [('zinnia/_entry_detail_alternate.html',
                                   gettext('Alternative template')),]

ZINNIA_ENTRY_LOOP_TEMPLATES

Default value: {'default': {}}

Dictionary of dictionaries of indexes for by-passing the template used when rendering an entry within a loop of filtered entries. By using this setting, you can change with Python code, the look and feel of an entry within a specific loop. Example:

ZINNIA_ENTRY_LOOP_TEMPLATES = {
    'default': {1: 'zinnia/_entry_detail_first.html'},
    'author-admin': dict([(i, 'zinnia/_entry_detail_admin.html')
                          for i in range(1000) if not i % 5])
}

ZINNIA_UPLOAD_TO

Default value: 'uploads/zinnia'

String setting that tells Zinnia where to upload entries’ images.

Changed in version 0.10.

Previously the default value was 'uploads'.

Edition

ZINNIA_MARKUP_LANGUAGE

Default value: 'html'

String determining the markup language used for writing the entries. You can use one of these values:

['html', 'markdown', 'restructuredtext', 'textile']

ZINNIA_MARKDOWN_EXTENSIONS

Default value: [] (Empty list)

List of either markdown.Extension instances or extension paths, used for rendering the entries in MarkDown. Example:

ZINNIA_MARKDOWN_EXTENSIONS =  ['markdown.extensions.nl2br',
                               MyExtension(mysetting="foo")]

ZINNIA_RESTRUCTUREDTEXT_SETTINGS

Default value: {} (Empty dict)

A dictionary containing settings for the RestructuredText markup processing. See the Docutils restructuredtext writer settings docs for details.

Preview

ZINNIA_PREVIEW_SPLITTERS

Default value: ['<!-- more -->', '<!--more-->'])

List of split markers used to make a preview of the entry’s content if present in the HTML. All the content before the marker will be used to build the preview of the entry.

ZINNIA_PREVIEW_MAX_WORDS

Default value: 55

Number of words used to build the entry’s preview if no split markers are found.

ZINNIA_PREVIEW_MORE_STRING

Default value: ' ...'

The string to be appended to the content when a truncation for the preview is done.

Views

ZINNIA_PAGINATION

Default value: 10

Integer used to paginate the entries. So by default you will have 10 entries displayed per page on the Weblog.

ZINNIA_ALLOW_EMPTY

Default value: True

Used for archives views, raise a 404 error if no entries are present at a specified date.

ZINNIA_ALLOW_FUTURE

Default value: True

Used for allowing archives views in the future.

Feeds

ZINNIA_FEEDS_FORMAT

Default value: 'rss'

String determining the format of the syndication feeds. You can use 'atom' if your prefer Atom feeds.

ZINNIA_FEEDS_MAX_ITEMS

Default value: 15

Integer used to define the maximum items provided in the syndication feeds. So by default you will have 15 entries displayed on the feeds.

URLs

ZINNIA_TRANSLATED_URLS

New in version 0.12.2.

Default value: False

Boolean used to activate the internationalization of the URLs provided by Zinnia if the translation is avaialable in your language.

ZINNIA_URL_SHORTENER_BACKEND

Default value: 'zinnia.url_shortener.backends.default'

String representing the module path to the URL shortener backend.

ZINNIA_PROTOCOL

Default value: 'http'

String representing the protocol of the site. If your Web site uses HTTPS, set this setting to https.

Comments

ZINNIA_AUTO_MODERATE_COMMENTS

Default value: False

Determine if a new comment should be marked non-public and await approval. Leave as False to allow comments to show up immediately.

ZINNIA_AUTO_CLOSE_COMMENTS_AFTER

Default value: None (forever)

Determine the number of days where comments are open. If you set this setting to 10 the comments will be closed automaticaly 10 days after the publication date of your entries.

0 means disabling comments completely.

ZINNIA_MAIL_COMMENT_REPLY

Default value: False

Boolean used for sending an email to comment’s authors when a new comment is posted.

ZINNIA_MAIL_COMMENT_AUTHORS

Default value: True

Boolean used for sending an email to entry authors when a new comment is posted.

ZINNIA_MAIL_COMMENT_NOTIFICATION_RECIPIENTS

Default value:

[manager_tuple[1] for manager_tuple in settings.MANAGERS]

List of emails used for sending a notification when a new public comment has been posted.

ZINNIA_SPAM_CHECKER_BACKENDS

Default value: [] (Empty list)

List of strings representing the module path to a spam checker backend. See Spam Checker for more informations about this setting.

ZINNIA_COMMENT_MIN_WORDS

Default value: 4

Minimal number of words required to post a comment if zinnia.spam_checker.backends.long_enough.backend() is enabled in ZINNIA_SPAM_CHECKER_BACKENDS.

ZINNIA_COMMENT_FLAG_USER_ID

Default value: 1

The ID of the User to be used when flagging the comments as spam, pingback or trackback.

Linkbacks

ZINNIA_AUTO_CLOSE_PINGBACKS_AFTER

Default value: None (forever)

Determine the number of days where pingbacks are open. If you set this setting to 10 the pingbacks will be closed automaticaly 10 days after the publication date of your entries.

0 means disabling pingbacks completely.

ZINNIA_AUTO_CLOSE_TRACKBACKS_AFTER

Default value: None (forever)

Determine the number of days where trackbacks are open. If you set this setting to 10 the trackbacks will be closed automaticaly 10 days after the publication date of your entries.

0 means disabling trackbacks completely.

Pinging

ZINNIA_PING_DIRECTORIES

Default value: ('http://django-blog-zinnia.com/xmlrpc/',)

List of the directories you want to ping.

ZINNIA_PING_EXTERNAL_URLS

Default value: True

Boolean setting for telling if you want to ping external URLs when saving an entry.

ZINNIA_SAVE_PING_DIRECTORIES

Default value: bool(ZINNIA_PING_DIRECTORIES)

Boolean setting for telling if you want to ping directories when saving an entry.

ZINNIA_PINGBACK_CONTENT_LENGTH

Default value: 300

Size of the excerpt generated on pingback.

Miscellaneous

ZINNIA_COMPARISON_FIELDS

Default value: ['title', 'lead', 'content', 'excerpt', 'image_caption', 'tags']

List of text fields used to find similarity between entries.

ZINNIA_SEARCH_FIELDS

Default value: ['title', 'lead', 'content', 'excerpt', 'image_caption', 'tags']

List of text fields used to search within entries.