Autogeneration creates components inside an area automatically, without editor involvement. Anything you define inside the content
item will be autogenerated.
Autogeneration behavior
Autogenerated components behave different from normal components:
- Ordered as defined: In an empty area, components are autogenerated in the same order as they are defined in the area definition.
- New components are placed last: If an area already has autogenerated components, newly defined components will be placed last.
- Cannot delete permanently: When you delete autogenerated component, it is regenerated and placed last in the area.
Autogeneration properties
Configure component autogeneration in an area definition, under the autoGeneration
item. Simple example:
areas: footer: renderType: freemarker type: single autoGeneration: content: quotation: nodeType: mgnl:component templateId: my-module:components/quotation quotationText: <p>Carpe diem.</p> citedPerson: Horace generatorClass: info.magnolia.rendering.generator.CopyGenerator
Properties under autogeneration
:
| required Parent item for autogenerated content. Put everything you want to autogenerate inside this item. |
| required |
| required Value |
| required Component ID in |
generatorClass | required , default is A generator creates nodes based on the definition. The default $webResourceManager.requireResource("info.magnolia.sys.confluence.artifact-info-plugin:javadoc-resource-macro-resources")
CopyGenerator
creates a copy of the exact nodes and properties you define under the content item. You can implement a custom generator class that does something else. Implement the $webResourceManager.requireResource("info.magnolia.sys.confluence.artifact-info-plugin:javadoc-resource-macro-resources")
Generator
interface. |