Utviklervisning og systemområder i bluetronix CMS

Ekstra funksjoner med utviklertilgang

Med en utviklertilgang har du tilgang til ekstra funksjoner i bluetronix CMS som ikke er synlige i den normale brukergrensesnittet.

Dette inkluderer ekstra utviklermapper i filbehandlingen, tilgang til PHP-koden på sider, ekstra utvikler-database-tabeller samt systemskript, layoutmaler og moduler.

Rediger PHP-kode fra sider

I den normale CMS-visningen kan du redigere HTML-koden på en side. Med utviklerlegitimasjon er også knappen PHP-kode tilgjengelig.

Med dette kan du legge inn egen PHP-kode til en CMS-side, for eksempel for databaseforespørsel, dynamisk innhold, erstatninger i $LayoutHTML, CMS-funksjoner eller egne PHP-funksjoner.

Ekstra databastabeller

Med utviklerlegitimasjon vises ekstra systemtabeller i databaseadministrasjonen. Dette inkluderer for eksempel tabeller for layouter, sideadministrasjon, systemkonfigurasjoner og andre interne CMS-funksjoner.

Disse utvikler- og systemtabellene markeres rødt i databaseadministrasjonen.

Strukturen til de rødt merkede utvikler-database-tabellene må ikke endres. Du kan ikke slette, legge til eller omdøpe kolonner, endre datatyper eller justere systemstrukturer. Disse tabellene kan bli oppdatert eller erstattet ved en systemoppdatering.

Utviklermapper i filbehandling

Med utviklerlegitimasjon blir ekstra systemmapper synlige i filbehandlingen. Disse utviklermappene er merket med rødt og begynner stort sett med bx_.

De viktigste mappene inkluderer bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script og bx_style.

bx_doc

I mappen bx_doc finnes forhåndsinstallerte eksempelfiler og dokumenter. Dette kan for eksempel inkludere PDF-dokumenter som brukes i eksempel-sider eller maler.

bx_fonts

I mappen bx_fonts befinner de skrifttypene seg som tilbys eller er installert av bluetronix CMS. Disse fontene kan brukes i de forskjellige designene og layoutene til CMS.

bx_Img

Mappen bx_Img inneholder standardbildene fra det nåværende temabildesettet.

Som utvikler kan du velge et annet temabildesett. De forskjellige temabildesettene bruker de samme definerte filnavnene og fungerer derfor som en enhetlig mal. HTML-strukturen trenger ikke å endres når du bytter temabildesett.

bx_Import

Mappen bx_Import brukes for import av eksterne nettsider. For eksempel kan Bootstrap-5-nettsider forberedes for import og plasseres i dette området. Filene blir deretter analysert og integrert i strukturen til bluetronix CMS.

bx_Layout

I mappen bx_Layout finnes sidelayout- og seksjonsmaler for CMS. Disse malene er straks tilgjengelige for brukeren, for eksempel via Sett inn → Seksjon.

Som utvikler kan du lage egne maler for hero-seksjoner, tekstområder, produktområder, kontaktområder, teaser-elementer og andre individuelle sideelementer. Sluttbrukeren kan deretter sette inn disse elementene via den normale editoren, uten å måtte programmere HTML selv.

bx_script

I mappen bx_script finnes JavaScript-filer tilveiebrakt av bluetronix CMS. Dette inkluderer blant annet BxHeadScript.js og BxScript.js.

Avhengig av de aktiverte språkene kan også språkspecifikke versjoner genereres, for eksempel BxScript_en.js, BxScript_de.js eller BxScript_fr.js.

Innenfor script-mappen finnes det også en kilde-katalog. Der ligger individuelle kildefiler eller komponenter som hovedfilene senere blir laget av.

bx_style

Analog til bx_Script inneholder bx_style de sentrale stilene til bluetronix CMS. Herfra genereres også de stilarkfilene som systemet bruker. Det kan også være kildefiler her som brukes til å sette sammen de endelige CSS-filene.

Systemmapper og oppdateringer

Rødt merkede bx_-systemmapper tilhører bluetronix CMS og kan bli helt eller delvis overskrevet ved en systemoppdatering. Egen endringer må derfor ikke lagres direkte i de normale systemfilene.

Egne filer innen systemområdene må merkes med _own. Denne merkingen signaliserer til bluetronix CMS at dette er en egen prosjektspecifik fil.

Eksempler inkluderer config_own.php, MyScript_own.js, MyStyle_own.css eller MyTemplate_own.txt. Filendelsen spiller i prinsippet ingen rolle. Det er merkingen _own i filnavnet som er avgjørende.

Egne tilpasninger bør derfor alltid opprettes som _own-fil i de røde systemmappene. Dette gjør at disse egne filene forblir bevart selv ved en oppdatering av bluetronix CMS.

Ikke endre systemfiler direkte

En eksisterende systemfil bør du derfor ikke redigere direkte. Bruk den ved behov som mal, kopier den, merk kopien med _own og utfør deretter dine egne tilpasninger i denne filen.

bx_Mod

I mappen bx_Mod finnes modulene til bluetronix CMS. Dette kan blant annet inkludere blogg, butikk, søk, innlogging og andre CMS-moduler.

Et modul kan inneholde ulike filer og områder, for eksempel konfigurasjoner, lister, detaljerte visninger, PHP-skript og andre modulfiler.

Tilpass modulfiler

Også for modulfilene gjelder det at den originale systemfilen ikke bør endres direkte. Du kan vise den, lese den, bruke den som grunnlag og kopiere den. For en egen versjon oppretter du deretter en kopi med _own og gjør endringene dine der.

De viktigste reglene for utviklere

1. Rødt merkede databasetabeller skal ikke endres strukturmessig.
2. Rødt merkede bx_-systemmapper kan bli overskrevet ved oppdateringer.
3. Systemfiler skal ikke endres direkte for egne tilpasninger.
4. Egne filer innen systemområdene skal alltid merkes med _own.
5. Systemfiler kan leses og kopieres som mal.
6. Egne tilpasninger skal deretter utføres innen _own-filen.

Sammendrag

Utviklertilgangen utvider bluetronix CMS med ekstra funksjoner og systemområder som PHP-kode, utvikler-databasetabeller, bx_-systemmapper, moduler, skript, stiler og layoutmaler.

Det er spesielt viktig å skille mellom systemfiler og egne utvidelser. Du bruker originale systemfiler som mal, egne tilpasninger oppretter du som _own-fil.