Entwickleransicht und Systembereiche im bluetronix CMS

Zusätzliche Funktionen mit Entwicklerzugang

Mit einem Entwicklerzugang stehen dir im bluetronix CMS zusätzliche Funktionen zur Verfügung, die in der normalen Benutzeransicht nicht sichtbar sind.

Dazu gehören zusätzliche Entwicklerordner in der Dateiverwaltung, der Zugriff auf den PHP-Code von Seiten, zusätzliche Entwickler-Datenbanktabellen sowie Systemskripte, Layoutvorlagen und Module.

PHP-Code von Seiten bearbeiten

In der normalen CMS-Ansicht kannst du den HTML-Code einer Seite bearbeiten. Mit Entwicklerzugang steht dir zusätzlich der Button PHP Code zur Verfügung.

Damit kannst du zu einer CMS-Seite eigenen PHP-Code hinterlegen, zum Beispiel für Datenbankabfragen, dynamische Inhalte, Ersetzungen innerhalb von $LayoutHTML, CMS-Funktionen oder eigene PHP-Funktionen.

Zusätzliche Datenbanktabellen

Mit einem Entwicklerzugang werden in der Datenbankverwaltung zusätzliche Systemtabellen angezeigt. Dazu gehören beispielsweise Tabellen für Layouts, Seitenverwaltung, Systemkonfigurationen und weitere interne CMS-Funktionen.

Diese Entwickler- und Systemtabellen werden innerhalb der Datenbankverwaltung rot markiert.

Die Struktur der rot markierten Entwickler-Datenbanktabellen darf nicht verändert werden. Du darfst dort keine Spalten löschen, hinzufügen oder umbenennen, keine Datentypen verändern und keine Systemstrukturen anpassen. Diese Tabellen können bei einem Systemupdate aktualisiert oder ersetzt werden.

Entwicklerordner in der Dateiverwaltung

Mit Entwicklerzugang werden zusätzliche Systemordner innerhalb der Dateiverwaltung sichtbar. Diese Entwicklerordner sind rot dargestellt und beginnen grundsätzlich mit bx_.

Zu den wichtigsten Ordnern gehören bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script und bx_style.

bx_doc

Im Ordner bx_doc befinden sich vorinstallierte Beispieldateien und Dokumente. Dazu können beispielsweise PDF-Dokumente gehören, die innerhalb von Beispielseiten oder Vorlagen verwendet werden.

bx_fonts

Im Ordner bx_fonts befinden sich die vom bluetronix CMS bereitgestellten beziehungsweise installierten Schriftarten. Diese Fonts können innerhalb der verschiedenen Designs und Layouts des CMS verwendet werden.

bx_Img

Der Ordner bx_Img enthält die Standardbilder des aktuell verwendeten Theme- beziehungsweise Themenbild-Sets.

Als Entwickler kannst du ein anderes Themenbild-Set auswählen. Die verschiedenen Themenbild-Sets verwenden dieselben definierten Dateinamen und funktionieren dadurch wie eine einheitliche Schablone. Die HTML-Struktur muss beim Wechsel eines Themenbild-Sets nicht verändert werden.

bx_Import

Der Ordner bx_Import wird für den Import externer Webseiten verwendet. Beispielsweise können Bootstrap-5-Webseiten für einen Import vorbereitet und innerhalb dieses Bereichs abgelegt werden. Die Dateien werden anschließend analysiert und in die Struktur des bluetronix CMS übernommen.

bx_Layout

Im Ordner bx_Layout befinden sich die Seiten- und Abschnittsvorlagen des CMS. Diese Vorlagen stehen dem Benutzer anschließend beispielsweise über Einfügen → Seitenabschnitt zur Verfügung.

Als Entwickler kannst du eigene Vorlagen für Hero-Sections, Textbereiche, Produktbereiche, Kontaktbereiche, Teaser-Elemente und weitere individuelle Seitenabschnitte erstellen. Der Endkunde kann diese Elemente anschließend über den normalen Editor einfügen, ohne selbst HTML programmieren zu müssen.

bx_script

Im Ordner bx_script befinden sich die vom bluetronix CMS bereitgestellten JavaScript-Dateien. Dazu gehören unter anderem BxHeadScript.js und BxScript.js.

Abhängig von den aktivierten Sprachen können zusätzlich sprachabhängige Versionen erzeugt werden, beispielsweise BxScript_en.js, BxScript_de.js oder BxScript_fr.js.

Innerhalb der script-Ordners befindet sich zusätzlich ein Source-Verzeichnis. Dort liegen einzelne Quelldateien beziehungsweise Bestandteile, aus denen die später verwendeten Hauptdateien erzeugt werden.

bx_style

Analog zu bx_Script enthält bx_style die zentralen Styles des bluetronix CMS. Daraus werden unter anderem die vom System verwendeten Stylesheet-Dateien erzeugt. Auch hier können Source-Dateien vorhanden sein, aus denen die endgültigen CSS-Dateien zusammengesetzt werden.

Systemordner und Updates

Rot markierte bx_-Systemordner gehören zum bluetronix CMS und können bei einem Systemupdate vollständig oder teilweise überschrieben werden. Eigene Änderungen dürfen deshalb nicht direkt in den normalen Systemdateien gespeichert werden.

Eigene Dateien innerhalb der Systembereiche müssen mit _own gekennzeichnet werden. Diese Kennzeichnung signalisiert dem bluetronix CMS, dass es sich um eine eigene projektspezifische Datei handelt.

Beispiele sind config_own.php, MyScript_own.js, MyStyle_own.css oder MyTemplate_own.txt. Die Dateiendung spielt dabei grundsätzlich keine Rolle. Entscheidend ist die Kennzeichnung _own im Dateinamen.

Eigene Anpassungen daher innerhalb der roten Systemordner immer als _own-Datei anlegen. Dadurch bleiben diese eigenen Dateien auch bei einem Update des bluetronix CMS erhalten.

Systemdateien nicht direkt verändern

Eine vorhandene Systemdatei solltest du also nicht direkt bearbeiten. Verwende sie bei Bedarf als Vorlage, kopiere sie, kennzeichne die Kopie mit _own und führe deine eigenen Anpassungen anschließend in dieser Datei durch.

bx_Mod

Im Ordner bx_Mod befinden sich die Module des bluetronix CMS. Dazu können beispielsweise Blog, Shop, Suche, Login und weitere CMS-Module gehören.

Ein Modul kann unterschiedliche Dateien und Bereiche enthalten, beispielsweise Konfigurationen, Listen, Detailansichten, PHP-Skripte und weitere Moduldateien.

Moduldateien anpassen

Auch bei Moduldateien gilt: Die originale Systemdatei sollte nicht direkt verändert werden. Du kannst sie anzeigen, lesen, als Grundlage verwenden und kopieren. Für eine eigene Version legst du anschließend eine Kopie mit _own an und führst deine Änderungen dort durch.

Die wichtigsten Regeln für Entwickler

1. Rot markierte Datenbanktabellen nicht strukturell verändern.
2. Rot markierte bx_-Systemordner können bei Updates überschrieben werden.
3. Systemdateien nicht direkt für eigene Anpassungen verändern.
4. Eigene Dateien innerhalb der Systembereiche immer mit _own kennzeichnen.
5. Systemdateien können als Vorlage gelesen und kopiert werden.
6. Eigene Anpassungen anschließend innerhalb der _own-Datei durchführen.

Zusammenfassung

Der Entwicklerzugang erweitert das bluetronix CMS um zusätzliche Funktionen und Systembereiche wie PHP-Code, Entwickler-Datenbanktabellen, bx_-Systemordner, Module, Skripte, Styles und Layoutvorlagen.

Besonders wichtig ist die Trennung zwischen Systemdateien und eigenen Erweiterungen. Originale Systemdateien verwendest du als Vorlage, eigene Anpassungen legst du als _own-Datei an.