cse_elements

Voraussetzung

KLXM YFORM Contentbuilder erforderlich.

Kontaktieren Sie die KLXM Crossmedia, sollten Sie Interesse an dieser Lösung haben: https://klxm.de

Projekt-AddOn für eigene YForm Content Builder Elemente.

Ziel

cse_elements stellt projektspezifische Elemente bereit, ohne das Original-AddOn yform_content_builder direkt zu verändern.

Integration

Die Anbindung erfolgt in boot.php über die Extension Points:

• YFORM_CONTENT_BUILDER_ELEMENT_PATHS
• YFORM_CONTENT_BUILDER_ELEMENT_MODE

Typisches Verhalten:

• replace: Nur CSE-Elemente anzeigen
• merge: Original- und CSE-Elemente gemeinsam anzeigen

Namens- und Label-Konvention

Für klare Unterscheidung (vor allem im merge-Modus):

• Element-Key immer mit cse_ präfixen
• Sichtbares Label ebenfalls mit CSE beginnen

Beispiele:

• cse_starter_text -> CSE Text
• cse_starter_cards -> CSE Cards
• cse_gallery -> CSE Galerie
• cse_downloads -> CSE Downloads
• cse_headline -> CSE Headline
• cse_accordion -> CSE Accordion
• cse_timeline -> CSE Timeline
• cse_table -> CSE Tabelle

Template-Strategie

• CSE-Elemente werden bewusst als UIkit-first gepflegt.
• Für CSE-Elemente werden nur UIkit-Templates bereitgestellt.
• Der CSE-Modulgenerator erzeugt deshalb nur UIkit-Module.

Wrapper-/Sektionseinstellungen

Die gemeinsamen Felder kommen zentral aus lib/CseElementsConfig.php.

Aufbau:

• Wrapper-Toggles: enable_section, enable_container
• Sektionseinstellungen: section_bg, section_bg_image, section_padding, section_light
• Containereinstellung: container_width

UX-Hinweis:

• Es gibt keinen separaten Wrapper-Tab.
• Die Wrapper-Toggles liegen im Sektion-Tab und steuern dort direkt die Sichtbarkeit der Detailfelder.

Im Editor werden die Detailfelder dynamisch ein-/ausgeblendet:

• visible_if funktioniert nicht nur mit Checkboxen, sondern auch mit Radio- und Select-Feldern.
• Wenn enable_container aus ist, wird container_width ausgeblendet.

Das geschieht über die generische visible_if-Konfiguration in den Felddefinitionen.

Beispiel:

'section_bg' => [
	'type' => 'choice',
	'label' => 'Sektions-Hintergrund',
	'visible_if' => ['enable_section' => '1'],
],
'container_width' => [
	'type' => 'choice',
	'label' => 'Container-Breite',
	'visible_if' => ['enable_container' => '1'],
],

Hinweis:

• Die gleiche Logik funktioniert in YForm und in Modul-Editoren, solange das Element über den Content Builder gerendert wird.

Wichtige Dateien

• boot.php
• lib/CseElementsConfig.php
• fragments/cse_elements/wrapper.php
• elements/*/config.php