Utvecklarvy och systemområden i bluetronix CMS

Ytterligare funktioner med utvecklaråtkomst

Med ett utvecklaråtkomst har du tillgång till ytterligare funktioner i bluetronix CMS som inte syns i den vanliga användarvyn.

Detta inkluderar ytterligare utvecklarmappar i filhanteringen, åtkomst till PHP-koden för sidor, ytterligare utvecklar-databasbord och systemskript, layoutmallar och moduler.

Redigera PHP-kod för sidor

I den vanliga CMS-vyn kan du redigera HTML-koden för en sida. Med utvecklaråtkomst har du också tillgång till knappen PHP-kod.

Med den här funktionen kan du lägga till egen PHP-kod till en CMS-sida, till exempel för databasfrågor, dynamiskt innehåll, ersättningar inom $LayoutHTML, CMS-funktioner eller egna PHP-funktioner.

Ytterligare databas-tabeller

Med utvecklaråtkomst visas ytterligare systemtabeller i databasadministrationen. Detta inkluderar till exempel tabeller för layouter, sidadministration, systemkonfigurationer och andra interna CMS-funktioner.

Dessa utvecklar- och systemtabeller markeras i rött i databasadministrationen.

Strukturen för de rödmarkerade utvecklar-databastabellerna får inte ändras. Du får inte ta bort, lägga till eller byta namn på kolumner, ändra datatyper eller justera systemstrukturer. Dessa tabeller kan uppdateras eller ersättas vid en systemuppdatering.

Utvecklarmappar i filhanteringen

Med utvecklaråtkomst blir ytterligare systemmappar synliga i filhanteringen. Dessa utvecklarmappar visas i rött och börjar alltid med bx_.

De viktigaste mapparna inkluderar bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script och bx_style.

bx_doc

I mappen bx_doc finns förinstallerade exempel filer och dokument. Detta kan till exempel inkludera PDF-dokument som används inom exempel sidor eller mallar.

bx_fonts

I mappen bx_fonts finns de typsnitt som tillhandahålls eller installeras av bluetronix CMS. Dessa typsnitt kan användas inom olika designer och layouter i CMS.

bx_Img

Mappen bx_Img innehåller standardbilderna från det aktuellt använda tema- eller temabildssetet.

Som utvecklare kan du välja ett annat temabildsset. De olika temabildsseten använder samma definierade filnamn och fungerar därmed som en enhetlig mall. HTML-strukturen behöver inte ändras vid byte av temabildsset.

bx_Import

Mappen bx_Import används för att importera externa webbplatser. Till exempel kan Bootstrap-5-webbplatser förberedas för import och placeras inom detta område. Filerna analyseras sedan och integreras i strukturen av bluetronix CMS.

bx_Layout

I mappen bx_Layout finns sidor- och avsnittsmallar för CMS. Dessa mallar är sedan tillgängliga för användaren, till exempel via Infoga → Sektionsavsnitt.

Som utvecklare kan du skapa egna mallar för hero-sektioner, textområden, produktområden, kontaktområden, teaser-element och andra individuella sidorsektioner. Slutanvändaren kan sedan infoga dessa element via den vanliga redigeraren utan att behöva programmera HTML.

bx_script

I mappen bx_script finns JavaScript-filer som tillhandahålls av bluetronix CMS. Dessa inkluderar bland annat BxHeadScript.js och BxScript.js.

Beroende på aktiverade språk kan även språkspecifika versioner skapas, till exempel BxScript_en.js, BxScript_de.js eller BxScript_fr.js.

Inom script-mappen finns dessutom ett källverzeichnis. Där ligger enskilda källfiler eller komponenter, från vilka de senare använda huvudfilerna skapas.

bx_style

Analogt med bx_Script innehåller bx_style de centrala stilarna för bluetronix CMS. Utifrån dessa skapas bland annat de stylesheets som används av systemet. Det kan också finnas källfiler här, från vilka de slutliga CSS-filerna sätts ihop.

Systemmappar och uppdateringar

Rödmarkerade bx_-systemmappar tillhör bluetronix CMS och kan vid systemuppdateringar helt eller delvis överskrivas. Egna ändringar får därför inte sparas direkt i de vanliga systemfilerna.

Egna filer inom systemområden måste märkas med _own. Denna märkning signalerar till bluetronix CMS att det handlar om en egen projektspecifik fil.

Exempel är config_own.php, MyScript_own.js, MyStyle_own.css eller MyTemplate_own.txt. Filändelsen spelar ingen roll. Det avgörande är märkningen _own i filnamnet.

Egen anpassning bör alltid göras inom de röda systemmapparna som en _own-fil. Detta gör att dessa egna filer förblir kvar även vid en uppdatering av bluetronix CMS.

Ändra inte systemfiler direkt

En befintlig systemfil bör du alltså inte redigera direkt. Använd den vid behov som mall, kopiera den, märk kopian med _own och gör dina egna anpassningar i den filen.

bx_Mod

I mappen bx_Mod finns modulerna för bluetronix CMS. Detta kan till exempel inkludera blogg, butik, sökning, inloggning och ytterligare CMS-moduler.

Ett modul kan innehålla olika filer och områden, till exempel konfigurationer, listor, detaljvyer, PHP-skript och andra modulfiler.

Justera modulfiler

Även för modulfiler gäller: Den ursprungliga systemfilen bör inte ändras direkt. Du kan visa, läsa, använda den som grund och kopiera den. För en egen version skapar du en kopia med _own och gör dina ändringar där.

De viktigaste reglerna för utvecklare

1. Ändra inte strukturen på de rödmarkerade databas-tabellerna.
2. Rödmarkerade bx_-systemmappar kan skrivas över vid uppdateringar.
3. Systemfiler ska inte ändras direkt för egna anpassningar.
4. Egna filer inom systemområdena bör alltid märkas med _own.
5. Systemfiler kan läsas och kopieras som mallar.
6. Egna anpassningar görs sedan inom _own-filen.

Sammanfattning

Utvecklaråtkomsten utökar bluetronix CMS med ytterligare funktioner och systemområden såsom PHP-kod, utvecklar-databas-tabeller, bx_-systemmappar, moduler, skript, stilar och layoutmallar.

Det är särskilt viktigt att separera systemfiler och egna utvidgningar. Du använder de ursprungliga systemfilerna som mall och lägger upp egna anpassningar som _own-fil.