/cmsplugin-zinnia

Bridge between django-blog-zinnia and django-cms

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

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

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

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 makemigrations
$ python manage.py migrate

Tips for using the apphook

If you want to use the apphook to provide the blog functionnalities under a specific URL handled by the CMS, remember this tip:

  • Once the apphook is registered, you can remove the inclusion of 'zinnia.urls' in urls.py and then restart the server to see it in full effect.

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.8.1

  • Remove warnings with Django 1.9

0.8

  • Compatibility with Django 1.8

0.7

  • PlaceholderEntry mixin
  • Compatibility with Django 1.7 and Zinnia 0.15

0.6

  • Compatibility with Django-CMS 3.0

0.5.1

  • Python 3 compatibility fix
  • Better help texts and legends

0.5

  • Archives plugin
  • Tag cloud plugin
  • Author list plugin
  • Categories plugins
  • Featured entries filter
  • Offset for latest entries
  • Documentation improvements
  • Configurable apphook's urls
  • Support custom auth.User model
  • Fix translations of the plugins
  • Fix HTML rendering without context
  • Compatibility with Django v1.5
  • Compatibility with Zinnia v0.13
  • Updating the buildout installation

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.