Creare file JavaScript dipendenti dalla lingua per i moduli CMS
Il CMS bluetronix genera automaticamente file JavaScript ottimizzati per ogni lingua attivata del tuo sito web. Imparerai come vengono fusi i file standard, le personalizzazioni individuali e i testi dei moduli dipendenti dalla lingua e come il CMS integra automaticamente i file appropriati nel tuo sito.
File JavaScript dipendenti dalla lingua
Il CMS bluetronix può generare file JavaScript distinti per ogni lingua attivata del tuo sito web. In questo modo, i testi e le funzionalità dipendenti dalla lingua sono direttamente disponibili all'interno del rispettivo file JavaScript.
I file necessari vengono creati automaticamente non appena salvi una configurazione del modulo. Il CMS considera sia i file di base sia le tue personalizzazioni individuali.
Questo tutorial si basa sulla documentazione “Integrazione e personalizzazione dei moduli CMS”. Dovresti già essere familiare con la cartella dello sviluppatore bx_Mod e con l'uso dei tuoi file _own.
1. Creazione automatica dei file JavaScript
Quando salvi una configurazione del modulo, il CMS rigenera automaticamente tutti i file JavaScript necessari per la lingua.
Vengono creati esclusivamente le versioni linguistiche che hai attivato tramite il modulo Lang.
Le lingue attivate vengono stabilite tramite la configurazione globale del modulo:
bx_Mod/config_own.phpSe ad esempio hai attivato il tedesco, l'inglese e lo spagnolo, il CMS crea file JavaScript appropriati per queste tre lingue.
Un cambio del set di colori o del layout non modifica più i file JavaScript. La rigenerazione automatica avviene al momento del salvataggio di una configurazione del modulo.
2. Creare file JavaScript manualmente
In aggiunta alla generazione automatica, puoi creare manualmente i file JavaScript dipendenti dalla lingua.
Per fare ciò, come amministratore, visita il seguente indirizzo. Sostituisci il dominio di esempio con l'indirizzo del tuo CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpCon questa chiamata, puoi rigenerare i file JavaScript indipendentemente dal salvataggio di una configurazione del modulo.
3. Configurazione globale del modulo
La configurazione globale del modulo si trova in:
bx_Mod/config_own.phpQuesto file contiene le impostazioni individuali del tuo progetto. Viene configurato dopo l'installazione in base alle esigenze dell'utente.
Qui vengono stabiliti, tra l'altro, quali moduli e aree devono essere utilizzati, ad esempio negozio o blog. Inoltre, vengono considerate le lingue attivate.
La configurazione costituisce quindi una base importante per la generazione dei file JavaScript dipendenti dalla lingua.
4. Configurazioni dei moduli e file di lingua
Nella generazione, il CMS considera i file di configurazione dei rispettivi moduli. Ciò include la configurazione standard, le personalizzazioni individuali e i testi dipendenti dalla lingua.
Nel caso del modulo negozio, questi sono:
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.phpI file svolgono compiti diversi:
config.php: Contiene la configurazione standard del modulo negozio.
config_own.php: Contiene le tue impostazioni di configurazione individuali.
config_text_de.php: Contiene i testi standard in lingua tedesca del modulo negozio.
config_text_de_own.php: Contiene le tue personalizzazioni dei testi in lingua tedesca.
Per ulteriori lingue attivate, vengono considerati i file di lingua corrispondenti.
Non modificare direttamente i file di default. Utilizza i file _own previsti per personalizzazioni, in modo che le tue modifiche vengano mantenute durante gli aggiornamenti normali del CMS.
5. JavaScript standard e adattamenti individuali
I file JavaScript generali si trovano nella cartella sviluppatore bx_script.
Per le funzioni JavaScript centrali vengono considerati i seguenti file:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js è il file di default del CMS bluetronix. Può essere sovrascritto durante gli aggiornamenti di sistema.
I file BxScript_own.js e BxScript_own_min.js sono destinati per personalizzazioni individuali.
Questi file possono essere considerati nella generazione dei file JavaScript dipendenti dalla lingua.
6. JavaScript di intestazione e adattamenti individuali
Oltre ai file JavaScript generali, ci sono file separati per l'intestazione del tuo sito web.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js contiene le funzioni JavaScript di intestazione fornite dal CMS. Questo file di default può essere sovrascritto durante un aggiornamento di sistema.
Per personalizzazioni, hai a disposizione BxHeadScript_own.js e BxHeadScript_own_min.js.
Anche da questi file vengono generate le relative versioni dipendenti dalla lingua.
7. File JavaScript generati
Dal file di configurazione, lingua e JavaScript esistenti il CMS genera file separati per ciascuna lingua attivata.
Ad esempio, si creano i seguenti file JavaScript generali:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsInoltre, vengono creati i corrispondenti file JavaScript di intestazione:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsLe sigle delle lingue indicano la rispettiva lingua. Ad esempio, de sta per tedesco, en per inglese, ru per russo e es per spagnolo.
Il CMS genera solo i file per le lingue effettivamente attivate.
8. Ottimizzazione dei file JavaScript generati
Durante la generazione, i file JavaScript vengono inoltre ottimizzati. Ciò consente di rimuovere commenti non necessari e spazi vuoti superflui.
L'ottimizzazione semplice comprende i seguenti passaggi:
1. Le righe che iniziano con // vengono rimosse.
2. Le righe che contengono esclusivamente spazi vuoti vengono rimosse.
3. Più spazi vuoti possono essere sostituiti con uno spazio singolo.
Una minificazione completa non è attualmente necessaria.
L'ottimizzazione riduce i contenuti non necessari all'interno dei file JavaScript generati.
9. Integrazione automatica dei file JavaScript dipendenti dalla lingua
Il CMS bluetronix verifica durante la generazione del tuo sito web se esiste un file JavaScript corrispondente per la lingua attualmente selezionata.
Nel layout HTML, ad esempio, il file JavaScript generale può essere incluso tramite il seguente tag CMS:
__FV_/bx_script/BxScript_own_min.js__Se il visitatore accede alla versione in lingua tedesca del tuo sito web e il file di lingua corrispondente è presente, il CMS sostituisce automaticamente il tag con:
__FV_/bx_script/BxScript_de.js__Lo stesso principio vale per il file JavaScript dell'intestazione.
Da:
__FV_/bx_script/BxHeadScript_own_min.js__diventa per esempio:
__FV_/bx_script/BxHeadScript_de.js__Non è necessario adattare separatamente l'integrazione HTML esistente per ogni lingua.
Se non è presente un file linguistico adatto, rimane collegato il file JavaScript generale.
10. Aggiornare la cache del browser tramite la data di modifica del file
Affinché i browser non carichino una versione obsoleta del file JavaScript dalla cache dopo una modifica, il CMS può utilizzare la data di modifica del rispettivo file.
Il file JavaScript integrato riceverà un parametro di versione.
Esempio:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMSe il file viene modificato, può cambiare anche il parametro di versione. In questo modo il browser riconosce la versione del file modificata e può ricaricarla.
Questo procedimento può essere utilizzato sia per i file JavaScript generali che per i file JavaScript dell'intestazione.
11. Riepilogo
Il CMS bluetronix crea automaticamente file JavaScript separati per ogni lingua attivata del tuo sito web.
La generazione avviene ogni volta che salvi una configurazione del modulo. Inoltre, puoi avviarla manualmente tramite bx_Mod/BxScript.php.
Durante la creazione vengono presi in considerazione la configurazione globale del modulo, i file di configurazione e i file linguistici dei moduli, nonché i file JavaScript standard e personalizzati.
Nel layout, il CMS riconosce automaticamente se è presente un file linguistico adeguato e lo integra al posto del file JavaScript generale.
Per personalizzazioni individuali, utilizza sempre i file _own previsti, affinché le tue modifiche vengano mantenute durante gli aggiornamenti di sistema.
FAQ
cosa ci chiedono spesso i clienti
Quando vengono generati i file JavaScript dipendenti dalla lingua?
Il CMS bluetronix genera i file automaticamente non appena salvi una configurazione del modulo. Durante questo processo, i file JavaScript vengono ricreati per tutte le lingue attivate.
Come posso ricreare manualmente i file JavaScript?
Accedi come amministratore all'indirizzo https://xxxx.bxserver.net/bx_Mod/BxScript.php. Sostituisci il dominio di esempio con l'indirizzo del tuo CMS.
Vengono generati i file JavaScript per tutte le lingue disponibili?
No. Il CMS crea esclusivamente le versioni linguistiche che hai attivato tramite il modulo Lang. Le impostazioni corrispondenti vengono definite in bx_Mod/config_own.php.
I file JavaScript vengono modificati durante il cambio di set di colori o layout?
No. Il set di colori o il layout non modificano più i file JavaScript. La ricreazione automatica avviene al salvataggio di una configurazione del modulo.
Quali file posso personalizzare individualmente?
Per modifiche individuali ai file JavaScript, hai a disposizione BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js e BxHeadScript_own_min.js. Anche i moduli dispongono di propri file di configurazione e linguistici contrassegnati con _own.
Cosa succede con i file JavaScript standard durante un aggiornamento del CMS?
I file standard BxScript.js e BxHeadScript.js possono essere sovrascritti durante gli aggiornamenti di sistema. Pertanto, dovresti salvare le tue modifiche esclusivamente nei file _own previsti.
Come riconosce il CMS quale file JavaScript deve essere integrato?
Il CMS verifica al momento della creazione della pagina web se è presente un file JavaScript corrispondente per la lingua attualmente selezionata. Se ad esempio esiste BxScript_de.js, questo verrà incluso per la versione in tedesco anziché il file generale.
Come posso impedire che i visitatori carichino file JavaScript obsoleti dalla cache del browser?
Il CMS può utilizzare anche la data di modifica del file come parametro di versione al momento dell'inclusione dei file JavaScript. In questo modo, il browser può caricare la nuova versione del file dopo una modifica.