Plugins¶
See also
CMS Plugins are reusable content publishers that can be inserted into django CMS pages (or indeed into any content that uses django CMS placeholders). They enable the publishing of information automatically, without further intervention.
This means that your published web content, whatever it is, is kept up-to-date at all times.
It’s like magic, but quicker.
Unless you’re lucky enough to discover that your needs can be met by the built-in plugins, or by the many available third-party plugins, you’ll have to write your own custom CMS Plugin.
Why would you need to write a plugin?¶
A plugin is the most convenient way to integrate content from another Django application into a django CMS page.
For example, suppose you’re developing a site for a record company in django CMS. You might like to have a “Latest releases” box on your site’s home page.
Of course, you could every so often edit that page and update the information. However, a sensible record company will manage its catalogue in Django too, which means Django already knows what this week’s new releases are.
This is an excellent opportunity to make use of that information to make your life easier - all you need to do is create a django CMS plugin that you can insert into your home page, and leave it to do the work of publishing information about the latest releases for you.
Plugins are reusable. Perhaps your record company is producing a series of reissues of seminal Swiss punk records; on your site’s page about the series, you could insert the same plugin, configured a little differently, that will publish information about recent new releases in that series.
Components of a plugin¶
A django CMS plugin is fundamentally composed of three components, that correspond to Django’s familiar Model-View-Template scheme:
What |
Function |
Subclass of |
---|---|---|
model (if required) |
plugin instance configuration |
|
view |
display logic |
|
template |
rendering |
– |
CMSPlugin
¶
The plugin model, the sub-class of cms.models.pluginmodel.CMSPlugin
, is
optional.
You could have a plugin that doesn’t need to be configured, because it only ever does one thing.
For example, you could have a plugin that only publishes information about the top-selling record of the past seven days. Obviously, this wouldn’t be very flexible - you wouldn’t be able to use the same plugin for the best-selling release of the last month instead.
Usually, you find that it is useful to be able to configure your plugin, and this will require a model.
CMSPluginBase
¶
cms.plugin_base.CMSPluginBase
is actually a sub-class of
django.contrib.admin.ModelAdmin
.
Because CMSPluginBase
sub-classes ModelAdmin
several
important ModelAdmin
options are also available to CMS plugin developers. These
options are often used:
exclude
fields
fieldsets
form
formfield_overrides
inlines
radio_fields
raw_id_fields
readonly_fields
Please note, however, that not all ModelAdmin
options are effective in a CMS plugin.
In particular, any options that are used exclusively by the ModelAdmin
’s
changelist
will have no effect. These and other notable options that are ignored by
the CMS are:
actions
actions_on_top
actions_on_bottom
actions_selection_counter
date_hierarchy
list_display
list_display_links
list_editable
list_filter
list_max_show_all
list_per_page
ordering
paginator
prepopulated_fields
preserve_fields
save_as
save_on_top
search_fields
show_full_result_count
view_on_site