Luodaan kieliriippuvaisia JavaScript-tiedostoja CMS-moduuleille
Bluetronix CMS luo automaattisesti optimoituja JavaScript-tiedostoja jokaiselle verkkosivustosi aktivoimalle kielelle. Opit, miten oletustiedostot, yksilölliset mukautukset ja kieliriippuvaiset moduulitekstit yhdistetään ja miten CMS liittää oikeat tiedostot automaattisesti verkkosivustollesi.
Kieliriippuvaiset JavaScript-tiedostot
bluetronix CMS voi luoda jokaiselle aktivoidulle verkkosivustosi kielelle omat JavaScript-tiedostot. Näin kielikohtaiset tekstit ja toiminnot ovat suoraan saatavilla kyseisessä JavaScript-tiedostossa.
Tarvittavat tiedostot luodaan automaattisesti, kun tallennat moduulikokoonpanon. CMS ottaa huomioon sekä oletustiedostot että omat muokkaukset.
Tämä opas perustuu asiakirjaan „CMS-moduulien lisääminen ja muokkaaminen“. Sinun tulisi olla jo tuttava kehittäjähakemiston bx_Mod ja omien _own-tiedostojen käytön kanssa.
1. JavaScript-tiedostojen automaattinen luominen
Kun tallennat moduulikokoonpanon, CMS luo automaattisesti kaikki tarvittavat kielikohtaiset JavaScript-tiedostot uudelleen.
Luodaan vain ne kieliversiot, jotka olet aktivoinut Lang-moduulin kautta.
Aktivoidut kielet määritellään globaalissa moduulikokoonpanossa:
bx_Mod/config_own.phpEsimerkiksi jos olet aktivoinut saksan, englannin ja espanjan, CMS luo vastaavat JavaScript-tiedostot näille kolmelle kielelle.
Värisetin tai asettelun vaihto ei enää muuta JavaScript-tiedostoja. Automaattinen uudelleenluonti tapahtuu moduulikokoonpanon tallentamisen yhteydessä.
2. JavaScript-tiedostojen manuaalinen luominen
Lisäksi automaattisen luomisen lisäksi voit käsin luoda kielikohtaisia JavaScript-tiedostoja.
Kutsu tätä varten seuraavaa osoitetta ylläpitäjänä. Korvaa esimerkkidomain CMS:si osoitteella:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpTämän kutsun kautta voit luoda JavaScript-tiedostot uudelleen riippumatta moduulikokoonpanon tallentamisesta.
3. Globaali moduulikokoonpano
Globaali moduulikokoonpano sijaitsee osoitteessa:
bx_Mod/config_own.phpTämä tiedosto sisältää projektisi yksilölliset asetukset. Se määritellään asennuksen jälkeen käyttäjän vaatimusten mukaan.
Tässä määritellään muun muassa, mitä moduuleja ja alueita käytetään, esimerkiksi kauppa tai blogi. Lisäksi otetaan huomioon aktivoidut kielet.
Kokoonpano toimii näin ollen tärkeänä perustana kielikohtaisten JavaScript-tiedostojen luomiselle.
4. Moduulikokoonpanot ja kielitiedostot
Luonnissa CMS ottaa huomioon kunkin moduulin kokoonpanotiedostot. Näihin sisältyvät oletusasetukset, yksilölliset muokkaukset ja kielikohtaiset tekstit.
Kauppamoduulin esimerkillä nämä ovat:
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.phpTiedostoilla on erilaisia tehtäviä:
config.php: Sisältää kauppamoduulin oletusasetukset.
config_own.php: Sisältää omat kokoonpanoyksityiskohtasi.
config_text_de.php: Sisältää kauppamoduulin saksankieliset oletustekstit.
config_text_de_own.php: Sisältää saksankielisten tekstien yksilölliset muokkaukset.
Lisäksi otetaan huomioon vastaavat kielitiedostot muille aktivoiduille kielille.
Älä muokkaa oletustiedostoja suoraan niin paljon kuin mahdollista. Käytä yksilöllisiin muokkauksiin tarkoitettuja _own-tiedostoja, jotta muutoksesi säilyvät normaalien CMS-päivitysten aikana.
5. Oletus-JavaScript ja omat mukautukset
Yleiset JavaScript-tiedostot sijaitsevat kehittäjäkansiossa bx_script.
Keskitetyt JavaScript-toiminnot otetaan huomioon seuraavissa tiedostoissa:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js on bluetronix CMS:n oletustiedosto. Se voidaan ylittää järjestelmän päivitysten aikana.
Tiedostot BxScript_own.js ja BxScript_own_min.js on tarkoitettu yksilöllisiin muokkauksiin.
Näitä tiedostoja voidaan käyttää kieliriippuvaisten JavaScript-tiedostojen luomisessa.
6. Otsikkotiedostot ja omat mukautukset
Yleisten JavaScript-tiedostojen lisäksi on erillisiä tiedostoja verkkosivusi otsikkoa varten.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js sisältää CMS:n tarjoamat otsikkon JavaScript-toiminnot. Tämä oletustiedosto voidaan ylittää järjestelmäpäivityksen aikana.
Oma muokkausmahdollisuus on saatavilla tiedostoissa BxHeadScript_own.js ja BxHeadScript_own_min.js.
Myös näistä tiedostoista luodaan vastaavat kieliriippuvaiset versiot.
7. Luodut JavaScript-tiedostot
CMS luo nykyisistä asetuksesta, kielestä ja JavaScript-tiedostoista erilliset tiedostot jokaiselle aktivoidulle kielelle.
Esimerkiksi seuraavat yleiset JavaScript-tiedostot syntyvät:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsLisäksi luodaan vastaavat otsikkon JavaScript-tiedostot:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsKielikoodit merkitsevät vastaavaa kieltä. Esimerkiksi de tarkoittaa saksaa, en englantia, ru venäjää ja es espanjaa.
CMS luo vain tiedostoja, jotka ovat todella aktivoiduilla kielillä.
8. Luotujen JavaScript-tiedostojen optimointi
Luonnin yhteydessä JavaScript-tiedostoja optimoidaan lisäksi. Näin voidaan poistaa tarpeettomat kommentit ja ylimääräiset välilyönnit.
Yksinkertainen optimointi kattaa seuraavat vaiheet:
1. Rivien, jotka alkavat //, poistaminen.
2. Rivien, jotka sisältävät vain välilyöntejä, poistaminen.
3. Useat välilyönnit voidaan korvata yhdellä välilyönnillä.
Täydellinen minimointi ei ole tällä hetkellä ehdottomasti tarpeellista.
Optimointi vähentää tarpeettomia sisältöjä luoduissa JavaScript-tiedostoissa.
9. Kieliriippuvaisten JavaScript-tiedostojen automaattinen liittäminen
Bluetronix CMS tarkistaa verkkosivusi luomisen yhteydessä, onko nykyiselle valitulle kielelle olemassa vastaavaa JavaScript-tiedostoa.
HTML-muotoilussa yleinen JavaScript-tiedosto voidaan esimerkiksi liittää seuraavalla CMS-merkinnällä:
__FV_/bx_script/BxScript_own_min.js__Kun vierailija avaa verkkosivusi saksalaisen kieliversion ja vastaava kielitiedosto on olemassa, CMS korvää automaattisesti merkinnän seuraavalla:
__FV_/bx_script/BxScript_de.js__Sama periaate pätee otsikkon JavaScript-tiedostoon.
Lähteestä:
__FV_/bx_script/BxHeadScript_own_min.js__tulee esimerkiksi:
__FV_/bx_script/BxHeadScript_de.js__Nykyistä HTML-liitännäistä ei tarvitse muokata erikseen jokaiselle kielelle.
Jos sopivaa kielitiedostoa ei ole saatavilla, yleinen JavaScript-tiedosto pysyy käytössä.
10. Selainvälimuistin päivittäminen tiedoston muutospäivämäärän avulla
Jotta selaimet eivät ladattaisi vanhentunutta JavaScript-tiedostoa välimuistista muutosten jälkeen, CMS voi lisäksi käyttää kunkin tiedoston muuttamispäivämäärää.
Liitetylle JavaScript-tiedostolle annetaan versiotunnus.
Esimerkki:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMJos tiedosto muuttuu, myös versiotunnus voi muuttua. Tällä tavalla selain tunnistaa muuttuneen tiedostoversion ja voi ladata sen uudelleen.
Tätä menetelmää voidaan käyttää sekä yleisille JavaScript-tiedostoille että header-JavaScript-tiedostoille.
11. Yhteenveto
bluetronix CMS luo automaattisesti erilliset JavaScript-tiedostot jokaiselle aktivoidulle kielelle verkkosivustollasi.
Luominen tapahtuu jokaisen moduulin konfiguroinnin tallentamisen yhteydessä. Voit myös käynnistää sen manuaalisesti bx_Mod/BxScript.php kautta.
Luomisprosessissa otetaan huomioon globaali moduulin konfiguraatio, moduulien konfiguraatio- ja kielitiedostot sekä oletus- ja omat JavaScript-tiedostot.
Ulkoasussa CMS tunnistaa automaattisesti, onko sopivaa kielitiedostoa saatavilla, ja liittää sen yleisen JavaScript-tiedoston sijaan.
Käytä yksilöllisissä mukautuksissa aina tarkoitukseen varattuja _own-tiedostoja, jotta muutoksesi säilyvät normaalien järjestelmäpäivitysten yhteydessä.
UKK
mitä asiakkaat meiltä usein kysyvät
Milloin kieliriippuvaisia JavaScript-tiedostoja luodaan?
bluetronix CMS luo tiedostot automaattisesti heti, kun tallennat moduulin konfiguraation. Tällöin JavaScript-tiedostot luodaan uusiksi kaikille aktivoiduille kielille.
Miten voin luoda JavaScript-tiedostot manuaalisesti uudelleen?
Kirjaudu järjestelmänvalvojana osoitteeseen https://xxxx.bxserver.net/bx_Mod/BxScript.php. Korvaa esimerkkidomain CMS:si osoitteella.
Luoeko JavaScript-tiedostot kaikille saatavilla oleville kielille?
Ei. CMS luo vain kieliversiot, jotka olet aktivoitunut moduulin Lang kautta. Asiaankuuluvat asetukset voidaan määrittää tiedostossa bx_Mod/config_own.php.
Muutetaanko JavaScript-tiedostoja värisettien tai ulkoasujen vaihtuessa?
Ei. Värisetti tai ulkoasu ei muuta JavaScript-tiedostoja. Automaattinen uudelleenluonti tapahtuu moduulin konfiguraation tallentamisen yhteydessä.
Mitä tiedostoja voin mukauttaa?
Yksilöllisiin JavaScript-mukautuksiin ovat käytettävissä muun muassa tiedostot BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js ja BxHeadScript_own_min.js. Myös moduuleilla on omat konfiguraatio- ja kielitiedostonsa, joissa on merkintä _own.
Mitä tapahtuu vakio-JavaScript-tiedostoille CMS-päivityksen yhteydessä?
Vakiotiedostot BxScript.js ja BxHeadScript.js voivat ylikirjoittua järjestelmäpäivityksissä. Siksi sinun tulisi tallentaa omat muutoksesi vain tarkoitukseen varattuihin _own-tiedostoihin.
Miten CMS tunnistaa, mikä JavaScript-tiedosto on liitettävä?
CMS tarkistaa verkkosivuston luomisen yhteydessä, onko nykyiselle valitulle kielelle olemassa vastaavaa JavaScript-tiedostoa. Jos esimerkiksi BxScript_de.js on olemassa, se liitetään saksaksi verkkoversioksi yleisen tiedoston sijaan.
Miten estän, että kävijät lataavat vanhentuneita JavaScript-tiedostoja selaimen välimuistista?
CMS voi käyttää JavaScript-tiedostojen liittämisessä tiedoston muutospäivämäärää versiona. Tällöin selain voi ladata uuden tiedostoversion muutoksen jälkeen.