cgenie / cmsplugin-zinnia

Bridge between django-blog-zinnia and django-cms

Cmsplugin-zinnia

Cmsplugin-zinnia is a bridge between django-blog-zinnia and django-cms.

This package provides plugins, menus and apphook to integrate your Zinnia powered Weblog into your django-cms Web site.

The code bundled in this application is a copy of the original zinnia.plugins module, made for forward compatibility with django-blog-zinnia > 0.11.

Contents

• Installation
• Entries with plugins
• Settings
  • CMSPLUGIN_ZINNIA_APP_URLS
  • CMSPLUGIN_ZINNIA_APP_MENUS
  • CMSPLUGIN_ZINNIA_HIDE_ENTRY_MENU
  • CMSPLUGIN_ZINNIA_TEMPLATES
• Changelog
  • 0.4.1
  • 0.4
  • 0.3
  • 0.2
  • 0.1

Installation

Once Zinnia and the CMS are installed, you simply have to register cmsplugin_zinnia, in the INSTALLED_APPS section of your project's settings.

Entries with plugins

If you want to use the plugin system of django-cms in your entries, an extended Entry with a PlaceholderField is provided in this package.

Just add this line in your project's settings to use it.

ZINNIA_ENTRY_BASE_MODEL = 'cmsplugin_zinnia.placeholder.EntryPlaceholder'

Note

If you are using South for migrating your models, you have to keep in mind that the default migrations bundled with Zinnia do not reflect the addition made by the EntryPlaceholder model.

A solution to initialize correctly the database can be:

$ python manage.py syncdb --all
$ python manage.py migrate --fake

Settings

CMSPLUGIN_ZINNIA_APP_URLS

Default value: ['zinnia.urls']

The URLsets used for by the Zinnia AppHook.

CMSPLUGIN_ZINNIA_APP_MENUS

Default value:

['cmsplugin_zinnia.menu.EntryMenu',
 'cmsplugin_zinnia.menu.CategoryMenu',
 'cmsplugin_zinnia.menu.TagMenu',
 'cmsplugin_zinnia.menu.AuthorMenu']

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

CMSPLUGIN_ZINNIA_HIDE_ENTRY_MENU

Default value: True

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

CMSPLUGIN_ZINNIA_TEMPLATES

Default value: [] (Empty list)

List of tuple for extending the plugins rendering templates.

Example:

CMSPLUGIN_ZINNIA_TEMPLATES = [
  ('entry_custom.html', 'Entry custom'),
  ('entry_custom_bis.html', 'Entry custom bis')
  ]

Changelog

0.4.1

• Compatibility fix for Django-CMS 2.2+

0.4

• Fix issues with Entry.content rendering.
• Compatibility with latest version of Zinnia.

0.3

• Calendar plugin.
• QueryEntries plugin.
• Slider template for plugins.
• Documentation improvements.
• Fix breadcrumbs with month abbrev.
• Compatibility with Django 1.4 and Django-CMS 2.3.

0.2

• Better demo.
• Renaming modules.
• Fix dependancies with mptt.
• Fix EntryPlaceholder's Meta.
• 0 means all the entries on plugins.
• Set menu Nodes to invisible instead of removing.

0.1

• Initial release based on zinnia.plugins.