Skapa språkberoende JavaScript-filer för CMS-moduler
Bluetronix CMS skapar automatiskt optimerade JavaScript-filer för varje aktiverat språk på din webbplats. Du lär dig hur standardfiler, individuella anpassningar och språkberoende modultexter sammanfogas och hur CMS automatiskt inkluderar de rätta filerna i din webbplats.
Språkberoende JavaScript-filer
bluetonix CMS kan generera egna JavaScript-filer för varje aktiverat språk på din webbplats. På så sätt finns språkberoende texter och funktioner direkt tillgängliga inom respektive JavaScript-fil.
De nödvändiga filerna skapas automatiskt så snart du sparar en modulkonfiguration. CMS:et tar hänsyn till både standardfiler och dina individuella anpassningar.
Denna handledning bygger på dokumentationen "Integrera och anpassa CMS-moduler". Du bör redan vara bekant med utvecklarmappen bx_Mod och användningen av egna _own-filer.
1. Automatisk skapelse av JavaScript-filer
När du sparar en modulkonfiguration genererar CMS:et automatiskt alla nödvändiga språkberoende JavaScript-filer på nytt.
Endast de språkversioner som du har aktiverat via modulen Lang skapas.
De aktiverade språken fastställs via den globala modulkonfigurationen:
bx_Mod/config_own.phpOm du till exempel har aktiverat tyska, engelska och spanska, skapar CMS:et motsvarande JavaScript-filer för dessa tre språk.
Ett byte av färgschema eller layout påverkar inte längre JavaScript-filerna. Den automatiska nygenereringen sker vid sparande av en modulkonfiguration.
2. Skapa JavaScript-filer manuellt
Förutom den automatiska genereringen kan du låta skapa de språkberoende JavaScript-filerna manuellt.
Som administratör går du till följande adress. Ersätt exempel-domenet med adressen till ditt CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpGenom detta anrop kan du nygenerera JavaScript-filerna oberoende av sparande av en modulkonfiguration.
3. Global modulkonfiguration
Den globala modulkonfigurationen finns under:
bx_Mod/config_own.phpDenna fil innehåller de individuella inställningarna för ditt projekt. Den ställs in efter installationen enligt användarens krav.
Här fastställs bland annat vilka moduler och områden som ska användas, till exempel butik eller blogg. De aktiverade språken beaktas dessutom.
Konfigurationen utgör därmed en viktig grund för genereringen av de språkberoende JavaScript-filerna.
4. Modulkonfigurationer och språkfiler
Vid genereringen beaktar CMS:et konfigurationsfilerna för respektive moduler. Det inkluderar standardkonfiguration, individuella anpassningar och språkberoende texter.
Exempelvis för butikmodulen är detta:
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.phpFilerna har olika syften:
config.php: Innehåller standardkonfigurationen för butikmodulen.
config_own.php: Innehåller dina individuella konfigurationsinställningar.
config_text_de.php: Innehåller de standardtyska texterna för butikmodulen.
config_text_de_own.php: Innehåller dina individuella anpassningar av de tyska texterna.
För ytterligare aktiverade språk beaktas motsvarande språkfiler.
Försök att inte ändra standardfilerna direkt. Använd de avsedda _own-filerna för individuella anpassningar så att dina ändringar bevaras vid normala CMS-uppdateringar.
5. Standard-JavaScript och egna anpassningar
De allmänna JavaScript-filerna finns i utvecklarmappen bx_script.
De centrala JavaScript-funktionerna omfattar följande filer:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js är standardfilen för bluetronix CMS. Den kan skrivas över vid systemuppdateringar.
Filerna BxScript_own.js och BxScript_own_min.js är avsedda för individuella anpassningar.
Dessa filer kan tas med vid skapandet av språkberoende JavaScript-filer.
6. Header-JavaScript och egna anpassningar
Förutom vanliga JavaScript-filer finns det separata filer för din hemsidas header.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js innehåller de header-JavaScript-funktioner som tillhandahålls av CMS:et. Denna standardfil kan skrivas över vid en systemuppdatering.
För egna anpassningar har du tillgång till BxHeadScript_own.js och BxHeadScript_own_min.js.
Även från dessa filer skapas motsvarande språkberoende versioner.
7. Skapade JavaScript-filer
Från de befintliga konfigurations-, språk- och JavaScript-filerna skapar CMS:et separata filer för varje aktiverat språk.
Till exempel skapas följande allmänna JavaScript-filer:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsDessutom skapas motsvarande header-JavaScript-filer:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsSpråkkoderna anger respektive språk. Till exempel står de för tyska, en för engelska, ru för ryska och es för spanska.
CMS:et skapar endast filer för de faktiska aktiverade språken.
8. Optimering av de skapade JavaScript-filerna
Vid skapandet optimeras JavaScript-filerna också. Onödiga kommentarer och överflödiga mellanslag kan tas bort.
Den enkla optimeringen omfattar följande steg:
1. Rader som börjar med // tas bort.
2. Rader som enbart innehåller mellanslag tas bort.
3. Flera mellanslag kan ersättas med ett enda mellanslag.
En fullständig minifiering är för närvarande inte nödvändig.
Optimeringen minskar onödigt innehåll inom de skapade JavaScript-filerna.
9. Automatisk inkludering av språkberoende JavaScript-filer
Det bluetronix CMS kontrollerar vid skapandet av din webbplats om en motsvarande JavaScript-fil finns för det aktuella valda språket.
I HTML-layouten kan den allmänna JavaScript-filen till exempel inkluderas med följande CMS-märkning:
__FV_/bx_script/BxScript_own_min.js__Om besökaren öppnar den tyska språkversionen av din webbplats och den motsvarande språkfilen finns, ersätter CMS:et automatiskt märkningen med:
__FV_/bx_script/BxScript_de.js__Samma princip gäller för header-JavaScript-filen.
Från:
__FV_/bx_script/BxHeadScript_own_min.js__blir till exempel:
__FV_/bx_script/BxHeadScript_de.js__Den befintliga HTML-inbjudningen behöver inte anpassas individuellt för varje språk.
Om ingen lämplig språkfil finns, förblir den allmänna JavaScript-filen kopplad.
10. Uppdatera webbläsarcachen genom filens ändringsdatum
För att webbläsare inte ska fortsätta ladda en föråldrad JavaScript-fil från cachen efter en ändring, kan CMS:t dessutom använda ändringsdatumet för respektive fil.
Den kopplade JavaScript-filen får en versionsparameter för detta.
Exempel:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMÄndras filen kan även versionsparametern ändras. Därför känner webbläsaren igen den ändrade filversionen och kan ladda den på nytt.
Denna metod kan användas både för allmänna JavaScript-filer och för header-JavaScript-filer.
11. Sammanfattning
Det bluetronix CMS skapar automatiskt separata JavaScript-filer för varje aktiverat språk på din webbplats.
Skapandet sker vid varje sparande av en modulkonfiguration. Dessutom kan du starta det manuellt via bx_Mod/BxScript.php.
Vid skapandet tas hänsyn till den globala modulkonfigurationen, konfigurations- och språkfilerna för modulerna samt standard- och egna JavaScript-filer.
I layouten känner CMS:t automatiskt av om en lämplig språkfil finns och kopplar in denna istället för den allmänna JavaScript-filen.
Använd för individuella anpassningar alltid de avsedda _own-filerna, så att dina ändringar bevaras vid normala systemuppdateringar.
FAQ
vad kunder ofta frågar oss
När skapas språkberoende JavaScript-filer?
Det bluetronix CMS skapar filerna automatiskt så fort du sparar en modulkonfiguration. Vid det tillfället nyskapade JavaScript-filer för alla aktiverade språk.
Hur kan jag manuellt skapa om JavaScript-filerna?
Som administratör besöker du adressen https://xxxx.bxserver.net/bx_Mod/BxScript.php. Ersätt exempel-domänen med adressen till ditt CMS.
Skapas JavaScript-filer för alla tillgängliga språk?
Nej. CMS:t skapar endast språkversionerna som du har aktiverat via modulen Lang. De motsvarande inställningarna anges i bx_Mod/config_own.php.
Ändras JavaScript-filerna vid byte av färgsättning eller layout?
Nej. Färgsättningen eller layouten förändrar inte JavaScript-filerna längre. Den automatiska nyproduktionen sker vid sparande av en modulkonfiguration.
Vilka filer kan jag anpassa individuellt?
För individuella JavaScript-anpassningar har du tillgång till bland annat BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js och BxHeadScript_own_min.js. Även modulerna har egna konfigurations- och språkfiler med beteckningen _own.
Vad händer med standard-JavaScript-filerna vid en CMS-uppdatering?
Standardfilerna BxScript.js och BxHeadScript.js kan skrivas över vid systemuppdateringar. Därför bör du spara dina egna ändringar endast i de avsedda _own-filerna.
Hur känner CMS:t av vilken JavaScript-fil som ska kopplas in?
CMS:t kontrollerar vid skapandet av webbplatsen om det finns en motsvarande JavaScript-fil för det aktuella valda språket. Om exempelvis BxScript_de.js finns, kommer denna att kopplas in för den tyska språkversionen istället för den allmänna filen.
Hur förhindrar jag att besökare laddar föråldrade JavaScript-filer från webbläsarens cache?
CMS:et kan vid inbindning av JavaScript-filer dessutom använda filens ändringsdatum som versionsparameter. På så sätt kan webbläsaren ladda den nya filversionen efter en ändring.