Accordion

Models

Represents a accordion component, functionally similar to a Slider, except that a accordion item cannot contain hyperlinks or their associated contents.

Accordion items are ordered from their order field value. Items with a zero value for their order will be ordered in an almost arbitrary order (mostly depending from item object id).

class cmsplugin_blocks.models.accordion.Accordion(*args, **kwargs)

Accordion container for items.

title

A required title string.

template

Template choice from available plugin templates in setting BLOCKS_ACCORDION_TEMPLATES. Default to the first choice item.

keep_open

Checkbox to enable “keep items opened” behavior.

size_features

Optional related size features.

color_features

Optional related color features.

extra_features

Optional related extra features.

copy_relations(oldinstance)

Copy FK relations when plugin object is copied as another object

See:

http://docs.django-cms.org/en/latest/how_to/custom_plugins.html#for-foreign-key-relations-from-other-objects

class cmsplugin_blocks.models.accordion.AccordionItem(*args, **kwargs)

Accordion item to include in container.

title

Required title string.

image

Required image file.

image_alt

An optional text string for alternative image text.

content

Optional long text, it will be editable through CKeditor on plugin form.

order

Number for order position in item list.

opened

Checkbox to initially open item.

Factories

Forms

class cmsplugin_blocks.forms.accordion.AccordionForm(data=None, files=None, auto_id='id_%s', prefix=None, initial=None, error_class=<class 'django.forms.utils.ErrorList'>, label_suffix=None, empty_permitted=False, instance=None, use_required_attribute=None, renderer=None)

property media

Return all media required to render the widgets on this form.

class cmsplugin_blocks.forms.accordion.AccordionItemForm(data=None, files=None, auto_id='id_%s', prefix=None, initial=None, error_class=<class 'django.forms.utils.ErrorList'>, label_suffix=None, empty_permitted=False, instance=None, use_required_attribute=None, renderer=None)

property media

Return all media required to render the widgets on this form.

Plugins

class cmsplugin_blocks.plugins.accordion.AccordionPlugin(model=None, admin_site=None)

Accordion interface is able to add/edit/remove accordion items as inline forms.

module = 'Blocks'

Modules collect plugins of similar type

name = 'Accordion'

Name of the plugin needs to be set in child classes

model

alias of Accordion

form

alias of AccordionForm

render_template = 'cmsplugin_blocks/accordion/default.html'

The path to the template used to render the template. If render_plugin is True either this or get_render_template must be defined. See also: render_plugin , get_render_template().

cache = True

Is this plugin cacheable? If your plugin displays content based on the user or request or other dynamic properties set this to False.

If present and set to False, the plugin will prevent the caching of the resulting page.

Important

Setting this to False will effectively disable the CMS page cache and all upstream caches for pages where the plugin appears. This may be useful in certain cases but for general cache management, consider using the much more capable get_cache_expiration().

Warning

If you disable a plugin cache be sure to restart the server and clear the cache afterwards.

get_fieldsets(request, obj=None)

Define plugin form fieldsets depending features are enabled or not (when there is no defined feature choices).

render(context, instance, placeholder)

This method returns the context to be used to render the template specified in render_template.

Parameters:

• context (dict) – The context with which the page is rendered.

• instance (cms.models.pluginmodel.CMSPlugin instance) – The instance of your plugin that is rendered.

• placeholder (str) – The name of the placeholder that is rendered.

Return type:

dict or django.template.Context

This method must return a dictionary or an instance of django.template.Context, which will be used as context to render the plugin template.

By default, this method will add instance and placeholder to the context, which means for simple plugins, there is no need to overwrite this method.

If you overwrite this method it’s recommended to always populate the context with default values by calling the render method of the super class:

def render(self, context, instance, placeholder):
    context = super().render(context, instance, placeholder)
    ...
    return context