Bootstrap 5 lay-out importeren
Leer hoe je een Bootstrap-5-sjabloon onder bx_Import opsplitst in Header, Footer, flexibele sectiesjablonen en LayoutHTML, en vervolgens samenvoegt in de bluetronix-editor.
Doel van de tutorial
In deze tutorial importeer je een bestaande Bootstrap-5-lay-out in het bluetronix CMS. Je splitst de oorspronkelijke HTML-pagina in header, footer, afzonderlijke sectie-sjablonen en het eigenlijke lay-outraam. Vervolgens kun je de afzonderlijke pagina-secties vrijelijk invoegen, verplaatsen en meerdere keren gebruiken in de editor.
Opmerking: Deze tutorial behandelt de basis van lay-outimport. Verdere bewerking of vervanging van beelden wordt in een volgende tutorial behandeld.
1. Origineel sjabloon openen in bx_Import
Open in de bestandsbeheerder de map bx_Import. Daar bevindt zich de geïmporteerde lay-out aanvankelijk in de oorspronkelijke staat - bijvoorbeeld met de originele afbeeldingsmappen en HTML-bestanden. In dit gebied werk je alleen met de beschikbare origineel bestanden; wijzigingen worden niet terug opgeslagen in het originele sjabloon.
Open voor dit voorbeeld het bestand index.html en schakel over naar Bewerken. Dit bestand wordt nu opge splitsen in de afzonderlijke onderdelen van de CMS-lay-out.
Screenshot-placeholder: Bestandsbeheerder met geopende map bx_Import, afbeeldingsmappen en de originele HTML-bestanden – dev_bootstrap_import_bx_import_originalbestanden.jpeg. Maak de afbeelding nog en voeg deze vervolgens hier in.
Screenshot-placeholder: index.html uit bx_Import in de HTML-editor – dev_bootstrap_import_index_html_bewerken.jpeg. Maak de afbeelding nog en voeg deze vervolgens hier in.
2. Header uit de index.html halen
Zoek in de HTML-code met Strg + F naar header. Bij veel Bootstrap-sjablonen is de header hiermee snel te vinden omdat deze is gemarkeerd met een overeenkomstig HTML-element. Bij sommige sjablonen bestaat de header slechts uit een div sectie; in dat geval moet je de structuur nauwkeuriger controleren.
Selecteer het volledige header-gedeelte en kopieer het. Werk bij voorkeur met twee geopende vensters, zodat je kunt schakelen tussen het originele sjabloon en je CMS-project.
Screenshot-placeholder: Header-gedeelte van de index.html gevonden via de zoekfunctie en gemarkeerd voor kopiëren – dev_bootstrap_import_header_markeren.jpeg. Maak de afbeelding nog en voeg deze vervolgens hier in.
3. Header overnemen in het CMS
Ga terug naar je project, open de hoofdmap en vervolgens Header → HTML-code. Plak daar de eerder gekopieerde header-code.
Controleer vervolgens de lokale paden. Bij veel lay-outs moeten relatieve verwijzingen en afbeeldingspaden een leidende slash hebben om correct binnen de CMS-structuur te functioneren.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
Belangrijk: Gebruik Strg + H voor zoeken en vervangen, maar vervang paden niet blindelings. Controleer in het bijzonder externe URL's, ankers, mailto-links en al bestaande absolute paden.
Screenshot-placeholder: Hoofdmappen → Header → HTML-code met ingevoegd header – dev_bootstrap_import_header_html_einfuegen.jpeg. Neem de afbeelding op en verbind deze hier.
4. Footer halen en overnemen
Zoek daarna de footer in de oorspronkelijke index.html. Snijd of kopieer het volledige footer-gedeelte en voeg het in het daarvoor bestemde footer-bestand in de hoofdmappen van je project in. Controleer daar ook alle lokale href- en src-paden.
Screenshot-placeholder: Footer-bestand in de hoofdmappen met ingevoegd footer-code – dev_bootstrap_import_footer_html_einfuegen.jpeg. Neem de afbeelding op en verbind deze hier.
5. Hoofdsectie opsplitsen in afzonderlijke sectie-sjablonen
De content van de pagina die na header en footer overblijft, wordt niet rechtstreeks in de index.html van je project gekopieerd. Open in plaats daarvan bx_Layout → SectionTemplate.txt → HTML-code.
Voeg het resterende hoofdgedeelte van de originele template aan het einde van dit bestand toe. Verdeel het daarna in de afzonderlijke delen die later afzonderlijk in de editor beschikbaar moeten zijn.
Tussen twee sectie-sjablonen plaats je exact de volgende scheiding:
<!--__SP_SectionTemplate__-->
Elk daardoor gescheiden deel kan later als een eigen sjabloon in de editor worden ingevoegd. Hierdoor kun je secties vrij ordenen, meerdere keren gebruiken of op een pagina weglaten.
Screenshot-placeholder: bx_Layout → SectionTemplate.txt met meerdere secties en de scheiding <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Neem de afbeelding op en verbind deze hier.
6. Lay-outraam overnemen in 00_layout
Na het scheiden van de header, footer en hoofsecties blijft het eigenlijke HTML-raamwerk over, bijvoorbeeld met DOCTYPE, het head-gedeelte en andere bovenliggende lay-out-elementen. Kopieer deze resterende code.
Open vervolgens de databasebeheerder en bewerk de database 00_layout. Daar zijn al lay-out-sjablonen beschikbaar. Je kunt een bestaand sjabloon bewerken of een nieuwe lay-out aanmaken.
Voeg het gekopieerde raam onder LayoutHTML in. Op de oorspronkelijke posities van de header, hoofdinhoud en footer gebruik je de CMS-tags:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
Bij het renderen van de pagina worden deze tags vervangen door de respectieve header, de huidige hoofdpagina en de footer. De bijbehorende PHP-code onder LayoutPHP wordt automatisch uitgevoerd bij het laden van de lay-out.
Screenshot-placeholder: Database 00_layout met LayoutHTML en de tags voor Header, Main en Footer – dev_bootstrap_import_00_layout_layouthtml.jpeg. Neem de afbeelding op en verbind deze hier.
7. CSS-, JavaScript- en favicon-paden controleren
Controleer binnen de lay-outcode alle verwijzingen naar CSS-, JavaScript- en Favicon-bestanden. Zet bij lokale paden de benodigde leidende slash. Voor CSS- en JavaScript-bestanden gebruik je bovendien de versie-tag van het CMS.
Een JavaScript-aanroep kan er bijvoorbeeld zo uitzien:
<script src="__FV_/bx_script/core.min.js__"></script>
De markering __FV_...__ stelt het systeem in staat om de bestandsversie of wijzigingsdatum bij het renderen in overweging te nemen. Daardoor kan de browser na wijzigingen het actuele CSS- of JavaScript-bestand laden, zonder dat de gebruiker zijn browsercache handmatig hoeft bij te werken.
8. Head-inhoud opschonen en header-HTML gebruiken
Controleer het overgenomen head-gedeelte en verwijder inhoud die reeds door het CMS is ingesteld of op een andere plaats wordt geladen. Ook een vastgestelde paginatitel kun je verwijderen als deze automatisch door het systeem wordt gegenereerd.
Header-code die door de editor nodig is en niet direct onderdeel van LayoutHTML moet zijn, leg je vast onder Extras → Header-HTML. Hierdoor kan de editor de daar vastgelegde inhoud bij het bewerken van de pagina in aanmerking nemen.
Screenshot-placeholder: Extras → Header-HTML met de daarheen verplaatste header-code – dev_bootstrap_import_extras_header_html.jpeg. Neem de afbeelding op en verbind deze hier.
9. Geïmporteerde lay-out voor de pagina selecteren
Als je een nieuw lay-out in 00_layout hebt aangemaakt, open dan in de editor de Paginainstellingen en kies daar je geïmporteerde lay-out. Pas dan wordt de betreffende pagina met dit lay-out-raam weergegeven.
Screenshot-placeholder: Paginainstellingen met selectie van de nieuw geïmporteerde lay-out – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Neem de afbeelding op en verbind deze hier.
10. Startpagina samenstellen uit de geïmporteerde secties
Klik op je pagina op Bewerken. De startpagina kan aanvankelijk leeg lijken. Dat is normaal, omdat er nog geen van de nieuwe pagina-secties in de eigenlijke pagina zijn ingevoegd.
Kies Invoegen → Pagina-sectie. Daar zouden de delen moeten verschijnen die je eerder in SectionTemplate.txt met de sectiescheiding van elkaar hebt gescheiden.
Voeg de benodigde secties één voor één in en herstel hiermee de originele pagina. Je kunt de secties daarna naar wens verplaatsen, weglaten of meerdere keren invoegen.
Screenshot-placeholder: Editor → Invoegen → Pagina-sectie met de geïmporteerde sectie-sjablonen – dev_bootstrap_import_sections_einfuegen.jpeg. Neem de afbeelding op en verbind deze hier.
11. Originele pagina als referentie gebruiken
Onder Bestanden → bx_Import kun je de oorspronkelijke index.html nog steeds als preview openen. Gebruik het als referentie terwijl je je nieuwe CMS-pagina samenstelt uit de verschillende secties.
Als er aanvankelijk afbeeldingen ontbreken bij bepaalde sjablonen, wordt de correcte overname daarvan in een volgend tutorial behandeld.
12. Paden en bewerkbaarheid van alle secties controleren
Controleer uiteindelijk nogmaals Secties → Sectie Sjabloon en controleer alle lokale paden. Bij veel gelijkaardige paden kun je de wijzigingen efficiënt doorvoeren in een teksteditor met Ctrl + H.
Test daarna elke geïmporteerde sectie in de editor. Controleer of alle inhoud correct wordt weergegeven en of de bedoelde teksten en elementen bewerkbaar zijn.
Als bijvoorbeeld een tekst niet bewerkbaar is, controleer dan de HTML-structuur. Als een normale tekst direct in een div-container staat, kan het, afhankelijk van de opbouw, zinvol zijn om de tekst naar een geschikt p-element te verplaatsen.
Screenshot-placeholder: Afgewerkt samengestelde startpagina na het invoegen en ordenen van de secties – dev_bootstrap_import_afgewerkte_startpagina.jpeg. Maak de afbeelding nog en voeg deze daarna op deze plek toe.
13. Waarom de lay-out wordt opgesplitst
Door de scheiding van header, footer, lay-outkaders en individuele secties hoef je deze onderdelen bij nieuwe pagina's niet steeds opnieuw uit het oorspronkelijke Bootstrap-bestand te kopiëren.
De centrale header en footer kunnen worden hergebruikt, terwijl de individuele pagina-secties als flexibele sjablonen beschikbaar zijn in de editor. Op die manier kun je verschillende pagina's samenstellen uit een Bootstrap-sjabloon en de volgorde van de inhoud op elk moment veranderen.
Samenvatting
Voor de Bootstrap-5-import gebruik je de originele bestanden onder bx_Import als sjabloon. Header en footer worden apart in de voorziene CMS-gebieden overgenomen, het hoofdgebied wordt via SectionTemplate.txt in afzonderlijke sjablonen verdeeld en het resterende HTML-kader wordt onder 00_layout → LayoutHTML opgeslagen.
Vervolgens kies je de lay-out in de pagina-instellingen en stel je de pagina samen via Invoegen → Pagina-sectie uit de geïmporteerde secties. Controleer tenslotte alle paden, CSS- en JavaScript-verwijzingen en de bewerkbaarheid van de afzonderlijke secties.
FAQ
wat klanten ons vaak vragen
Waarom blijft het oorspronkelijke Bootstrap-sjabloon onder bx_Import behouden?
De map bx_Import dient als uitgangspunt en referentie voor het geïmporteerde originele sjabloon. De benodigde onderdelen worden daaruit in de respectieve CMS-gebieden overgenomen.
Welcher Datei gebruik ik voor de eerste import?
In deze tutorial wordt de index.html als uitgangspunt gebruikt. Hieruit worden header, footer, hoofdsecties en het resterende lay-outkader gescheiden.
Hoe vind ik snel header en footer in de HTML-code?
Gebruik Ctrl + F en zoek bijvoorbeeld naar header of footer. Bij sjablonen zonder overeenkomstige HTML-tags moet je de omringende div-structuren nauwkeuriger controleren.
Waar worden de individuele pagina-secties opgeslagen?
De sjablonen worden onder bx_Layout opgeslagen in SectionTemplate.txt en van elkaar gescheiden met de scheidingstekens <!--__SP_SectionTemplate__-->.
Welke merktekens vereist LayoutHTML?
Op de posities van de gescheiden secties gebruik je __DB_Layout_Header__, __DB_Layout_Main__ en __DB_Layout_Footer__.
Waarom worden CSS- en JavaScript-bestanden met __FV_ gemarkeerd?
Daardoor kan het CMS bij het renderen de bestandsversie of het wijzigingsdatum in overweging nemen. Na een wijziging kan de browser zo het actuele bestand laden in plaats van een verouderde cache-versie te gebruiken.
Waarom is de startpagina na de lay-out-import aanvankelijk leeg?
De lay-out biedt in eerste instantie alleen het kader. De eigenlijke pagina-secties moeten via Invoegen → Pagina-sectie in de pagina worden toegevoegd.
Kan ik een geïmporteerde pagina-sectie meerdere keren gebruiken?
Ja. De gescheiden sectiesjablonen kunnen in de editor naar behoefte worden ingevoegd, verplaatst en ook meerdere keren worden gebruikt.
Wat moet ik doen als relatieve afbeelding- of linkpaden niet werken?
Controleer lokale href- en src-paden en voeg indien nodig een voorloop-slash toe. Met Ctrl + H kun je terugkerende paden vervangen, maar je moet externe URL's, ankers en andere speciale paden niet blindelings aanpassen.
Wat kan ik doen als een tekst in de editor niet kan worden bewerkt?
Controleer de HTML-structuur van de betreffende sectie. Als gewone tekst bijvoorbeeld direct in een div-container staat, kan het afhankelijk van de opbouw nuttig zijn om een geschikt p-element te gebruiken.
Hoe kan ik de originele pagina vergelijken tijdens het nabouwen?
Open de oorspronkelijke index.html onder Bestanden → bx_Import via de preview en gebruik deze als referentie voor volgorde en opbouw van de secties.