Språkavhengige JavaScript-filer for CMS-moduler opprette

Språkavhengige JavaScript-filer

bluetrionix CMS kan generere egne JavaScript-filer for hvert aktivert språk på nettstedet ditt. Dermed blir språkspesifikke tekster og funksjoner umiddelbart tilgjengelige innenfor den respektive JavaScript-filen.

De nødvendige filene opprettes automatisk så snart du lagrer en modulkonfigurasjon. CMS tar hensyn til både standardfilene og dine individuelle tilpasninger.

Denne veiledningen bygger på dokumentasjonen "Integrere og tilpasse CMS-moduler". Du bør allerede være kjent med utviklermappen bx_Mod og bruken av egne _own-filer.

1. Automatisk generering av JavaScript-filer

Når du lagrer en modulkonfigurasjon, genererer CMS automatisk alle nødvendige språkspesifikke JavaScript-filer på nytt.

Det opprettes kun de språkversjonene du har aktivert via modulen Lang.

De aktiverte språkene bestemmes i den globale modulkonfigurasjonen:

bx_Mod/config_own.php

Hvis du for eksempel har aktivert tysk, engelsk og spansk, lager CMS tilsvarende JavaScript-filer for disse tre språkene.

En endring av fargepalett eller oppsett påvirker ikke JavaScript-filene lenger. Den automatiske gjenopprettingen skjer når du lagrer en modulkonfigurasjon.

2. Generere JavaScript-filer manuelt

I tillegg til den automatiske opprettelsen kan du få de språkspesifikke JavaScript-filene laget manuelt.

Som administrator må du gå til følgende adresse. Erstatt eksempel-domenet med adressen til ditt CMS:

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

Via denne forespørselen kan du gjenopprette JavaScript-filene uavhengig av lagringen av en modulkonfigurasjon.

3. Global modulkonfigurasjon

Den globale modulkonfigurasjonen finner du under:

bx_Mod/config_own.php

Denne filen inneholder de individuelle innstillingene til prosjektet ditt. Den settes opp etter installasjonen i henhold til brukerens krav.

Her fastsettes blant annet hvilke moduler og områder som skal brukes, for eksempel butikk eller blogg. I tillegg tas de aktiverte språkene med.

Konfigurasjonen danner dermed et viktig grunnlag for opprettelsen av språkspesifikke JavaScript-filer.

4. Modulkonfigurasjoner og språklige filer

Ved opprettelsen tar CMS hensyn til konfigurasjonsfilene for de respektive modulene. Dette inkluderer standardkonfigurasjonen, individuelle tilpasninger og språkspesifikke tekster.

Ved eksemplet med butikkmodulen er disse:

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

Filene har forskjellige oppgaver:

config.php: Inneholder standardkonfigurasjonen for butikkmodulen.

config_own.php: Inneholder dine individuelle konfigurasjonsinnstillinger.

config_text_de.php: Inneholder de standard tyskspråklige tekstene for butikkmodulen.

config_text_de_own.php: Inneholder dine individuelle tilpasninger av de tyskspråklige tekstene.

For ytterligere aktiverte språk tas de relevante språkfilene med.

Endre så lite som mulig av standardfilene direkte. Bruk de foreskrevne _own-filene for individuelle tilpasninger, slik at endringene dine bevares ved normale CMS-oppdateringer.

5. Standard-JavaScript og egne tilpasninger

De generelle JavaScript-filene ligger i utviklermappen bx_script.

Følgende filer blir tatt hensyn til for de sentrale JavaScript-funksjonene:

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

BxScript.js er standardfilen for bluetronix CMS. Den kan bli overskrevet ved systemoppdateringer.

Filene BxScript_own.js og BxScript_own_min.js er ment for individuelle tilpasninger.

Disse filene kan bli vurdert ved opprettelsen av språkavhengige JavaScript-filer.

6. Header-JavaScript og egne tilpasninger

I tillegg til de generelle JavaScript-filene finnes det separate filer for headeren til nettsiden din.

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

BxHeadScript.js inneholder de header-JavaScript-funksjonene som tilbys av CMS. Denne standardfilen kan bli overskrevet ved en systemoppdatering.

For egne tilpasninger har du BxHeadScript_own.js og BxHeadScript_own_min.js tilgjengelig.

Også fra disse filene blir de relevante språkavhengige versjonene generert.

7. Genererte JavaScript-filer

Basert på eksisterende konfigurasjons-, språk- og JavaScript-filer genererer CMS separate filer for hvert aktivert språk.

For eksempel oppstår følgende generelle JavaScript-filer:

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

I tillegg opprettes de relevante header-JavaScript-filene:

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

Språkforkortelsene markerer det aktuelle språket. For eksempel står de for tysk, en for engelsk, ru for russisk og es for spansk.

CMS genererer bare filene for de faktisk aktiverte språkene.

8. Optimalisering av de genererte JavaScript-filene

Under opprettelsen blir JavaScript-filene også optimalisert. Dette gjør det mulig å fjerne unødvendige kommentarer og overflødige mellomrom.

Den enkle optimaliseringen omfatter følgende trinn:

1. Linjer som begynner med // blir fjernet.

2. Linjer som kun inneholder mellomrom blir fjernet.

3. Flere mellomrom kan bli erstattet med et enkelt mellomrom.

En fullstendig minifisering er for øyeblikket ikke påkrevd.

Optimaliseringen reduserer unødvendig innhold inne i de genererte JavaScript-filene.

9. Søke språkavhengige JavaScript-filer automatisk

bluetronix CMS sjekker når nettsiden din blir opprettet om det finnes en tilsvarende JavaScript-fil for det aktuelt valgte språket.

I HTML-layoutet kan den generelle JavaScript-filen for eksempel være inkludert via følgende CMS-markering:

__FV_/bx_script/BxScript_own_min.js__

Når besøkende åpner den tyske språkversjonen av nettsiden din og den tilsvarende språkfilen er til stede, erstatter CMS automatisk markeringen med:

__FV_/bx_script/BxScript_de.js__

Det samme prinsippet gjelder for header-JavaScript-filen.

Fra:

__FV_/bx_script/BxHeadScript_own_min.js__

blir for eksempel:

__FV_/bx_script/BxHeadScript_de.js__

Den eksisterende HTML-innlemingen må ikke tilpasses individuelt for hvert språk.

Hvis det ikke finnes en passende språkfil, forblir den generelle JavaScript-filen koblet til.

10. Oppdatere nettleserens cache ved filendringsdato

For at nettlesere ikke skal laste inn en foreldet JavaScript-fil fra cachen etter en endring, kan CMS også bruke endringsdatoen for den aktuelle filen.

Den innlemmede JavaScript-filen får en versjonsparameter for dette.

Eksempel:

BxScript_de.js?v=DATEI_AENDERUNGS_DATUM

Hvis filen endres, kan også versjonsparameteren endres. Dermed gjenkjenner nettleseren den endrede filversjonen og kan laste den inn på nytt.

Denne metoden kan brukes både for de generelle JavaScript-filene og for header-JavaScript-filene.

11. Sammendrag

Bluetronix CMS oppretter automatisk separate JavaScript-filer for hvert aktivert språk på nettsiden din.

Genereringen skjer ved hver lagring av en modulkonfigurasjon. I tillegg kan du starte den manuelt via bx_Mod/BxScript.php.

Ved opprettelsen vurderes den globale modulkonfigurasjonen, konfigurasjons- og språkfilene til modulene, samt standard- og egne JavaScript-filer.

I layoutet gjenkjenner CMS automatisk om det finnes en passende språkfil og innlemmer denne i stedet for den generelle JavaScript-filen.

Bruk alltid de tilsiktede _own-filene for individuelle tilpasninger, slik at endringene dine forblir etter normale systemoppdateringer.