Inhaltselemente mit LSCE

LSCE ist eine Erweiterung, die für die Merconis Themes angepasste Inhaltselemente bereitstellt.

LSCE ist somit eine Sammlung von Inhaltselementen (custom elements) für Contao. LSCE basiert auf der Erweiterung Custom Elements von RockSolid, um die Backend-Ansicht und die Frontend-Ausgabe der Elemente zu rendern. Die Elemente werden mit dem LSCSS-Framework gestylt, was im Wesentlichen SASS in der SCSS-Syntax bedeutet. Wenn Elemente JavaScript benötigen, greifen die mit den Elementen gelieferten Skripte auf das LSJS-Framework zurück.

Nach der Installation der Erweiterung befinden sich die Daten in assets/lsce. Aus Gründen der Updatesicherheit sollten Sie die Dateien in assets/lsce nicht verändern.

Der Themeinstaller von Merconis legt automatisch im Contaoverzeichnis templates einen Unterorder merconisTemplatesThemeX an.
In diesem Ordner werden die entsprechenden Template- und Configurations-Verweise in den Assets-Ordner angelegt.

Die zu den einzelnen LS-Custom-Elements zugehörigen Stylings werden über die _lsce.scss (files/merconisfiles/themes/theme10/lscss/lsce) geladen und können dort updatesicher nach den eigenen Wünschen angepasst werden.

LSCEs ohne den Merconis-Installer

Sollten Sie den Themeinstaller von Merconis nicht nutzen, möchten aber trotzdem die LS-Inhaltselemente verwenden, dann müssen Sie einfach nur die beiden Dateien im Ordner assets/[Name des LSCEs]/copy im entsprechenden Inhaltselement in das Verzeichnis templates kopieren.
Dies ist notwendig, da die Erweiterung von RockSolid die Configurations-PHP-Datei und das dazugehörige HTML5-Template dort erwartet.
Diese beiden Dateien enthalten die notwendige Referenz in den Assets-Ordner.

Beispiel

Um das Inhaltselement „contentbox“ in Ihrer Contaoinstallation nutzen zu können, kopieren Sie bitte die Datei:

  • rsce_contentbox.html5
  • rsce_contentbox_config.php

aus dem Ordner assets/lsce/contentbox/copy in den Ordner templates.
Für das Styling müssen Sie dann noch die Datei _style.scss aus dem Ordner assets/lsce/contentbox/lscss entweder in Ihre eigenen SCSS-Datei importieren oder Sie kopieren sich deren Inhalt in Ihre eigene Sass-Datei.

Individuelle Anpassungen eines LSCEs

Wenn Sie ein Inhaltselement funktional anpassen möchten, dann kopieren Sie einfach die Inhalte von den beiden Dateien config.php und template.html5 in die entsprechenden Dateien im Ordner Templates.

In unserem Beispiel wären das die Dateien:

  • template.html5 -> rsce_contentbox.html5
  • config.php -> rsce_contentbox_config.php

Nun können Sie updatesicher Anpassungen am Inhaltselement vornehmen.