Vytváranie jazykovo závislých JavaScript súborov pre CMS moduly

Jazykovo závislé JavaScript súbory

Systém bluetronix CMS môže vytvárať vlastné JavaScript súbory pre každý aktivovaný jazyk tvojej webovej stránky. Tým pádom sú jazykovo závislé texty a funkcie priamo dostupné v príslušnom JavaScript súbore.

Potrebné súbory sa automaticky vytvoria, keď uložíš konfiguráciu modulu. Pri tom systémpodporuje ako štandardné súbory, tak aj tvoje individuálne úpravy.

Tento návod sa zakladá na dokumentácii „Včlenenie a prispôsobenie modulov CMS“. Mal by si byť už oboznámený s vývojárskym priečinkom bx_Mod a použitím vlastných _own súborov.

1. Automatická generácia JavaScript súborov

Keď uložíš konfiguráciu modulu, systém CMS automaticky vytvorí všetky potrebné jazykovo závislé JavaScript súbory.

Vytvorené budú len jazykové verzie, ktoré si aktivoval prostredníctvom modulu Lang.

Aktivované jazyky sú stanovené prostredníctvom globálnej konfigurácie modulu:

bx_Mod/config_own.php

Ak si aktivoval napríklad nemčinu, angličtinu a španielčinu, systém CMS vytvorí príslušné JavaScript súbory pre tieto tri jazyky.

Zmena farebného rozloženia alebo návrhu už nezmení JavaScript súbory. Automatické pregenerovanie prebieha pri uložení konfigurácie modulu.

2. Manuálne vytváranie JavaScript súborov

Okrem automatického vytvorenia môžeš jazykovo závislé JavaScript súbory vytvoriť aj manuálne.

Na to ako administrátor otvormi nasledujúcu adresu. Nahraď vzorovú doménu adresou tvojho CMS:

https://xxxx.bxserver.net/bx_Mod/BxScript.php

Týmto volaním môžeš znovu vytvoriť JavaScript súbory nezávisle od ukladania konfigurácie modulu.

3. Globálna konfigurácia modulu

Globálna konfigurácia modulu sa nachádza na:

bx_Mod/config_own.php

Tento súbor obsahuje individuálne nastavenia tvojho projektu. Bude nastavený po inštalácii podľa požiadaviek používateľa.

Medzi iným obsahuje aj stanovenie, ktoré moduly a oblasti sa majú používať, napríklad obchod alebo blog. Taktiež zohľadňuje aktivované jazyky.

Konfigurácia tak tvorí dôležitý základ pre vytvorenie jazykovo závislých JavaScript súborov.

4. Konfigurácie modulov a jazykové súbory

Pri vytváraní systém CMS zohľadňuje konfiguračné súbory príslušných modulov. Patrí sem štandardná konfigurácia, individuálne úpravy a jazykovo závislé texty.

Na príklade modulu obchodu sú to:

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.php

Súbory plnia rôzne úlohy:

config.php: Obsahuje štandardnú konfiguráciu modulu obchodu.

config_own.php: Obsahuje tvoje individuálne konfiguračné nastavenia.

config_text_de.php: Obsahuje štandardné nemecké texty modulu obchodu.

config_text_de_own.php: Obsahuje tvoje individuálne úpravy nemčine.

Pre ďalšie aktivované jazyky budú zohľadnené príslušné jazykové súbory.

Snaž sa meniť štandardné súbory priamym spôsobom čo najmenej. Na individuálne úpravy použite určené _own súbory, aby tvoje zmeny boli uchované pri bežných aktualizáciách CMS.

5. Štandardný JavaScript a vlastné úpravy

Všeobecné JavaScript súbory sa nachádzajú v priečinku vývojára bx_script.

Pre centrálne JavaScript funkcie sa zohľadňujú nasledujúce súbory:

/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.js

BxScript.js je štandardný súbor bluetronix CMS. Pri aktualizáciach systému môže byť prepísaný.

Súbory BxScript_own.js a BxScript_own_min.js sú určené na individuálne úpravy.

Tieto súbory môžu byť zohľadnené pri vytváraní jazykovo závislých JavaScript súborov.

6. JavaScript hlavičky a vlastné úpravy

Okrem všeobecných JavaScript súborov existujú samostatné súbory pre hlavičku tvojej webovej stránky.

/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.js

BxHeadScript.js obsahuje hlavičkové JavaScript funkcie poskytované CMS. Tento štandardný súbor môže byť pri aktualizácii systému prepísaný.

Pre vlastné úpravy sú k dispozícii BxHeadScript_own.js a BxHeadScript_own_min.js.

Aj z týchto súborov sú generované príslušné jazykovo závislé verzie.

7. Vytvorené JavaScript súbory

Z existujúcich konfiguračných, jazykových a JavaScript súborov CMS vytvára samostatné súbory pre každý aktivovaný jazyk.

Napríklad vznikajú nasledujúce všeobecné JavaScript súbory:

/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.js

Okrem toho sú vytvárané príslušné hlavičkové JavaScript súbory:

/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.js

Jazykové skratky označujú konkrétny jazyk. Napríklad de znamená nemčinu, en angličtinu, ru ruštinu a es španielčinu.

CMS generuje len tie súbory pre skutočne aktivované jazyky.

8. Optimalizácia vytvorených JavaScript súborov

Počas generovania sú JavaScript súbory dodatočne optimalizované. Týmto spôsobom môžu byť odstránené zbytočné komentáre a prebytočné medzery.

Jednoduchá optimalizácia zahŕňa nasledujúce kroky:

1. Riadky, ktoré začínajú na //, sú odstránené.

2. Riadky, ktoré obsahujú len medzery, sú odstránené.

3. Viaceré medzery môžu byť nahradené jednou medzerou.

Úplná minifikácia momentálne nie je nevyhnutná.

Optimalizácia znižuje zbytočný obsah v generovaných JavaScript súboroch.

9. Automatické začlenenie jazykovo závislých JavaScript súborov

Bluetronix CMS kontroluje pri generovaní tvojej webovej stránky, či pre aktuálne vybraný jazyk existuje príslušný JavaScript súbor.

V HTML rozložení môže byť napríklad všeobecný JavaScript súbor zahrnutý pomocou nasledujúcej CMS značky:

__FV_/bx_script/BxScript_own_min.js__

Keď návštevník otvorí nemeckú jazykovú verziu tvojej webovej stránky a príslušný jazykový súbor je prítomný, CMS automaticky nahrádza značku za:

__FV_/bx_script/BxScript_de.js__

To isté platí pre hlavičkový JavaScript súbor.

Z:

__FV_/bx_script/BxHeadScript_own_min.js__

sa napríklad stane:

__FV_/bx_script/BxHeadScript_de.js__

Existujúce HTML prepojenie nemusí byť upravené pre každý jazyk zvlášť.

Ak nie je k dispozícii vhodný jazykový súbor, zostáva pripojený všeobecný JavaScript súbor.

10. Aktualizácia prehliadačovej cache pomocou dátumu zmeny súboru

Aby prehliadače po zmene naďalej nezobrazovali zastaraný JavaScript súbor z cache, CMS môže navyše použiť dátum zmeny príslušného súboru.

Pripojený JavaScript súbor dostane parametre verzie.

Príklad:

BxScript_de.js?v=DATEI_AENDERUNGS_DATUM

Ak sa súbor zmení, môže sa zmeniť aj parameter verzie. Týmto spôsobom prehliadač rozpozná zmenenú verziu súboru a môže ju znovu načítať.

Tento postup môže byť použitý pre všeobecné JavaScript súbory aj pre JavaScript súbory hlavičky.

11. Zhrnutie

Bluetronix CMS automaticky vytvára samostatné JavaScript súbory pre každý aktívny jazyk tvojej webovej stránky.

Vytvorenie prebieha pri každom uložením konfigurácie modulu. Okrem toho ich môžeš manuálne spustiť cez bx_Mod/BxScript.php.

Pri vytváraní sa zohľadňuje globálna konfigurácia modulu, konfiguračné a jazykové súbory modulov, ako aj štandardné a vlastné JavaScript súbory.

V rozložení CMS automaticky rozpozná, či je k dispozícii vhodný jazykový súbor, a pripojí ho namiesto všeobecného JavaScript súboru.

Pre individuálne úpravy používať výhradne určené _own súbory, aby tvoje zmeny zostali zachované pri bežných aktualizáciách systému.