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.
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.
Miscellaneous¶
ZINNIA_COPYRIGHT¶
Default value: 'Zinnia'
String used for copyrighting your entries, used in the syndication feeds and in the opensearch document.
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.