Ontwikkelaarsweergave en systeemgebieden in het bluetronix CMS
Met een ontwikkelaarsaccount krijg je toegang tot extra functies, systeemap, databasetabellen en brongebieden van het bluetronix CMS. In deze handleiding leer je welke gebieden beschikbaar zijn en hoe je je eigen uitbreidingen updatebaar van de systeembestanden scheidt.
Extra functies met ontwikkelaarsaccount
Met een ontwikkelaarsaccount heb je in het bluetronix CMS toegang tot extra functies die niet zichtbaar zijn in de normale gebruikersweergave.
Hieronder vallen extra ontwikkelaarsmappen in het bestandsbeheer, toegang tot de PHP-code van pagina's, extra ontwikkelaars-databasetabellen, evenals systeemscripts, lay-outsjablonen en modules.
PHP-code van pagina's bewerken
In de normale CMS-weergave kun je de HTML-code van een pagina bewerken. Met ontwikkelaars toegang heb je ook de knop PHP Code tot je beschikking.
Hiermee kun je eigen PHP-code toevoegen aan een CMS-pagina, bijvoorbeeld voor databasequery's, dynamische inhoud, vervangingen binnen $LayoutHTML, CMS-functies of eigen PHP-functies.
Extra databasetabellen
Met een ontwikkelaars toegang worden in het databasemanagement extra systeemtabelen weergegeven. Dit omvat bijvoorbeeld tabellen voor lay-outs, pagina-beheer, systeemconfiguraties en andere interne CMS-functies.
Deze ontwikkelaars- en systeemtabellen worden binnen het databasemanagement in het rood gemarkeerd.
De structuur van de rood gemarkeerde ontwikkelaars-databasetabellen mag niet worden veranderd. Je mag daar geen kolommen verwijderen, toevoegen of hernoemen, geen datatypes wijzigen en geen systeemstructuren aanpassen. Deze tabellen kunnen tijdens een systeemupdate worden bijgewerkt of vervangen.
Ontwikkelaarsmappen in het bestandbeheer
Met ontwikkelaars toegang worden extra systeemmappen binnen het bestandsbeheer zichtbaar. Deze ontwikkelaarsmappen worden rood weergegeven en beginnen doorgaans met bx_.
Tot de belangrijkste mappen behoren bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script en bx_style.
bx_doc
In de map bx_doc bevinden zich vooraf geïnstalleerde voorbeelden en documenten. Dit kunnen bijvoorbeeld PDF-documenten zijn die binnen voorbeeldpagina's of sjablonen worden gebruikt.
bx_fonts
In de map bx_fonts bevinden zich de lettertypen die door het bluetronix CMS worden geleverd of geïnstalleerd. Deze lettertypen kunnen binnen de verschillende ontwerpen en lay-outs van het CMS worden gebruikt.
bx_Img
De map bx_Img bevat de standaardafbeeldingen van de momenteel gebruikte thema- of themaafbeeldingsets.
Als ontwikkelaar kun je een andere themaafbeeldingset selecteren. De verschillende themaafbeeldingsets gebruiken dezelfde gedefinieerde bestandsnamen en functioneren daardoor als een uniforme sjabloon. De HTML-structuur hoeft niet te worden gewijzigd bij het wisselen van een themaafbeeldingset.
bx_Import
De map bx_Import wordt gebruikt voor het importeren van externe websites. Bijvoorbeeld Bootstrap-5-websites kunnen worden voorbereid voor import en binnen dit gebied worden opgeslagen. De bestanden worden vervolgens geanalyseerd en opgenomen in de structuur van het bluetronix CMS.
bx_Layout
In de map bx_Layout bevinden zich de pagina- en sectiesjablonen van het CMS. Deze sjablonen zijn vervolgens beschikbaar voor de gebruiker, bijvoorbeeld via Invoegen → Pagina-sectie.
Als ontwikkelaar kun je eigen sjablonen voor hero-secties, tekstgebieden, productgebieden, contactgebieden, teaser-elementen en andere individuele pagina-secties maken. De eindgebruiker kan deze elementen vervolgens via de normale editor invoegen, zonder zelf HTML te hoeven programmeren.
bx_script
In de map bx_script bevinden zich de JavaScript-bestanden die door het bluetronix CMS worden geleverd. Dit omvat onder andere BxHeadScript.js en BxScript.js.
Afhankelijk van de geactiveerde talen kunnen daarnaast taalspecifieke versies worden aangemaakt, bijvoorbeeld BxScript_en.js, BxScript_de.js of BxScript_fr.js.
Binnen de scriptmap bevindt zich ook een bronverzeichnis. Daar liggen afzonderlijke bronbestanden of componenten waaruit de later gebruikte hoofdbestanden worden gegenereerd.
bx_style
Analog aan bx_Script bevat bx_style de centrale stijlen van het bluetronix CMS. Hieruit worden onder andere de door het systeem gebruikte stylesheet-bestanden gegenereerd. Ook hier kunnen bronbestanden aanwezig zijn, waaruit de definitieve CSS-bestanden worden samengesteld.
Systeemmappen en updates
Rood gemarkeerde bx_-systeemmappen behoren tot het bluetronix CMS en kunnen tijdens een systeemupdate volledig of gedeeltelijk worden overschreven. Eigen wijzigingen mogen daarom niet rechtstreeks in de normale systeembestanden worden opgeslagen.
Eigen bestanden binnen de systeemgebieden moeten worden gemarkeerd met _own. Deze markering signaliseert het bluetronix CMS dat het gaat om een eigen project-specifiek bestand.
Voorbeelden zijn config_own.php, MyScript_own.js, MyStyle_own.css of MyTemplate_own.txt. De bestandsextensie speelt in principe geen rol. Beslissend is de markering _own in de bestandsnaam.
Eigen aanpassingen daarom altijd binnen de rode systeemmappen als _own-bestand aanmaken. Hierdoor blijven deze eigen bestanden ook bij een update van het bluetronix CMS behouden.
Systeembestanden niet direct wijzigen
Een bestaande systeembestand moet je dus niet rechtstreeks bewerken. Gebruik deze indien nodig als sjabloon, kopieer deze, markeer de kopie met _own en voer daarna je eigen aanpassingen in dit bestand uit.
bx_Mod
In de map bx_Mod bevinden zich de modules van het bluetronix CMS. Dit kunnen bijvoorbeeld Blog, Shop, Zoekfunctie, Inloggen en andere CMS-modules zijn.
Een module kan verschillende bestanden en gebieden bevatten, zoals configuraties, lijsten, detailweergaven, PHP-scripts en andere modulebestanden.
Modulebestanden aanpassen
Ook voor modulebestanden geldt: het originele systeembestand mag niet direct gewijzigd worden. Je kunt het bekijken, lezen, als basis gebruiken en kopiëren. Voor een eigen versie maak je vervolgens een kopie met _own aan en breng je je wijzigingen daar aan.
De belangrijkste regels voor ontwikkelaars
1. Rood gemarkeerde databastabellen niet structureel wijzigen.
2. Rood gemarkeerde bx_-systeemmappen kunnen bij updates overschreven worden.
3. Systeembestanden niet direct voor eigen aanpassingen wijzigen.
4. Eigen bestanden binnen de systeemgebieden altijd met _own markeren.
5. Systeembestanden kunnen als sjabloon worden gelezen en gekopieerd.
6. Eigen aanpassingen vervolgens binnen het _own-bestand uitvoeren.
Samenvatting
De ontwikkelaars toegang breidt het bluetronix CMS uit met extra functies en systeemgebieden zoals PHP-code, ontwikkelaars-databastabellen, bx_-systeemmappen, modules, scripts, stijlen en lay-outsjablonen.
Bijzonder belangrijk is de scheiding tussen systeembestanden en eigen uitbreidingen. Originele systeembestanden gebruik je als sjabloon, eigen aanpassingen maak je aan als _own-bestand.
FAQ
wat klanten ons vaak vragen
Welke extra functies krijg ik met een ontwikkelaars toegang?
Je krijgt onder andere toegang tot extra ontwikkelaarsmappen, de PHP-code van pagina's, extra systeemtabellen evenals systeemscripts, lay-outsjablonen en modules.
Waar kan ik eigen PHP-code voor een pagina achterlaten?
Met ontwikkelaars toegang is er op een CMS-pagina ook de knop PHP Code beschikbaar.
Mag ik rood gemarkeerde databastabellen structureel wijzigen?
De structuur van deze ontwikkelaars- en systeemtabellen mag niet worden gewijzigd. Je zou daar geen kolommen moeten verwijderen, toevoegen of hernoemen en geen datatypen of systeemstructuren aanpassen.
Hoe herken ik de ontwikkelaarsmappen?
De ontwikkelaarsmappen worden in het bestandbeheer rood weergegeven en beginnen over het algemeen met bx_.
Wat is de functie van bx_Layout?
In bx_Layout bevinden zich pagina- en sectiesjablonen van het CMS. Als ontwikkelaar kun je daar eigen sjablonen aanbieden, die de eindklant later kan kiezen via Invoegen → Pagina-sectie.
Waarom zou ik systeembestanden niet direct wijzigen?
Systeembestanden en systeemmappen kunnen bij een update van het bluetronix CMS worden overschreven. Directe wijzigingen kunnen daardoor verloren gaan.
Hoe maak ik eigen bestanden updatebaar aan?
Eigen bestanden binnen de systeemgebieden markeer je in de bestandsnaam met _own, bijvoorbeeld MyScript_own.js of MyStyle_own.css.
Kan ik bestaande systeembestanden als sjabloon gebruiken?
Ja. Je kunt een systeembestand bekijken en als basis gebruiken. Voor eigen aanpassingen moet je het kopiëren, de kopie met _own markeren en vervolgens alleen dit eigen bestand bewerken.