Udviklervisning og systemområder i bluetronix CMS

Yderligere funktioner med udvikleradgang

Med en udvikleradgang har du adgang til ekstra funktioner i bluetronix CMS, som ikke er synlige i den normale brugergrænseflade.

Dette inkluderer ekstra udviklermapper i filhåndteringen, adgangen til PHP-koden fra sider, ekstra udvikler-databaser, samt systemskripter, layoutskabeloner og moduler.

Rediger PHP-kode fra sider

I den normale CMS-visning kan du redigere HTML-koden for en side. Med udvikleradgang har du desuden adgang til knappen PHP-kode.

Med dette kan du tilføje din egen PHP-kode til en CMS-side, f.eks. til databaserelaterede forespørgsler, dynamisk indhold, udskiftninger inden for $LayoutHTML, CMS-funktioner eller egne PHP-funktioner.

Yderligere databasetabeller

Med en udvikleradgang vises ekstra systemtabeller i databaseadministrationen. Dette inkluderer f.eks. tabeller til layouts, sidestyring, systemkonfigurationer og andre interne CMS-funktioner.

Disse udvikler- og systemtabeller er markeret med rød farve inde i databaseadministrationen.

Strukturen af de rødt markerede udvikler-databaser må ikke ændres. Du må ikke slette, tilføje eller omdøbe kolonner, ændre datatyper eller justere systemstrukturer. Disse tabeller kan blive opdateret eller erstattet ved et systemopdatering.

Udviklermapper i filhåndteringen

Med udvikleradgang bliver ekstra systemmapper synlige i filhåndteringen. Disse udviklermapper vises med rød farve og starter generelt med bx_.

De vigtigste mapper inkluderer bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script og bx_style.

bx_doc

I mappen bx_doc findes forudinstallerede eksempel-filer og dokumenter. Dette kan f.eks. inkludere PDF-dokumenter, der anvendes inden for eksempel-sider eller skabeloner.

bx_fonts

I mappen bx_fonts findes de skrifttyper, der stilles til rådighed eller installeres af bluetronix CMS. Disse skrifttyper kan anvendes i de forskellige designs og layouts af CMS.

bx_Img

Mappen bx_Img indeholder standardbillederne fra det aktuelt anvendte tema- eller tema-billede-sæt.

Som udvikler kan du vælge et andet tema-billede-sæt. De forskellige tema-billede-sæt bruger de samme definerede filnavne og fungerer derfor som en ensartet skabelon. HTML-strukturen skal ikke ændres, når tema-billede-sættet skiftes.

bx_Import

Mappen bx_Import bruges til at importere eksterne websider. For eksempel kan Bootstrap-5-websider forberedes til import og placeres inden for dette område. Filene analyseres derefter og overføres til strukturen af bluetronix CMS.

bx_Layout

I mappen bx_Layout findes siderne og sektionerne skabeloner for CMS. Disse skabeloner er derefter tilgængelige for brugeren, f.eks. via Indsæt → Sideafsnit.

Som udvikler kan du oprette dine egne skabeloner til hero-sektioner, tekstområder, produktområder, kontaktområder, teaser-elementer og andre individuelle sektioner. Den endelige bruger kan derefter indsætte disse elementer via den almindelige editor, uden at skulle programmere HTML selv.

bx_script

I mappen bx_script findes de JavaScript-filer, der stilles til rådighed af bluetronix CMS. Dette inkluderer blandt andet BxHeadScript.js og BxScript.js.

Afhængigt af de aktiverede sprog kan der desuden genereres sprogafhængige versioner, f.eks. BxScript_en.js, BxScript_de.js eller BxScript_fr.js.

Inde i script-mappen findes der desuden et kilde-katalog. Der ligger individuelle kildefiler eller komponenter, der bruges til at generere de senere anvendte hovedfiler.

bx_style

Tilsvarende til bx_Script indeholder bx_style de centrale styles af bluetronix CMS. Herfra genereres blandt andet de stylesheets, der anvendes af systemet. Der kan også være kildefiler, fra hvilke de endelige CSS-filer sammensættes.

Systemmapper og opdateringer

Rødt markerede bx_-systemmapper tilhører bluetronix CMS og kan blive overskrevet helt eller delvist ved et systemopdatering. Egen ændringer må derfor ikke gemmes direkte i de normale systemfiler.

Egne filer inden for systemområderne skal mærkes med _own. Denne mærkning signalerer til bluetronix CMS, at det er en egen projektspecifik fil.

Eksempler inkluderer config_own.php, MyScript_own.js, MyStyle_own.css eller MyTemplate_own.txt. Filendelsen spiller ikke en rolle. Det afgørende er mærkningen _own i filnavnet.

Egne tilpasninger skal derfor altid oprettes som _own-filer inden for de røde systemmapper. Dette sikrer, at disse egne filer stadig er tilstede efter en opdatering af bluetronix CMS.

Ændre ikke systemfiler direkte

En eksisterende systemfil bør du derfor ikke redigere direkte. Brug den om nødvendigt som skabelon, kopier den, marker kopien med _own og foretag dine egne tilpasninger i denne fil.

bx_Mod

I mappen bx_Mod findes modulene af bluetronix CMS. Dette kan blandt andet inkludere blog, shop, søgning, login og andre CMS-moduler.

Et modul kan indeholde forskellige filer og områder, såsom konfigurationer, lister, detailvisninger, PHP-scripts og andre modulfiler.

Tilpas modul filer

Også for modulfiler gælder det: Den originale systemfil må ikke ændres direkte. Du kan vise, læse, bruge den som grundlag og kopiere den. For en egen version opretter du derefter en kopi med _own og foretager dine ændringer der.

De vigtigste regler for udviklere

1. Red-markerede databord må ikke ændres strukturelt.
2. Red-markerede bx_-systemmapper kan blive overskrevet ved opdateringer.
3. Systemfiler må ikke ændres direkte for egne tilpasninger.
4. Egen filer inden for systemområder skal altid mærkes med _own.
5. Systemfiler kan læses og kopieres som skabelon.
6. Egen tilpasninger skal derefter foretages inden for _own-filen.

Sammendrag

Udvikleradgangen udvider bluetronix CMS med ekstra funktioner og systemområder som PHP-kode, udvikler-database-tabeller, bx_-systemmapper, moduler, scripts, stilarter og layoutskabeloner.

Det er særligt vigtigt at adskille systemfiler og egne udvidelser. Du bruger originale systemfiler som skabelon, og egne tilpasninger lagres som _own-fil.