Template filters

djangocms-frontend provides template filters that can be used in component templates. Load them with {% load frontend %}.

get_slot(instance, slot_name)

Import from djangocms_frontend.templatetags.frontend.

Get plugins for a specific slot directly from a component instance. This is useful for manually iterating over slot plugins in a component’s template instead of using the {% childplugins %} template tag.

Parameters:

  • instance – The component plugin instance

  • slot_name – The name of the slot to retrieve plugins from

Returns:

Generator yielding child plugin instances in the specified slot

Usage in templates:

{% load frontend %}

{% for plugin in instance|get_slot:"buttons" %}
    {# Manually render each plugin in the slot #}
    <div class="button-wrapper">
        {% render_plugin plugin %}
    </div>
{% endfor %}

This is useful when you need more control over how slot content is rendered, compared to the {% childplugins %} tag which handles rendering automatically.

get_attributes(attribute_field, *add_classes)

Simple tag that joins classes with an attributes field and returns all HTML attributes formatted for use in templates.

Parameters:

  • attribute_field – Dictionary of HTML attributes (e.g., {"class": "btn", "id": "my-id"})

  • add_classes – Additional CSS classes to merge with existing ones

Returns:

Safe HTML string of formatted attributes

Usage in templates:

{% load frontend %}

{# Basic usage with attributes field #}
<div {% get_attributes instance.attributes %}>

{# Add additional classes #}
<div {% get_attributes instance.attributes "extra-class" "another-class" %}>

{# Combine multiple class sources #}
<button {% get_attributes instance.attributes some_variable "static-class" %}>

Behavior:

  • Merges all provided classes into a single class attribute

  • Properly escapes attribute values for safety

  • Handles boolean attributes (renders just the attribute name if value is empty)

  • Returns a safe HTML string that can be used directly in templates