CMS-Module einbinden und anpassen
In diesem Tutorial passt du das Blog-Modul des bluetronix CMS an: von der Aktivierung und Einbindung der Blog-Liste bis zu eigenen Moduldateien, Konfigurationswerten und Sprachdateien.
Voraussetzungen und Ziel des Tutorials
Für dieses Tutorial benötigst du einen Entwicklerzugang zum bluetronix CMS. Du solltest bereits wissen, wie die Entwicklerordner funktionieren und warum eigene Dateien in den Systemordnern mit _own gekennzeichnet werden.
Wir verwenden das vorhandene News - Blog-Modul als Beispiel. Du aktivierst das Modul, bindest seine Listenansicht in eine CMS-Seite ein und passt anschließend gezielt eine eigene Moduldatei sowie die Konfiguration an. Die Originaldateien bleiben dabei unverändert.
1. Blog-Modul aktivieren
Öffne im CMS Module und wähle News - Blog aus.
Aktiviere die Option Blog Modul aktivieren und bestätige die Sicherheitsabfrage mit OK.
Anschließend steht dir der Modul-Konfigurator zur Verfügung. Links befinden sich die technischen Einstellungen, rechts die sprachabhängigen Modultexte.
2. Blog-Liste in einer CMS-Seite einbinden
Öffne die Seite /Blog/index.html und wähle HTML Code. Die Blog-Seite wird über eine kurze CMS-Markierung eingebunden.
<!--bx_Mod/Blog/Modul-Blog-List-->
Die Markierung verweist auf das Blog-Modul und dessen Listenansicht. Das CMS setzt beim Rendern an dieser Stelle die erzeugte Ausgabe des Moduls ein.
3. Zentrale Moduldateien im Dateimanager öffnen
Die eigentliche PHP- und HTML-Logik der Module liegt nicht direkt im Seiten-HTML, sondern zentral im Systemordner bx_Mod. Öffne im Datei-Manager zuerst diesen Ordner und danach den Unterordner Blog.
Im Blog-Ordner findest du beispielsweise Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, weitere Moduldateien und den Unterordner languages.
4. Standarddatei der Blog-Liste ansehen
Wähle Modul-Blog-List.php aus und öffne sie über Bearbeiten.
Die Standarddatei enthält die Programmlogik für die Listenansicht. Im gezeigten Code werden unter anderem die Modulkonfiguration und, falls vorhanden, die projektspezifische config_own.php eingebunden.
Damit kann eine einzige Moduleinbindung auf verschiedenen Seiten dieselbe zentrale Programmlogik verwenden. Für Projekte, die das Standardmodul benutzen, können spätere CMS-Updates Änderungen an dieser Datei bereitstellen.
Bearbeite die originale Modul-Blog-List.php nicht direkt. Sie gehört zum System und kann bei einem CMS-Update überschrieben werden.
5. Eigene Listenansicht mit _own erstellen
Um die Ausgabe selbst zu verändern, kopierst du die Standarddatei. Die eigene Kopie erhält exakt die passende _own-Kennzeichnung:
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Öffne die neue Datei Modul-Blog-List_own.php. In dieser projektspezifischen Version kannst du PHP-Logik und HTML-Ausgabe verändern, ohne die Standarddatei anzufassen.
In unserem Test ergänzen wir bei der Überschrift die gut sichtbare Zeichenfolge NEW!!!!. Die übrige Listenansicht bleibt erhalten.
Speichere die eigene Moduldatei und lade die Blogseite erneut. Das CMS verwendet die passende _own-Variante, während der Platzhalter in /Blog/index.html unverändert bleibt. Du erkennst die aktive eigene Datei an der veränderten Überschrift NEW!!!! NEUESTE ARTIKEL.
6. Modul-Einstellungen und eigene Konfiguration
Neben der HTML-Ausgabe kannst du auch die Konfiguration des Moduls verändern. Der Screenshot zeigt im Konfigurator beispielsweise für Modul-Blog-ShowCase den Wert DS Repeats = 3.
Ändere den Wert auf 2 und speichere die Einstellung. Damit wird die gewünschte Anzahl für diesen ShowCase-Bereich festgelegt. Die Einstellung bezieht sich auf Modul-Blog-ShowCase und ist nicht automatisch mit der Anzahl aller Artikel der Blog-Listenansicht gleichzusetzen.
Die eigene Konfiguration liegt unter bx_Mod/Blog/config_own.php. Wähle diese Datei im Dateimanager aus.
Die gezeigte config_own.php überschreibt den Wert gezielt nur dann, wenn der betroffene Modulbereich Modul-Blog-ShowCase geladen wird:
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
Die Standardwerte kommen weiterhin aus config.php. Eine eigene Konfigurationsdatei muss daher nicht sämtliche Standardwerte wiederholen, sondern kann nur die gewünschten Abweichungen enthalten.
7. Datenbanktabelle und Modul-Seiten festlegen
In der Standardkonfiguration bx_Mod/Blog/config.php findest du unter anderem die verwendete Datenbanktabelle sowie die Pfade zur Detail- und Listenansicht. Im gezeigten Beispiel lauten die Werte:
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Wenn du auf Basis des Blog-Moduls eine eigene Variante für einen anderen Zweck entwickelst, kannst du in deiner eigenen Konfiguration beispielsweise eine andere Datenbanktabelle hinterlegen. Prüfe dabei, ob die neue Tabelle die von deiner Moduldatei erwarteten Felder enthält und ob Listen- und Detailseiten zur neuen Variante passen.
8. Sprachdateien des Moduls
Unter bx_Mod/Blog/languages befinden sich die Sprachdateien des Blog-Moduls. Für die vorhandenen Sprachen gibt es separate PHP-Dateien, beispielsweise de.php, en.php und fr.php.
Hier werden sprachabhängige Modultexte verwaltet. Verwende für projektspezifische Änderungen das von deiner Modulversion unterstützte eigene Dateiformat, statt Original-Sprachdateien direkt zu überschreiben.
9. Standardmodul und eigene Version unterscheiden
Die _own-Regel schützt deine Anpassungen vor dem Überschreiben durch reguläre Updates. Gleichzeitig bist du für die Pflege dieser individuellen Version selbst verantwortlich. Prüfe bei späteren CMS-Updates, ob wichtige Änderungen an der Standarddatei auch für deine eigene Datei relevant sind.
10. Zusammenfassung
Du aktivierst das Blog-Modul unter Module → News - Blog, bindest die Listenansicht über eine CMS-Markierung ein und verwaltest die eigentliche Programmlogik zentral unter bx_Mod/Blog. Für eigene Änderungen kopierst du Modul-Blog-List.php zu Modul-Blog-List_own.php. Einstellungen, die vom Standard abweichen, hinterlegst du bei Bedarf in config_own.php.
CMS-Seite /Blog/index.html
↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-SeiteAuf diese Weise lässt sich ein vorhandenes Modul gezielt erweitern, ohne die ursprünglichen Systemdateien zu verändern.
FAQ
was Kunden uns häufig Fragen
Welchen Zugang brauche ich, um CMS-Module anzupassen?
Du benötigst einen Entwicklerzugang zum bluetronix CMS. Zusätzlich solltest du die Entwicklerordner und die _own-Regel kennen.
Wo aktiviere ich das Blog-Modul?
Öffne Module, wähle News - Blog aus und aktiviere Blog Modul aktivieren. Bestätige die Sicherheitsabfrage.
Wie binde ich die Blog-Liste in eine CMS-Seite ein?
Öffne den HTML-Code der gewünschten Seite und füge die Modul-Markierung <!--bx_Mod/Blog/Modul-Blog-List--> ein.
Muss ich den vollständigen PHP-Code der Blog-Liste in die Seite kopieren?
Nein. Die Seite enthält nur die Modul-Markierung. Die zugehörige Logik wird zentral aus dem Blog-Modul geladen.
Wo befindet sich die Standarddatei der Blog-Liste?
Du findest sie unter bx_Mod/Blog/Modul-Blog-List.php im Entwicklerbereich des Dateimanagers.
Wie passe ich eine Moduldatei updatefähig an?
Kopiere die Standarddatei und kennzeichne die Kopie mit _own, zum Beispiel Modul-Blog-List_own.php. Bearbeite anschließend nur diese eigene Datei.
Muss die Modul-Markierung geändert werden, wenn ich eine _own-Datei anlege?
Nein. Für eine vom CMS unterstützte Moduldatei kann die passende _own-Variante automatisch verwendet werden, ohne die bestehende Moduleinbindung zu verändern.
Wofür wird config_own.php benötigt?
Über bx_Mod/Blog/config_own.php kannst du einzelne Werte aus der Standardkonfiguration projektspezifisch überschreiben.
Was bewirkt DS Repeats in diesem Beispiel?
Im gezeigten Beispiel wird die Einstellung für Modul-Blog-ShowCase von 3 auf 2 geändert. Sie legt die Anzahl der Wiederholungen dieses Modulbereichs fest.
Wo ist festgelegt, welche Datenbanktabelle das Blog-Modul verwendet?
In der Konfiguration bx_Mod/Blog/config.php steht im Beispiel $CF_DatabaseTable = "Blog";. Die Zuordnung kann für eine eigene Modulvariante angepasst werden.
Wo finde ich die Sprachdateien des Blog-Moduls?
Die sprachabhängigen PHP-Dateien befinden sich unter bx_Mod/Blog/languages, beispielsweise de.php und en.php.
Wer übernimmt die Pflege einer eigenen Moduldatei?
Die eigene _own-Datei bleibt bei regulären CMS-Updates bestehen. Der Entwickler muss selbst prüfen, ob neue Fehlerbehebungen oder Funktionen aus der Standarddatei übernommen werden sollen.