1. List of settings

Zinnia has a lot of parameters to configure the application accordingly to your needs.

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

1.1. Entry

1.1.1. ZINNIA_ENTRY_TEMPLATES

Default value: ()

List of tuple for extending the list of templates availables for rendering the entry.

1.1.2. ZINNIA_ENTRY_BASE_MODEL

Default value: ''

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

1.1.3. ZINNIA_UPLOAD_TO

Default value: 'uploads'

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

1.2. Edition

1.2.1. ZINNIA_MARKUP_LANGUAGE

Default value: 'html'

String determining the markup language used for writing the entries.

1.2.2. ZINNIA_MARKDOWN_EXTENSIONS

Default value: ''

Extensions names to be used when rendering entries in MarkDown.

1.2.3. ZINNIA_WYSIWYG

Default value: 'tinymce' if in settings.INSTALLED_APPS else 'wymeditor' if ZINNIA_MARKUP_LANGUAGE is 'html'. If MarkDown, Textile or reStructuredText are used, the value will be 'markitup'.

Used for determining the WYSIWYG editor for editing an entry. Can also be used for disabling the WYSIWYG functionnality.

1.3. Views

1.3.1. ZINNIA_PAGINATION

Default value: 10

Integer used to paginate the entries.

1.3.2. ZINNIA_ALLOW_EMPTY

Default value: True

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

1.3.3. ZINNIA_ALLOW_FUTURE

Default value: True

Used for allowing archives views in the future.

1.4. Feeds

1.4.1. ZINNIA_FEEDS_FORMAT

Default value: 'rss'

String determining the format of the syndication feeds. Use ‘atom’ for Atom feeds.

1.4.2. ZINNIA_FEEDS_MAX_ITEMS

Default value: 15

Integer used to define the maximum items provided in the syndication feeds.

1.5. URLs

1.5.1. ZINNIA_PROTOCOL

Default value: 'http'

String representing the protocol of the site.

1.5.2. ZINNIA_MEDIA_URL

Default value: os.path.join(settings.MEDIA_URL, 'zinnia/')

String of the url that handles the media files of Zinnia.

1.6. Comment moderation

1.6.1. ZINNIA_AUTO_MODERATE_COMMENTS

Default value: False

Determine if a new comment should be allowed to show up immediately or should be marked non-public and await approval.

1.6.2. ZINNIA_AUTO_CLOSE_COMMENTS_AFTER

Default value: None

Determine the number of days where comments are open.

1.6.3. ZINNIA_MAIL_COMMENT_REPLY

Default value: False

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

1.6.4. ZINNIA_MAIL_COMMENT_AUTHORS

Default value: True

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

1.6.5. ZINNIA_MAIL_COMMENT_NOTIFICATION_RECIPIENTS

Default value: list of emails based on settings.MANAGERS

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

1.6.6. ZINNIA_SPAM_CHECKER_BACKENDS

Default value: ()

List of strings representing the module path to a spam checker backend.

1.7. Pinging

1.7.1. ZINNIA_PING_DIRECTORIES

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

List of the directories you want to ping.

1.7.2. ZINNIA_PING_EXTERNAL_URLS

Default value: True

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

1.7.3. ZINNIA_SAVE_PING_DIRECTORIES

Default value: bool(ZINNIA_PING_DIRECTORIES)

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

1.7.4. ZINNIA_PINGBACK_CONTENT_LENGTH

Default value: 300

Size of the excerpt generated on pingback.

1.8. Similarity

1.8.1. ZINNIA_F_MIN

Default value: 0.1

Float setting of the minimal word frequency for similar entries.

1.8.2. ZINNIA_F_MAX

Default value: 1.0

Float setting of the minimal word frequency for similar entries.

1.9. Miscellaneous

1.9.2. ZINNIA_STOP_WORDS

Default value: See zinnia/settings.py

List of common words excluded from the advanced search engine to optimize the search querying and the results.

1.9.3. ZINNIA_URL_SHORTENER_BACKEND

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

String representing the module path to the url shortener backend.

1.9.4. ZINNIA_USE_TWITTER

Default value: True if python-twitter is in PYTHONPATH

Boolean telling if Zinnia can use Twitter.

1.10. CMS

All the settings related to the CMS can be found in zinnia/plugins/settings.py.

1.10.1. ZINNIA_APP_MENUS

Default value: ('zinnia.plugins.menu.EntryMenu', 'zinnia.plugins.menu.CategoryMenu', 'zinnia.plugins.menu.TagMenu', 'zinnia.plugins.menu.AuthorMenu')

List of strings representing the path to the Menu class provided for the Zinnia AppHook.

1.10.2. ZINNIA_HIDE_ENTRY_MENU

Default value: True

Boolean used for displaying or not the entries in the EntryMenu object.

1.10.3. ZINNIA_PLUGINS_TEMPLATES

Default value: ()

List of tuple for extending the CMS’s plugins rendering templates.