Jetzt App downloaden und 10 Tage kostenlos testen
Währung Sprache auswählen Region auswählen

Ziel des Tutorials

In diesem Tutorial importierst du ein vorhandenes Bootstrap-5-Layout in das bluetronix CMS. Dabei zerlegst du die ursprüngliche HTML-Seite in Header, Footer, einzelne Section-Vorlagen und den eigentlichen Layout-Rahmen. Anschließend kannst du die einzelnen Seitenabschnitte im Editor frei einfügen, verschieben und mehrfach verwenden.

Hinweis: Dieses Tutorial behandelt den grundlegenden Layout-Import. Die weitere Bearbeitung beziehungsweise Ersetzung von Bildern wird in einem folgenden Tutorial behandelt.

1. Original-Template unter bx_Import öffnen

Öffne im Datei-Manager den Ordner bx_Import. Dort befindet sich das importierte Layout zunächst im Originalzustand – beispielsweise mit den ursprünglichen Bilderordnern und HTML-Dateien. In diesem Bereich arbeitest du nur mit den vorhandenen Originaldateien; Änderungen werden nicht in das Original-Template zurückgespeichert.

Öffne für dieses Beispiel die Datei index.html und wechsle auf Bearbeiten. Diese Datei wird nun in die einzelnen Bestandteile des CMS-Layouts zerlegt.

Screenshot-Platzhalter: Datei-Manager mit geöffnetem Ordner bx_Import, Bilderordnern und den originalen HTML-Dateien – dev_bootstrap_import_bx_import_originaldateien.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

Screenshot-Platzhalter: index.html aus bx_Import im HTML-Editor – dev_bootstrap_import_index_html_bearbeiten.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

2. Header aus der index.html heraustrennen

Suche im HTML-Code mit Strg + F nach header. Bei vielen Bootstrap-Templates lässt sich der Header dadurch schnell finden, weil er mit einem entsprechenden HTML-Element markiert ist. Bei manchen Templates besteht der Header lediglich aus einem div-Bereich; in diesem Fall musst du den Aufbau genauer prüfen.

Markiere den vollständigen Header-Bereich und kopiere ihn. Arbeite am besten mit zwei geöffneten Fenstern, damit du zwischen dem Original-Template und deinem CMS-Projekt wechseln kannst.

Screenshot-Platzhalter: Header-Bereich der index.html über die Suche gefunden und zum Kopieren markiert – dev_bootstrap_import_header_markieren.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

3. Header in das CMS übernehmen

Wechsle zurück zu deinem Projekt, öffne das Hauptverzeichnis und anschließend Header → HTML-Code. Füge dort den zuvor kopierten Header-Code ein.

Prüfe anschließend die lokalen Pfade. Bei vielen Layouts müssen relative Verweise und Bildpfade mit einem führenden Slash versehen werden, damit sie innerhalb der CMS-Struktur korrekt funktionieren.

href="css/style.css"   →   href="/css/style.css"
src="images/logo.jpg"  →   src="/images/logo.jpg"

Wichtig: Verwende Strg + H für Suchen und Ersetzen, aber ersetze Pfade nicht blind. Prüfe insbesondere externe URLs, Anker, mailto:-Links und bereits absolute Pfade.

Screenshot-Platzhalter: Hauptverzeichnis → Header → HTML-Code mit eingefügtem Header – dev_bootstrap_import_header_html_einfuegen.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

Suche anschließend den Footer in der ursprünglichen index.html. Schneide beziehungsweise kopiere den vollständigen Footer-Bereich und füge ihn in die dafür vorgesehene Footer-Datei im Hauptverzeichnis deines Projekts ein. Prüfe auch dort alle lokalen href- und src-Pfade.

Screenshot-Platzhalter: Footer-Datei im Hauptverzeichnis mit eingefügtem Footer-Code – dev_bootstrap_import_footer_html_einfuegen.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

5. Main-Bereich in einzelne Section-Templates aufteilen

Der nach Header und Footer verbleibende Seiteninhalt wird nicht direkt in die index.html deines Projekts kopiert. Öffne stattdessen bx_Layout → SectionTemplate.txt → HTML-Code.

Füge den verbleibenden Main-Bereich des Original-Templates am Ende dieser Datei ein. Teile ihn anschließend in die einzelnen Bereiche auf, die später separat im Editor zur Verfügung stehen sollen.

Zwischen zwei Section-Vorlagen setzt du exakt folgenden Trenner:

<!--__SP_SectionTemplate__-->

Jeder dadurch getrennte Abschnitt kann später als eigene Vorlage im Editor eingefügt werden. Dadurch kannst du Sections frei anordnen, mehrfach verwenden oder auf einer Seite weglassen.

Screenshot-Platzhalter: bx_Layout → SectionTemplate.txt mit mehreren Sections und dem Trenner <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

6. Layout-Rahmen in 00_layout übernehmen

Nach dem Heraustrennen von Header, Footer und Main-Sections bleibt der eigentliche HTML-Rahmen übrig, beispielsweise mit DOCTYPE, dem head-Bereich und weiteren übergeordneten Layout-Elementen. Kopiere diesen verbleibenden Code.

Öffne anschließend die Datenbankverwaltung und bearbeite die Datenbank 00_layout. Dort stehen bereits Layout-Vorlagen zur Verfügung. Du kannst eine vorhandene Vorlage bearbeiten oder ein neues Layout anlegen.

Füge den kopierten Rahmen unter LayoutHTML ein. An den ursprünglichen Positionen von Header, Hauptinhalt und Footer verwendest du die CMS-Marken:

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Beim Rendern der Seite werden diese Marken durch den jeweiligen Header, die aktuelle Hauptseite und den Footer ersetzt. Der zugehörige PHP-Code unter LayoutPHP wird beim Laden des Layouts automatisch ausgeführt.

Screenshot-Platzhalter: Datenbank 00_layout mit LayoutHTML und den Marken für Header, Main und Footer – dev_bootstrap_import_00_layout_layouthtml.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

7. CSS-, JavaScript- und Favicon-Pfade prüfen

Prüfe innerhalb des Layout-Codes alle Verweise auf CSS-, JavaScript- und Favicon-Dateien. Setze bei lokalen Pfaden den benötigten führenden Slash. Für CSS- und JavaScript-Dateien verwendest du zusätzlich die Dateiversions-Markierung des CMS.

Ein JavaScript-Aufruf kann beispielsweise so aussehen:

<script src="__FV_/bx_script/core.min.js__"></script>

Die Markierung __FV_...__ ermöglicht es dem System, die Dateiversion beziehungsweise das Änderungsdatum beim Rendern zu berücksichtigen. Dadurch kann der Browser nach Änderungen die aktuelle CSS- oder JavaScript-Datei laden, ohne dass der Benutzer seinen Browser-Cache manuell aktualisieren muss.

8. Head-Inhalte bereinigen und Header-HTML verwenden

Prüfe den übernommenen head-Bereich und entferne Inhalte, die bereits vom CMS gesetzt oder an anderer Stelle geladen werden. Auch einen fest eingetragenen Seitentitel kannst du entfernen, wenn dieser vom System automatisch erzeugt wird.

Header-Code, der vom Editor benötigt wird und nicht direkt Bestandteil von LayoutHTML sein soll, hinterlegst du unter Extras → Header-HTML. Der Editor kann dadurch die dort hinterlegten Inhalte beim Bearbeiten der Seite berücksichtigen.

Screenshot-Platzhalter: Extras → Header-HTML mit dem dorthin verschobenen Header-Code – dev_bootstrap_import_extras_header_html.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

9. Importiertes Layout für die Seite auswählen

Wenn du ein neues Layout in 00_layout angelegt hast, öffne im Editor die Seiteneinstellungen und wähle dort dein importiertes Layout aus. Erst dadurch wird die betreffende Seite mit diesem Layout-Rahmen dargestellt.

Screenshot-Platzhalter: Seiteneinstellungen mit Auswahl des neu importierten Layouts – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

10. Startseite aus den importierten Sections zusammensetzen

Klicke bei deiner Seite auf Editieren. Die Startseite kann zunächst leer erscheinen. Das ist normal, weil noch keine der neuen Seitenabschnitte in die eigentliche Seite eingefügt wurden.

Wähle Einfügen → Seitenabschnitt. Dort sollten die Bereiche erscheinen, die du zuvor in SectionTemplate.txt mit dem Section-Trenner voneinander getrennt hast.

Füge die benötigten Sections nacheinander ein und stelle damit die ursprüngliche Seite nach. Du kannst die Abschnitte anschließend beliebig verschieben, weglassen oder mehrfach einfügen.

Screenshot-Platzhalter: Editor → Einfügen → Seitenabschnitt mit den importierten Section-Vorlagen – dev_bootstrap_import_sections_einfuegen.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

11. Originalseite als Referenz verwenden

Unter Dateien → bx_Import kannst du die ursprüngliche index.html weiterhin als Vorschau öffnen. Verwende sie als Referenz, während du deine neue CMS-Seite aus den einzelnen Sections zusammensetzt.

Wenn bei einzelnen Vorlagen zunächst Bilder fehlen, wird deren korrekte Übernahme in einem folgenden Tutorial behandelt.

12. Pfade und Editierbarkeit aller Sections prüfen

Kontrolliere zum Abschluss noch einmal Sections → Section Template und prüfe sämtliche lokalen Pfade. Bei vielen gleichartigen Pfaden kannst du die Änderungen in einem Texteditor mit Strg + H effizient durchführen.

Teste danach jede importierte Section im Editor. Prüfe, ob alle Inhalte korrekt angezeigt werden und die vorgesehenen Texte und Elemente bearbeitet werden können.

Falls beispielsweise ein Text nicht bearbeitet werden kann, prüfe dessen HTML-Struktur. Liegt ein normaler Text direkt in einem div-Container, kann es je nach Aufbau sinnvoll sein, den Text in ein dafür geeignetes p-Element zu verschieben.

Screenshot-Platzhalter: Fertig zusammengesetzte Startseite nach dem Einfügen und Anordnen der Sections – dev_bootstrap_import_fertige_startseite.jpeg. Bild noch aufnehmen und anschließend an dieser Stelle einbinden.

13. Warum das Layout aufgeteilt wird

Durch die Trennung von Header, Footer, Layout-Rahmen und einzelnen Sections musst du diese Bestandteile bei neuen Seiten nicht immer wieder aus der ursprünglichen Bootstrap-Datei kopieren.

Der zentrale Header und Footer können wiederverwendet werden, während die einzelnen Seitenabschnitte als flexible Vorlagen im Editor zur Verfügung stehen. So kannst du aus einem Bootstrap-Template unterschiedliche Seiten zusammenstellen und die Reihenfolge der Inhalte jederzeit verändern.

Zusammenfassung

Für den Bootstrap-5-Import verwendest du die Originaldateien unter bx_Import als Vorlage. Header und Footer werden getrennt in die vorgesehenen CMS-Bereiche übernommen, der Main-Bereich wird über SectionTemplate.txt in einzelne Vorlagen zerlegt und der verbleibende HTML-Rahmen unter 00_layout → LayoutHTML gespeichert.

Anschließend wählst du das Layout in den Seiteneinstellungen aus und setzt die Seite über Einfügen → Seitenabschnitt aus den importierten Sections zusammen. Prüfe zum Schluss alle Pfade, CSS- und JavaScript-Verweise sowie die Bearbeitbarkeit der einzelnen Sections.

FAQ

was Kunden uns häufig Fragen

Warum bleibt das ursprüngliche Bootstrap-Template unter bx_Import erhalten?

Der Ordner bx_Import dient als Ausgangspunkt und Referenz für das importierte Original-Template. Die benötigten Bestandteile werden daraus in die jeweiligen CMS-Bereiche übernommen.

Welche Datei verwende ich für den ersten Import?

In diesem Tutorial wird die index.html als Ausgangspunkt verwendet. Aus ihr werden Header, Footer, Main-Sections und der verbleibende Layout-Rahmen herausgetrennt.

Wie finde ich Header und Footer schnell im HTML-Code?

Verwende Strg + F und suche beispielsweise nach header beziehungsweise footer. Bei Templates ohne entsprechende HTML-Tags musst du die umgebenden div-Strukturen genauer prüfen.

Wo werden die einzelnen Seitenabschnitte gespeichert?

Die Vorlagen werden unter bx_Layout in SectionTemplate.txt hinterlegt und mit dem Trenner <!--__SP_SectionTemplate__--> voneinander getrennt.

Welche Marken benötigt LayoutHTML?

An den Positionen der herausgetrennten Bereiche verwendest du __DB_Layout_Header__, __DB_Layout_Main__ und __DB_Layout_Footer__.

Warum werden CSS- und JavaScript-Dateien mit __FV_ markiert?

Dadurch kann das CMS beim Rendern die Dateiversion beziehungsweise das Änderungsdatum berücksichtigen. Nach einer Änderung kann der Browser so die aktuelle Datei laden, statt eine veraltete Cache-Version zu verwenden.

Warum ist die Startseite nach dem Layout-Import zunächst leer?

Das Layout stellt zunächst nur den Rahmen bereit. Die eigentlichen Seitenabschnitte müssen über Einfügen → Seitenabschnitt in die Seite eingefügt werden.

Kann ich einen importierten Seitenabschnitt mehrfach verwenden?

Ja. Die getrennten Section-Vorlagen können im Editor nach Bedarf eingefügt, verschoben und auch mehrfach verwendet werden.

Was mache ich, wenn relative Bild- oder Linkpfade nicht funktionieren?

Prüfe lokale href- und src-Pfade und ergänze bei Bedarf einen führenden Slash. Mit Strg + H kannst du wiederkehrende Pfade ersetzen, solltest aber externe URLs, Anker und andere Sonderpfade nicht blind verändern.

Was kann ich tun, wenn ein Text im Editor nicht bearbeitet werden kann?

Prüfe die HTML-Struktur der betreffenden Section. Liegt normaler Text beispielsweise direkt in einem div-Container, kann je nach Aufbau ein geeignetes p-Element sinnvoll sein.

Wie kann ich die Originalseite beim Nachbauen vergleichen?

Öffne die ursprüngliche index.html unter Dateien → bx_Import über die Vorschau und verwende sie als Referenz für Reihenfolge und Aufbau der Sections.

CMS