Vytváření jazykově závislých JavaScriptových souborů pro CMS moduly
bluetronix CMS automaticky generuje optimalizované JavaScriptové soubory pro každý aktivovaný jazyk tvé webové stránky. Naučíš se, jak se spojují standardní soubory, individuální úpravy a jazykově závislé texty modulů a jak CMS automaticky integruje vhodné soubory do tvé webové stránky.
Jazykově závislé JavaScriptové soubory
CMS bluetronix může generovat vlastní JavaScriptové soubory pro každý aktivovaný jazyk tvé webové stránky. Díky tomu jsou jazykově závislé texty a funkce přímo k dispozici v příslušném JavaScriptovém souboru.
Potřebné soubory se automaticky vytvoří, jakmile uložíš konfiguraci modulu. Přitom systém CMS zohledňuje jak standardní soubory, tak tvé individuální úpravy.
Tento návod vychází z dokumentace „Zahrnutí a přizpůsobení modulů CMS“. Měl bys být již obeznámen s vývojářským adresářem bx_Mod a používáním vlastních _own souborů.
1. Automatické generování JavaScriptových souborů
Když uložíš konfiguraci modulu, CMS automaticky znovu vygeneruje všechny potřebné jazykově závislé JavaScriptové soubory.
Budou vytvořeny pouze jazykové verze, které jsi aktivoval přes modul Lang.
Aktivované jazyky jsou stanoveny přes globální konfiguraci modulu:
bx_Mod/config_own.phpPokud jsi například aktivoval němčinu, angličtinu a španělštinu, CMS vytvoří odpovídající JavaScriptové soubory pro tyto tři jazyky.
Změna barevného schématu nebo rozložení více nemění JavaScriptové soubory. Automatické znovuvytváření probíhá při ukládání konfigurace modulu.
2. Ruční generování JavaScriptových souborů
Kromě automatického generování můžeš jazykově závislé JavaScriptové soubory nechat vytvořit také ručně.
Pro to se jako administrátor přihlas na následující adresu. Nahraď doménu příkladu adresou svého CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpTímto voláním můžeš JavaScriptové soubory znovu generovat nezávisle na ukládání konfigurace modulu.
3. Globální konfigurace modulu
Globální konfigurace modulu se nachází na:
bx_Mod/config_own.phpTento soubor obsahuje individuální nastavení tvého projektu. Je nakonfigurován po instalaci podle požadavků uživatele.
Zde je mimo jiné stanoveno, které moduly a oblasti se mají používat, například obchod nebo blog. Zohledňovány jsou také aktivované jazyky.
Konfigurace tak tvoří důležitý základ pro generování jazykově závislých JavaScriptových souborů.
4. Konfigurace modulů a jazykové soubory
Při generování zohledňuje CMS konfigurační soubory příslušných modulů. Patří sem standardní konfigurace, individuální úpravy a jazykově závislé texty.
Na příkladu modulu obchodu to jsou:
bx_Mod/Shop/config.php
bx_Mod/Shop/config_own.php
bx_Mod/Shop/config_text_de.php
bx_Mod/Shop/config_text_de_own.phpTyto soubory plní různé úkoly:
config.php: Obsahuje standardní konfiguraci modulu obchodu.
config_own.php: Obsahuje tvoje individuální konfigurační nastavení.
config_text_de.php: Obsahuje standardní německé texty modulu obchodu.
config_text_de_own.php: Obsahuje tvoje individuální úpravy německých textů.
Pro další aktivované jazyky se zohledňují příslušné jazykové soubory.
Standardní soubory se pokus nezměnit přímo. Pro individuální úpravy používej určené _own soubory, aby se tvoje změny zachovaly při běžných aktualizacích CMS.
5. Standardní JavaScript a vlastní úpravy
Obecné JavaScriptové soubory se nacházejí ve složce pro vývojáře bx_script.
Pro centrální JavaScriptové funkce se zohledňují následující soubory:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js je standardní soubor bluetronix CMS. Může být přepsán při aktualizaci systému.
Soubory BxScript_own.js a BxScript_own_min.js jsou určeny pro individuální úpravy.
Tyto soubory mohou být zohledněny při generování jazykově závislých JavaScriptových souborů.
6. Hlavičkový JavaScript a vlastní úpravy
Kromě obecných JavaScriptových souborů existují samostatné soubory pro záhlaví tvé webové stránky.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js obsahuje funkce JavaScriptu pro záhlaví poskytované CMS. Tento standardní soubor může být přepsán při aktualizaci systému.
Pro vlastní úpravy máš k dispozici BxHeadScript_own.js a BxHeadScript_own_min.js.
I z těchto souborů se generují příslušné jazykově závislé verze.
7. Generované JavaScriptové soubory
Z dostupných konfiguračních, jazykových a JavaScriptových souborů CMS vytváří samostatné soubory pro každý aktivovaný jazyk.
Například vznikají následující obecné JavaScriptové soubory:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsDále jsou vytvářeny příslušné soubory JavaScriptu pro záhlaví:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsJazykové zkratky označují příslušný jazyk. Například de znamená němčinu, en angličtinu, ru ruštinu a es španělštinu.
CMS generuje pouze soubory pro skutečně aktivované jazyky.
8. Optimalizace generovaných JavaScriptových souborů
Během generování jsou JavaScriptové soubory navíc optimalizovány. To umožňuje odstranění zbytečných komentářů a nadbytečných mezer.
Jednoduchá optimalizace zahrnuje následující kroky:
1. Řádky, které začínají //, jsou odstraněny.
2. Řádky, které obsahují pouze mezery, jsou odstraněny.
3. Více mezer může být nahrazeno jednou mezerou.
Úplná minifikace není v současnosti nezbytná.
Optimalizace snižuje zbytečný obsah uvnitř generovaných JavaScriptových souborů.
9. Automatické začlenění jazykově závislých JavaScriptových souborů
bluetronix CMS kontroluje při generování tvé webové stránky, zda existuje odpovídající JavaScriptový soubor pro aktuálně vybraný jazyk.
Ve HTML rozvržení může být například obecný JavaScriptový soubor zahrnut následující značkou CMS:
__FV_/bx_script/BxScript_own_min.js__Pokud návštěvník otevře německou jazykovou verzi tvé webové stránky a odpovídající jazykový soubor je k dispozici, CMS automaticky nahradí značku:
__FV_/bx_script/BxScript_de.js__Stejný princip platí pro soubor JavaScriptu pro záhlaví.
Z:
__FV_/bx_script/BxHeadScript_own_min.js__se například stane:
__FV_/bx_script/BxHeadScript_de.js__Stávající HTML vložení nemusí být pro každou jazykovou verzi upravováno jednotlivě.
Pokud není k dispozici odpovídající jazykový soubor, zůstává připojena obecná JavaScriptová file.
10. Aktualizace mezipaměti prohlížeče podle data změny souboru
Aby prohlížeče po změně nadále nenačítaly zastaralou JavaScriptovou file z mezipaměti, může CMS navíc využít datum poslední změny příslušného souboru.
Připojený JavaScriptový soubor obdrží parametr verze.
Příklad:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMPokud se soubor změní, může se změnit i parametr verze. Tím prohlížeč rozpozná změněnou verzi souboru a může ji znovu načíst.
Tento postup lze použít jak pro obecné JavaScriptové soubory, tak pro JavaScriptové soubory hlavičky.
11. Shrnutí
CMS bluetronix automaticky vytváří samostatné JavaScriptové soubory pro každý aktivovaný jazyk vaší webové stránky.
Vytváření se provádí při každém uložení konfigurace modulu. Navíc můžete tento proces spustit ručně přes bx_Mod/BxScript.php.
Při vytváření se zohledňuje globální konfigurace modulu, konfigurační a jazykové soubory modulů, jakož i standardní a vlastní JavaScriptové soubory.
V rozložení CMS automaticky rozpozná, zda je k dispozici odpovídající jazykový soubor, a připojí jej namísto obecného JavaScriptového souboru.
Pro individuální úpravy vždy používejte určené _own soubory, abyste zajistili, že vaše změny zůstanou zachovány při běžných systémových aktualizacích.
Často kladené otázky
co se nás zákazníci často ptají
Kdy se generují jazykově závislé JavaScriptové soubory?
CMS bluetronix automaticky generuje soubory, jakmile uložíte konfiguraci modulu. Při tom se znovu vytvářejí JavaScriptové soubory pro všechny aktivované jazyky.
Jak mohu manuálně znovu vytvořit JavaScriptové soubory?
Jako administrátor navštivte adresu https://xxxx.bxserver.net/bx_Mod/BxScript.php. Nahraďte příkladovou doménu adresou svého CMS.
Jsou generovány JavaScriptové soubory pro všechny dostupné jazyky?
Ne. CMS vytváří pouze jazykové verze, které jste aktivovali prostřednictvím modulu Lang. Odpovídající nastavení se provádí v bx_Mod/config_own.php.
Jsou JavaScriptové soubory změněny při změně barevného schématu nebo rozložení?
Ne. Barevné schéma nebo rozložení již JavaScriptové soubory nemění. Automatické znovu vytvoření probíhá při uložení konfigurace modulu.
Jaké soubory mohu individuálně upravit?
Pro individuální JavaScriptové úpravy máte k dispozici mimo jiné BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js a BxHeadScript_own_min.js. Také moduly mají vlastní konfigurační a jazykové soubory označené jako _own.
Co se stane se standardními JavaScriptovými soubory při aktualizaci CMS?
Standardní soubory BxScript.js a BxHeadScript.js mohou být při systémových aktualizacích přepsány. Proto byste měli své vlastní úpravy ukládat výhradně do určených _own souborů.
Jak CMS rozpozná, který JavaScriptový soubor se má připojit?
CMS při generování webové stránky kontroluje, zda je k dispozici odpovídající JavaScriptový soubor pro aktuálně vybraný jazyk. Například pokud existuje BxScript_de.js, připojí se pro německou jazykovou verzi místo obecného souboru.
Jak zabránit návštěvníkům v načítání zastaralých JavaScriptových souborů z cache prohlížeče?
CMS může při začleňování JavaScriptových souborů navíc použít datum změny souboru jako verzi. Tímto způsobem může prohlížeč po změně načíst novou verzi souboru.