feat: add instance.get_classes for template components

Author: fsbraun

djangocms_frontend/models.py

@@ -76,9 +76,7 @@ def add_attribute(self, attr, value=None):
 
     def get_attributes(self):
         attributes = self.config.get("attributes", {})
-        classes = set(attributes.get("class", "").split())  # classes added in attriutes
-        classes.update(self._additional_classes)  # add additional classes
-        classes = (f'class="{conditional_escape(" ".join(classes))}"') if classes else ""  # to string
+        classes = self.get_classes()  # get classes
         parts = (
             f'{item}="{conditional_escape(value)}"' if value else f"{item}"
             for item, value in attributes.items()
@@ -87,6 +85,12 @@ def get_attributes(self):
         attributes_string = (classes + " ".join(parts)).strip()
         return mark_safe(" " + attributes_string) if attributes_string else ""
 
+    def get_classes(self):
+        attributes = self.config.get("attributes", {})
+        classes = set(attributes.get("class", "").split())  # classes added in attriutes
+        classes.update(self._additional_classes)  # add additional classes
+        return conditional_escape(" ".join(classes))
+
     def save(self, *args, **kwargs):
         self.ui_item = self.__class__.__name__
         return super().save(*args, **kwargs)

docs/source/tutorial/template_components.rst

@@ -196,7 +196,9 @@ The fields declared earlier (``title``, ``slogan``, and ``hero_image``) are now
     <img src="{{ hero_image.url }}">
 
 The ``{% childplugins %}`` block allows additional CMS plugins (like buttons) to be added inside the component
-in the structure editor.
+in the structure editor. Anything in between ``{% childplugins %}`` and ``{% endchildplugins %}`` will only be
+rendered if the component has no children.
+
 
 Make the component available in django CMS
 -------------------------------------------