Skip to content

README.md

Latest commit

 

History

History
98 lines (65 loc) · 2.59 KB

README.md

File metadata and controls

98 lines (65 loc) · 2.59 KB

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