Zobrazení pro vývojáře a systémové oblasti v bluetronix CMS

Další funkce s přístupem pro vývojáře

S přístupem pro vývojáře máš v bluetronix CMS k dispozici další funkce, které nejsou viditelné v běžném uživatelském zobrazení.

To zahrnuje další vývojářské složky ve správě souborů, přístup k PHP kódu stránek, další vývojářské databázové tabulky, stejně jako systémové skripty, šablony rozložení a moduly.

Úprava PHP kódu stránek

V běžném zobrazení CMS můžeš upravit HTML kód stránky. S přístupem pro vývojáře je ti také k dispozici tlačítko PHP Kód.

Pomocí toho můžeš k CMS stránce přidat vlastní PHP kód, například pro databázové dotazy, dynamický obsah, nahrazování uvnitř $LayoutHTML, funkce CMS nebo vlastní PHP funkce.

Další databázové tabulky

S přístupem pro vývojáře se ve správě databází zobrazují další systémové tabulky. To zahrnuje například tabulky pro rozložení, správu stránek, systémová nastavení a další interní funkce CMS.

Tyto vývojářské a systémové tabulky jsou ve správě databází označeny červeně.

Struktura červeně označených vývojářských databázových tabulek nesmí být měněna. Nesmíš tam mazat, přidávat nebo přejmenovávat sloupce, měnit datové typy a přizpůsobovat systémové struktury. Tyto tabulky mohou být při aktualizaci systému aktualizovány nebo nahrazeny.

Adresáře vývojářů v správě souborů

S přístupem pro vývojáře se ve správě souborů zobrazují další systémové složky. Tyto vývojářské složky jsou zobrazeny červeně a obvykle začínají bx_.

Mezi nejdůležitější složky patří bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script a bx_style.

bx_doc

Ve složce bx_doc se nacházejí předinstalované vzorové soubory a dokumenty. To mohou být například PDF dokumenty, které se používají v rámci vzorových stránek nebo šablon.

bx_fonts

Ve složce bx_fonts jsou písma dodávaná nebo nainstalovaná bluetronix CMS. Tato písma mohou být používána v různých designech a rozloženích CMS.

bx_Img

Složka bx_Img obsahuje výchozí obrázky aktuálně používaného tématu nebo sad obrázků.

Jako vývojář si můžeš vybrat jinou sadu obrázků k tématu. Různé sady obrázků k tématu používají stejné definované názvy souborů a fungují tak jako jednotná šablona. HTML struktura se při změně sady obrázků k tématu nemusí měnit.

bx_Import

Složka bx_Import se používá pro import externích webových stránek. Například mohou být připraveny webové stránky Bootstrap-5 pro import a uloženy v této oblasti. Soubory jsou poté analyzovány a začleněny do struktury bluetronix CMS.

bx_Layout

Ve složce bx_Layout se nacházejí šablony stránek a sekcí CMS. Tyto šablony jsou následně k dispozici uživateli například prostřednictvím Vložení → Sekce stránky.

Jako vývojář si můžeš vytvořit vlastní šablony pro sekce Hero, textové oblasti, oblasti produktů, kontaktní oblasti, prvky teaseru a další individuální sekce stránek. Konečný uživatel může tyto prvky poté vložit prostřednictvím běžného editoru, aniž by musel programovat HTML.

bx_script

Ve složce bx_script se nacházejí JavaScript soubory dodávané bluetronix CMS. To zahrnuje mimo jiné BxHeadScript.js a BxScript.js.

V závislosti na aktivovaných jazycích mohou být navíc vytvářeny jazykově závislé verze, například BxScript_en.js, BxScript_de.js nebo BxScript_fr.js.

Uvnitř složky script se nachází také adresář Source. Tam leží jednotlivé zdrojové soubory nebo komponenty, ze kterých se vytvářejí později používané hlavní soubory.

bx_style

Analogicky k bx_Script obsahuje bx_style centrální styly bluetronix CMS. Z toho jsou například generovány stylové soubory používané systémem. I zde mohou být zdrojové soubory, ze kterých jsou sestavovány konečné CSS soubory.

Systémové složky a aktualizace

Červeně označené bx_-systémové složky patří k bluetronix CMS a mohou být při aktualizaci systému úplně nebo částečně přepsány. Proto není dovoleno ukládat vlastní změny přímo do běžných systémových souborů.

Vlastní soubory uvnitř systémových oblastí musí být označeny _own. Toto označení signalizuje bluetronix CMS, že se jedná o vlastní projektem specifický soubor.

Příklady jsou config_own.php, MyScript_own.js, MyStyle_own.css nebo MyTemplate_own.txt. Přípona souboru v tomto případě není rozhodující. Rozhodující je označení _own v názvu souboru.

Vlastní úpravy tedy vždy uvnitř červených systémových složek vytvářej jako _own-soubory. Tímto způsobem zůstanou tyto vlastní soubory také po aktualizaci bluetronix CMS zachovány.

Systémové soubory neměň přímo

Existující systémový soubor bys neměl přímo upravovat. Použij jej v případě potřeby jako šablonu, zkopíruj jej, označ kopii _own a proveď své vlastní úpravy v této souboru.

bx_Mod

Ve složce bx_Mod se nacházejí moduly bluetronix CMS. To mohou zahrnovat například blog, obchod, vyhledávání, přihlášení a další moduly CMS.

Modul může obsahovat různé soubory a oblasti, například konfigurace, seznamy, detailní pohledy, PHP skripty a další modulární soubory.

Úprava modulových souborů

Také u modulárních souborů platí: originální systémové soubory by neměly být přímo měněny. Můžeš je zobrazit, přečíst, použít jako základ a zkopírovat. Pro vlastní verzi poté vytvoř kopii s _own a prováděj zde své změny.

Nejdůležitější pravidla pro vývojáře

1. Červeně označené databázové tabulky nezměňuj strukturálně.
2. Červeně označené bx_-systémové složky mohou být při aktualizacích přepsány.
3. Systémové soubory neměň přímo pro vlastní úpravy.
4. Vlastní soubory v systémových oblastech vždy označuj s _own.
5. Systémové soubory lze číst a kopírovat jako šablony.
6. Vlastní úpravy pak prováděj v _own-souborech.

Shrnutí

Přístup pro vývojáře rozšiřuje bluetronix CMS o další funkce a systémové oblasti jako PHP kód, databázové tabulky pro vývojáře, bx_-systémové složky, moduly, skripty, styly a šablony rozložení.

Obzvlášť důležité je oddělení systémových souborů a vlastních rozšíření. Originální systémové soubory používáš jako šablony, vlastní úpravy zakládáš jako _own-soubory.