Sprogafhængige JavaScript-filer til CMS-moduler
Det bluetronix CMS genererer automatisk optimerede JavaScript-filer for hvert aktiveret sprog på din hjemmeside. Du lærer, hvordan standardfiler, individuelle tilpasninger og sprogafhængige modultekster samles, og hvordan CMS automatisk integrerer de relevante filer i din hjemmeside.
Sprogafhængige JavaScript-filer
bluetrónix CMS kan generere egne JavaScript-filer for hvert aktiveret sprog på din hjemmeside. Dermed er sprogafhængige tekster og funktioner tilgængelige direkte i den respektive JavaScript-fil.
De nødvendige filer oprettes automatisk, så snart du gemmer en modulkonfiguration. CMS'en tager både standardfilerne og dine individuelle tilpasninger i betragtning.
Denne vejledning bygger videre på dokumentationen "Integrere og tilpasse CMS-moduler". Du bør allerede være fortrolig med udviklermappen bx_Mod og brugen af egne _own-filer.
1. Automatisk generering af JavaScript-filer
Når du gemmer en modulkonfiguration, genererer CMS'en automatisk alle nødvendige sprogafhængige JavaScript-filer på ny.
Der oprettes kun de sprogversioner, som du har aktiveret via modulet Lang.
De aktiverede sprog fastlægges gennem den globale modulkonfiguration:
bx_Mod/config_own.phpHvis du eksempelvis har aktiveret tysk, engelsk og spansk, opretter CMS'en tilsvarende JavaScript-filer for disse tre sprog.
Et skift af farvesæt eller layout ændrer ikke længere JavaScript-filerne. Den automatiske nygenerering finder sted ved gemning af en modulkonfiguration.
2. Manuel generering af JavaScript-filer
Ud over den automatiske generering kan du lade de sprogafhængige JavaScript-filer blive oprettet manuelt.
Som administrator skal du tilgå følgende adresse. Erstat eksempeldomenet med adressen til dit CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpGennem denne adresse kan du generere JavaScript-filerne uafhængigt af gemningen af en modulkonfiguration.
3. Global modulkonfiguration
Den globale modulkonfiguration findes under:
bx_Mod/config_own.phpDenne fil indeholder de individuelle indstillinger for dit projekt. Den oprettes efter installationen i henhold til brugerens krav.
Her fastlægges blandt andet, hvilke moduler og områder der skal anvendes, eksempelvis butik eller blog. Desuden tages de aktiverede sprog i betragtning.
Konfigurationen udgør dermed en vigtig grundlag for oprettelsen af de sprogafhængige JavaScript-filer.
4. Modulkonfigurationer og sprog-filer
Ved oprettelsen tager CMS'en hensyn til konfigurationsfilerne for de respektive moduler. Dette inkluderer standardkonfigurationen, individuelle tilpasninger og sprogafhængige tekster.
Eksemplet med butikmodulet er som følger:
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.phpFilerne udfører forskellige opgaver:
config.php: Indeholder standardkonfigurationen for butikmodulet.
config_own.php: Indeholder dine individuelle konfigurationse indstillinger.
config_text_de.php: Indeholder de standard tyske tekster for butikmodulet.
config_text_de_own.php: Indeholder dine individuelle tilpasninger af de tyske tekster.
For andre aktiverede sprog tages de relevante sprog filer i betragtning.
Forsøg ikke at ændre standardfilerne direkte. Brug de tilsigtede _own-filer til individuelle tilpasninger, så dine ændringer bevares ved almindelige CMS-opdateringer.
5. Standard-JavaScript og egne tilpasninger
De almindelige JavaScript-filer findes i udviklermappen bx_script.
Følgende filer tages i betragtning for de centrale JavaScript-funktioner:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js er standardfilen for bluetronix CMS. Den kan blive overskrevet ved systemopdateringer.
Filene BxScript_own.js og BxScript_own_min.js er beregnet til individuelle tilpasninger.
Disse filer kan tages i betragtning ved oprettelsen af de sprogafhængige JavaScript-filer.
6. Header-JavaScript og egne tilpasninger
Udover de almindelige JavaScript-filer findes der separate filer til headeren på din hjemmeside.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js indeholder de header-JavaScript-funktioner, der stilles til rådighed af CMS. Denne standardfil kan blive overskrevet ved en systemopdatering.
For egne tilpasninger er BxHeadScript_own.js og BxHeadScript_own_min.js tilgængelige.
Der oprettes også de relevante sprogafhængige versioner fra disse filer.
7. Genererede JavaScript-filer
Fra de eksisterende konfigurations-, sprog- og JavaScript-filer opretter CMS separate filer for hvert aktiveret sprog.
For eksempel genereres følgende almindelige JavaScript-filer:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsDerudover oprettes de relevante header-JavaScript-filer:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsSprogkoderne angiver det pågældende sprog. For eksempel står de for tysk, en for engelsk, ru for russisk, og es for spansk.
CMS genererer kun filerne for de faktisk aktiverede sprog.
8. Optimering af de genererede JavaScript-filer
Under oprettelsen optimeres JavaScript-filerne yderligere. Dette kan fjerne unødvendige kommentarer og overflødige mellemrum.
Den enkle optimering omfatter følgende trin:
1. Linjer, der begynder med //, fjernes.
2. Linjer, der kun indeholder mellemrum, fjernes.
3. Flere mellemrum kan erstattes med et enkelt mellemrum.
En fuldstændig minificering er i øjeblikket ikke strengt nødvendig.
Optimeringen reducerer unødvendigt indhold i de genererede JavaScript-filer.
9. Automatisk integration af sprogafhængige JavaScript-filer
Det bluetronix CMS tjekker, når din hjemmeside genereres, om der findes en tilsvarende JavaScript-fil for det aktuelt valgte sprog.
I HTML-layoutet kan den almindelige JavaScript-fil for eksempel være inkluderet via følgende CMS-markering:
__FV_/bx_script/BxScript_own_min.js__Hvis en besøgende kalder den tyske sprogversion af din hjemmeside, og den tilsvarende sprogfil er tilgængelig, erstatter CMS automatisk markeringen med:
__FV_/bx_script/BxScript_de.js__Det samme princip gælder for header-JavaScript-filen.
Fra:
__FV_/bx_script/BxHeadScript_own_min.js__bliver for eksempel:
__FV_/bx_script/BxHeadScript_de.js__Den eksisterende HTML-integration behøver ikke at blive tilpasset for hvert sprog individualt.
Hvis der ikke findes en passende sprogfil, forbliver den generelle JavaScript-fil inkluderet.
10. Opdater browser-cache ved hjælp af filændringsdato
For at forhindre, at browseren fortsætter med at hente en forældet JavaScript-fil fra cachen efter en ændring, kan CMS'et desuden bruge ændringsdatoen for den pågældende fil.
Den inkluderede JavaScript-fil får derfor en versionsparameter.
Eksempel:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMÆndres filen, kan versionsparameteren også ændres. På den måde kan browseren genkende den ændrede filversion og indlæse den på ny.
Denne metode kan bruges både for de generelle JavaScript-filer og for header-JavaScript-filerne.
11. Resumé
bluetronix CMS opretter automatisk separate JavaScript-filer for hvert aktiveret sprog på din hjemmeside.
Genereringen sker ved hver gemning af en modulkonfiguration. Derudover kan du starte dem manuelt via bx_Mod/BxScript.php.
Ved oprettelsen tages der højde for den globale modulkonfiguration, konfigurations- og sprogfilene for modulerne, samt standard- og egne JavaScript-filer.
I layoutet genkender CMS'et automatisk, om der findes en passende sprogfil, og inkluderer denne i stedet for den generelle JavaScript-fil.
Brug generelt de tilsigtede _own-filer til individuelle tilpasninger, så dine ændringer forbliver ved normale systemopdateringer.
FAQ
hvad kunder ofte spørger os
Hvornår oprettes sprogafhængige JavaScript-filer?
bluetronix CMS genererer filerne automatisk, så snart du gemmer en modulkonfiguration. Herunder bliver JavaScript-filerne genskabt for alle aktiverede sprog.
Hvordan kan jeg manuelt generere JavaScript-filerne igen?
Som administrator skal du gå til adressen https://xxxx.bxserver.net/bx_Mod/BxScript.php. Erstat eksempel-domenet med adressen til dit CMS.
Bliver JavaScript-filer oprettet for alle tilgængelige sprog?
Nej. CMS'et opretter udelukkende sprogversionerne, som du har aktiveret via modulet Lang. De relevante indstillinger fastlægges i bx_Mod/config_own.php.
Bliver JavaScript-filerne ændret ved skift af farvesæt eller layout?
Nej. Farvesættet eller layoutet ændrer ikke længere JavaScript-filerne. Den automatiske genskabelse finder sted ved gemning af en modulkonfiguration.
Hvilke filer kan jeg tilpasse individuelt?
Til individuelle JavaScript-tilpasninger har du blandt andet adgang til BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js og BxHeadScript_own_min.js. Modulerne har også egne konfigurations- og sprogfil med betegnelsen _own.
Hvad sker der med standard-JavaScript-filerne ved en CMS-opdatering?
Standardfilerne BxScript.js og BxHeadScript.js kan blive overskrevet ved systemopdateringer. Derfor bør du kun gemme egne ændringer i de tilsigtede _own-filer.
Hvordan genkender CMS'et, hvilken JavaScript-fil der skal inkluderes?
CMS'et kontrollerer ved oprettelse af hjemmesiden, om der findes en tilsvarende JavaScript-fil for det aktuelt valgte sprog. Hvis der for eksempel findes BxScript_de.js, vil denne blive inkluderet for den tyske sprogversion i stedet for den generelle fil.
Hvordan forhindrer jeg, at besøgende indlæser forældede JavaScript-filer fra browserens cache?
CMS'et kan desuden bruge filens ændringsdato som versionsparameter ved indlæsningen af JavaScript-filer. Dette gør det muligt for browseren at hente den nye filversion efter en ændring.