Nyelvfüggő JavaScript-fájlok létrehozása CMS-modulokhoz
A bluetronix CMS automatikusan optimalizált JavaScript-fájlokat generál minden aktivált nyelvhez a weboldalon. Megtanulod, hogyan egyesülnek a standard fájlok, az egyedi testreszabások és a nyelvfüggő modul szövegek, valamint hogy a CMS hogyan illeszti automatikusan a megfelelő fájlokat a weboldaladba.
Nyelvfüggő JavaScript-fájlok
A bluetronix CMS minden aktivált nyelvhez saját JavaScript fájlokat tud létrehozni a weboldaladon. Így a nyelvfüggő szövegek és funkciók közvetlenül elérhetőek az adott JavaScript fájlban.
A szükséges fájlok automatikusan létrejönnek, amint egy modulbeállítást elmentesz. A CMS figyelembe veszi mind az alapértelmezett fájlokat, mind a saját testreszabásaidat.
Ez a útmutató a „CMS-modulok integrálása és testreszabása” dokumentáción alapul. Már ismerned kell a bx_Mod fejlesztői mappát és a saját _own fájlok használatát.
1. Automatikusan létrehozott JavaScript fájlok
Amikor egy modulbeállítást elmentesz, a CMS automatikusan újra létrehozza az összes szükséges nyelvfüggő JavaScript fájlt.
Csak azok a nyelvi változatok jönnek létre, amelyeket az Lang modulon keresztül aktiváltál.
Az aktivált nyelvek a globális modulbeállításban kerülnek meghatározásra:
bx_Mod/config_own.phpPéldául, ha német, angol és spanyol nyelvet aktiváltál, a CMS megfelelő JavaScript fájlokat készít ezekhez a nyelvekhez.
A színbeállítások vagy elrendezések megváltoztatása már nem befolyásolja a JavaScript fájlokat. Az automatikus újbóli létrehozás a modulbeállítás mentésekor történik.
2. JavaScript fájlok manuális létrehozása
A automatikus létrehozás mellett a nyelvfüggő JavaScript fájlokat manuálisan is létrehozhatod.
Ehhez adminisztrátorként nyisd meg a következő címet. Helyettesítsd a példa domain-t a CMS címeddel:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpEzzel a hívással a JavaScript fájlokat függetlenül a modulbeállítás mentésétől újra létrehozhatod.
3. Globális modulbeállítások
A globális modulkonfiguráció a következő helyen található:
bx_Mod/config_own.phpEz a fájl tartalmazza a projekted egyéni beállításait. Telepítés után a felhasználó igényeinek megfelelően kerül beállításra.
Itt többek között meghatározásra kerül, hogy mely modulok és területek legyenek használatban, például bolt vagy blog. Ezen kívül figyelembe veszi az aktivált nyelveket.
A konfiguráció így fontos alapot képez a nyelvfüggő JavaScript fájlok előállításához.
4. Modulbeállítások és nyelvi fájlok
Az előállítás során a CMS figyelembe veszi a megfelelő modulok konfigurációs fájljait. Ide tartozik a standard konfiguráció, az egyedi beállítások és a nyelvfüggő szövegek.
A boltmodul példáján keresztül ezek:
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.phpA fájlok különböző feladatokat látnak el:
config.php: Tartalmazza a boltmodul standard konfigurációját.
config_own.php: Tartalmazza az egyéni konfigurációs beállításaidat.
config_text_de.php: Tartalmazza a boltmodul alapértelmezett német nyelvű szövegeit.
config_text_de_own.php: Tartalmazza a német nyelvű szövegek egyéni módosításaidat.
További aktivált nyelvek esetén a megfelelő nyelvi fájlokat is figyelembe veszik.
A standard fájlokat lehetőleg ne módosítsd közvetlenül. Használj az egyéni módosításokhoz a megadott _own-fájlokat, hogy a módosításaid normál CMS-frissítések során megmaradjanak.
5. Alapértelmezett JavaScript és saját testreszabások
A közös JavaScript fájlok a fejlesztői mappában találhatóak: bx_script.
A központi JavaScript funkciókhoz a következő fájlok kerülnek figyelembevételre:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js a bluetronix CMS standard fájlja. Rendszerfrissítések során felülírható.
A fájlok BxScript_own.js és BxScript_own_min.js az egyéni módosításokhoz lettek szánva.
Ezek a fájlok figyelembe vehetők a nyelvfüggő JavaScript fájlok előállítása során.
6. Fejléc JavaScript és saját testreszabások
A közönséges JavaScript fájlok mellett külön fájlok állnak rendelkezésre a weboldalad fejlécéhez.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js tartalmazza a CMS által biztosított fejléc JavaScript funkciókat. Ez a standard fájl rendszerfrissítéskor felülírható.
Saját módosításokhoz rendelkezésedre áll a BxHeadScript_own.js és a BxHeadScript_own_min.js.
Ezekből a fájlokból is előállításra kerülnek a megfelelő nyelvfüggő verziók.
7. Létrehozott JavaScript fájlok
A meglévő konfigurációs, nyelvi és JavaScript fájlok alapján a CMS külön fájlokat hoz létre minden aktivált nyelvhez.
Például a következő közönséges JavaScript fájlok jönnek létre:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsTovábbá létrejönnek a megfelelő fejléc JavaScript fájlok:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsA nyelvi kódok jelölik az adott nyelvet. Például de a németet, en az angolt, ru az oroszt, és es a spanyolt jelöli.
A CMS csak az aktívan engedélyezett nyelvekhez hozz létre fájlokat.
8. A létrehozott JavaScript fájlok optimalizálása
Az előállítás során a JavaScript fájlok további optimalizáláson mennek keresztül. Ez lehetővé teszi a felesleges megjegyzések és üres helyek eltávolítását.
Az egyszerű optimalizálás a következő lépéseket tartalmazza:
1. Azok a sorok, amelyek //-kal kezdődnek, eltávolításra kerülnek.
2. Azok a sorok, amelyek kizárólag szüneteket tartalmaznak, eltávolításra kerülnek.
3. Több szünet helyettesíthető egyetlen szünettel.
Teljes körű minifikálás jelenleg nem kötelező.
Az optimalizálás csökkenti a nem szükséges tartalmakat a létrehozott JavaScript fájlokban.
9. Nyelvfüggő JavaScript fájlok automatikus betöltése
A bluetronix CMS ellenőrzi a weboldalad létrehozásakor, hogy az aktuálisan kiválasztott nyelvhez tartozik-e megfelelő JavaScript fájl.
A HTML elrendezésben például a általános JavaScript fájl az alábbi CMS jelöléssel lehet beágyazva:
__FV_/bx_script/BxScript_own_min.js__Ha a látogató a weboldalad német nyelvű változatát hívja meg, és a megfelelő nyelvi fájl rendelkezésre áll, a CMS automatikusan kicseréli a jelölést erre:
__FV_/bx_script/BxScript_de.js__Ugyanez a elv érvényes a fejléc JavaScript fájlokra is.
Például:
__FV_/bx_script/BxHeadScript_own_min.js__átalakul:
__FV_/bx_script/BxHeadScript_de.js__A meglévő HTML beágyazást nem szükséges minden nyelvhez külön-külön módosítani.
Ha nincs megfelelő nyelvi fájl, akkor a általános JavaScript fájl marad beágyazva.
10. Böngésző cache frissítése a fájl módosítás dátuma alapján
Annak érdekében, hogy a böngészők egy változtatás után ne töltsenek be egy elavult JavaScript fájlt a gyorsítótárból, a CMS kiegészítőleg használhatja az adott fájl módosítási dátumát.
A beágyazott JavaScript fájl ezért egy verzióparamétert kap.
Példa:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMHa a fájl megváltozik, a verzióparaméter is megváltozhat. Ezzel a böngésző felismeri a megváltozott fájlverziót, és újratölti.
Ez az eljárás mind a általános JavaScript fájlokra, mind a fejléc JavaScript fájlokra alkalmazható.
11. Összefoglalás
A bluetronix CMS automatikusan külön JavaScript fájlokat készít a weboldalad minden engedélyezett nyelvéhez.
A létrehozás minden egyes modulkonfiguráció mentésekor történik. Ezen kívül manuálisan is elindíthatod az bx_Mod/BxScript.php segítségével.
A létrehozás során figyelembe veszi a globális modulkonfigurációt, a modulok konfigurációs és nyelvi fájljait, valamint a standard és saját JavaScript fájlokat.
Az elrendezésben a CMS automatikusan érzékeli, hogy van-e megfelelő nyelvi fájl, és azt a általános JavaScript fájl helyett ágyazza be.
Egyéni módosítások esetén mindig a megfelelő _own fájlokat használd, hogy változtatásaid a normál rendszerfrissítések során megmaradjanak.
GYIK
Miket kérdeznek tőlünk gyakran az ügyfelek?
Mikor készülnek nyelvfüggő JavaScript fájlok?
A bluetronix CMS automatikusan létrehozza a fájlokat, amint mented a modulkonfigurációt. Ekkor a JavaScript fájlok újra létrehozásra kerülnek minden engedélyezett nyelvhez.
Hogyan tudom manuálisan újra létrehozni a JavaScript fájlokat?
Lépj be adminisztrátorként a https://xxxx.bxserver.net/bx_Mod/BxScript.php címen. Cseréld ki a példa domaint a CMS-ed címére.
Készülnek JavaScript fájlok az összes elérhető nyelvhez?
Nem. A CMS kizárólag azokat a nyelvi verziókat hozza létre, amelyeket a Lang modul segítségével aktiváltál. A megfelelő beállítások a bx_Mod/config_own.php fájlban találhatóak.
Megváltoznak a JavaScript fájlok a színbeállítás vagy elrendezés váltásakor?
Nem. A színbeállítás, illetve az elrendezés nem változtatja meg a JavaScript fájlokat. Az automatikus újragenerálás a modulkonfiguráció mentésekor történik.
Milyen fájlokat tudok egyénileg módosítani?
Egyéni JavaScript módosításokhoz többek között a BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js és BxHeadScript_own_min.js áll rendelkezésedre. A modulok saját konfigurációs és nyelvi fájlokkal is rendelkeznek, ezeket _own jelöléssel látják el.
Mi történik a standard JavaScript fájlokkal a CMS frissítésekor?
A standard fájlok BxScript.js és BxHeadScript.js a rendszerfrissítések során felülírhatók. Ezért saját módosításaidat kizárólag a megfelelő _own fájlokban tárold.
Hogyan ismeri fel a CMS, hogy melyik JavaScript fájlt kell betölteni?
A CMS a weboldal létrehozásakor ellenőrzi, hogy a jelenleg kiválasztott nyelvhez rendelkezésre áll-e megfelelő JavaScript fájl. Ha például létezik a BxScript_de.js, akkor ezt használja a német nyelvű verzióhoz a közönséges fájl helyett.
Hogyan akadályozzam meg, hogy a látogatók elavult JavaScript fájlokat töltsenek be a böngésző gyorsítótárából?
A CMS a JavaScript fájlok betöltésekor további fájl módosítási dátumot is használhat verzióparaméterként. Ez lehetővé teszi a böngésző számára, hogy a változtatás után a legújabb fájl verziót töltse be.