Pohľad pre vývojárov a systémové oblasti v bluetronix CMS
S prístupom pre vývojárov získaš prístup k ďalším funkciám, systémovým priečinkom, databázovým tabuľkám a zdrojovým oblastiam bluetronix CMS. V tomto návode sa dozvieš, ktoré oblasti sú k dispozícii a ako oddeľuješ vlastné rozšírenia od systémových súborov.
Ďalšie funkcie s prístupom pre vývojárov
S prístupom pre vývojárov sú ti v bluetronix CMS k dispozícii ďalšie funkcie, ktoré nie sú viditeľné v normálnom pohľade pre používateľov.
Patria sem aj ďalšie vývojárske priečinky v správe súborov, prístup k PHP kódu stránok, ďalšie vývojárske databázové tabuľky, ako aj systémové skripty, šablóny rozloženia a moduly.
Upraviť PHP kód stránok
V normálnom zobrazení CMS môžeš upravovať HTML kód stránky. S prístupom pre vývojára máš navyše k dispozícii tlačidlo PHP kód.

Týmto môžeš na stránku CMS pridať vlastný PHP kód, napríklad na databázové dotazy, dynamický obsah, nahradenia v rámci $LayoutHTML, funkcie CMS alebo vlastné PHP funkcie.
Ďalšie databázové tabuľky
S prístupom pre vývojára sa v správe databáz zobrazia ďalšie systémové tabuľky. Sem patrí napríklad tabuľky pre rozloženia, správu stránok, systémové konfigurácie a ďalšie interné funkcie CMS.
Tieto vývojárske a systémové tabuľky sú v správe databáz označené červenou farbou.

Štruktúra červenou farbou označených vývojárskych databázových tabuliek sa nesmie meniť. Nie je povolené mazať, pridávať ani premenovávať stĺpce, meniť dátové typy a prispôsobovať systémové štruktúry. Tieto tabuľky môžu byť aktualizované alebo nahradené počas systému.
Priečinky pre vývojárov v správe súborov
S prístupom pre vývojára sú v správe súborov viditeľné ďalšie systémové priečinky. Tieto vývojárske priečinky sú zobrazené červenou farbou a spravidla začínajú s bx_.
Medzi najdôležitejšie priečinky patrí bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script a bx_style.

bx_doc
V priečinku bx_doc sa nachádzajú predinštalované ukážkové súbory a dokumenty. Sem môžu patriť napríklad PDF dokumenty, ktoré sa používajú v rámci ukážkových stránok alebo šablón.

bx_fonts
V priečinku bx_fonts sú písma poskytnuté alebo nainštalované bluetronix CMS. Tieto písma môžu byť použité v rôznych dizajnoch a rozloženiach CMS.

bx_Img
Priečinok bx_Img obsahuje štandardné obrázky aktuálne používaného súboru tém alebo tematických obrázkov.
Ako vývojár môžeš zvoliť iný súbor tematických obrázkov. Rôzne tematické obrázkové sady používajú rovnaké definované názvy súborov, a preto fungujú ako jednotná šablóna. HTML štruktúra sa pri zmene tematického obrázkového súboru nemusí meniť.

bx_Import
Priečinok bx_Import sa používa na import externých webových stránok. Napríklad stránky Bootstrap 5 môžu byť pripravené na import a uložené v tejto oblasti. Súbory sú potom analyzované a prevzaté do štruktúry bluetronix CMS.
bx_Layout
V priečinku bx_Layout sa nachádzajú šablóny stránok a sekcií CMS. Tieto šablóny sú používateľovi následne k dispozícii napríklad prostredníctvom Vložiť → Sekcia stránky.
Ako vývojár môžeš vytvárať vlastné šablóny pre hero sekcie, textové oblasti, produktové oblasti, kontaktné oblasti, teaserové prvky a ďalšie individuálne sekcie stránok. Koncový zákazník môže tieto prvky neskôr vložiť prostredníctvom bežného editora bez toho, aby musel programovať HTML.

bx_script
V priečinku bx_script sa nachádzajú JavaScript súbory poskytnuté bluetronix CMS. Sem patrí mimo iného BxHeadScript.js a BxScript.js.
V závislosti od aktivovaných jazykov môžu byť vytvorené aj jazykovo závislé verzie, napríklad BxScript_en.js, BxScript_de.js alebo BxScript_fr.js.
V rámci priečinka skriptu sa nachádza aj zdrojový adresár. Tam sú jednotlivé zdrojové súbory alebo komponenty, z ktorých sú vytvorené neskôr používané hlavné súbory.

bx_style
Podobne ako bx_Script obsahuje bx_style centrálné štýly bluetronix CMS. Z nich sa vytvárajú aj štýlové súbory používané systémom. Aj tu môžu byť prítomné zdrojové súbory, z ktorých sú zostavené konečné CSS súbory.

Systémové priečinky a aktualizácie
Červenou farbou označené bx_-systémové priečinky patrí k bluetronix CMS a môžu byť počas systému úplne alebo čiastočne prepísané. Vlastné zmeny by preto nemali byť priamo uložené v bežných systémových súboroch.
Vlastné súbory v rámci systémových oblastí musia byť označené _own. Toto označenie signalizuje bluetronix CMS, že ide o vlastný projektovo špecifický súbor.
Príklady sú config_own.php, MyScript_own.js, MyStyle_own.css alebo MyTemplate_own.txt. Rozšírenie súboru princípovo nehrá žiadnu rolu. Rozhodujúce je označenie _own v názve súboru.
Vlastné úpravy by sa preto mali v rámci červených systémových priečinkov vždy vytvárať ako _own súbor. Týmto spôsobom ostanú tieto vlastné súbory aj počas aktualizácie bluetronix CMS zachované.
Nemeň systémové súbory priamo
Existujúci systémový súbor by si teda nemal priamo upravovať. Použi ho v prípade potreby ako šablónu, skopíruj ho, označ kópiu ako _own a vykonaj svoje vlastné úpravy následne v tomto súbore.
bx_Mod
V priečinku bx_Mod sa nachádzajú moduly bluetronix CMS. Sem môžu patriť napríklad blog, obchod, vyhľadávanie, prihlásenie a ďalšie moduly CMS.
Modul môže obsahovať rôzne súbory a oblasti, napríklad konfigurácie, zoznamy, detailné pohľady, PHP skripty a ďalšie súbory modulu.

Prispôsobenie súborov modulu
Rovnako platí aj pre súbory modulu: Originálny systémový súbor by nemal byť priamo menený. Môžeš ho zobraziť, prečítať, použiť ako základ a skopírovať. Pre vlastnú verziu si potom vytvoríš kópiu s _own a vykonáš tam svoje zmeny.
Najdôležitejšie pravidlá pre vývojárov
1. Červené označené databázové tabuľky nemôžu byť štrukturálne menené.
2. Červené označené bx_-systémové priečinky môžu byť pri aktualizáciách prepisované.
3. Systémové súbory by sa nemali priamo meniť pre vlastné úpravy.
4. Vlastné súbory v rámci systémových oblastí vždy označuj s _own.
5. Systémové súbory môžu byť použité ako šablóna na prečítanie a skopírovanie.
6. Vlastné úpravy potom vykonaj vo _own-súbore.
Zhrnutie
Prístup pre vývojárov rozširuje bluetronix CMS o dodatočné funkcie a systémové oblasti ako PHP kód, databázové tabuľky pre vývojárov, bx_-systémové priečinky, moduly, skripty, štýly a šablóny rozloženia.
Obzvlášť dôležité je oddeliť systémové súbory od vlastných rozšírení. Originálne systémové súbory používaš ako šablónu, vlastné úpravy si vytváraš ako _own-súbor.
Často kladené otázky
čo sa nás zákazníci často pýtajú
Aké dodatočné funkcie získam s prístupom pre vývojárov?
Získaš prístup k dodatočným priečinkom pre vývojárov, PHP kódu stránok, dodatočným systémovým tabuľkám a systémovým skriptom, šablónam rozloženia a modulom.
Kde môžem uložiť svoj vlastný PHP kód pre stránku?
S prístupom pre vývojárov máš na stránkach CMS k dispozícii aj tlačidlo PHP Kód.
Môžem štrukturálne meniť červené označené databázové tabuľky?
Štruktúra týchto tabuliek pre vývojárov a systémových tabuliek nemôže byť menená. Nemal by si tam odstrániť, pridať alebo premenovávať stĺpce a prispôsobovať typy údajov alebo systémové štruktúry.
Ako rozpoznám priečky pre vývojárov?
Priečky pre vývojárov sú v správe súborov zobrazené červenou farbou a zvyčajne začínajú s bx_.
Akú úlohu má bx_Layout?
V bx_Layout sa nachádzajú šablóny stránok a sekcií CMS. Ako vývojár môžeš tam poskytnúť vlastné šablóny, ktoré koncový zákazník neskôr môže vybrať pomocou Vložiť → Sekcia stránky.
Prečo by som nemal priamo meniť systémové súbory?
Systémové súbory a systémové priečinky môžu byť pri aktualizácii bluetronix CMS prepísané. Priame zmeny môžu byť tým pádom stratené.
Ako si vytvoriť vlastné súbory, ktoré budú kompatibilné s aktualizáciami?
Vlastné súbory v rámci systémových oblastí označuješ v názve súboru s _own, napríklad MyScript_own.js alebo MyStyle_own.css.
Môžem použiť existujúce systémové súbory ako šablónu?
Áno. Môžeš si pozrieť systémový súbor a použiť ho ako základ. Pre vlastné úpravy by si ho mal skopírovať, označiť kópiu s _own a následne upravovať iba tento vlastný súbor.