Créer des fichiers JavaScript dépendants de la langue pour les modules CMS
Le CMS bluetronix génère automatiquement des fichiers JavaScript optimisés pour chaque langue activée de ton site web. Tu apprendras comment les fichiers standards, les ajustements individuels et les textes de module dépendants de la langue sont réunis et comment le CMS intègre automatiquement les fichiers appropriés dans ton site web.
Fichiers JavaScript dépendants de la langue
Le CMS bluetronix peut générer des fichiers JavaScript propres à chaque langue activée de votre site web. Ainsi, les textes et fonctions dépendants de la langue sont directement disponibles dans le fichier JavaScript concerné.
Les fichiers nécessaires sont créés automatiquement dès que vous enregistrez une configuration de module. Le CMS prend en compte à la fois les fichiers par défaut et vos personnalisations individuelles.
Ce tutoriel s'appuie sur la documentation "Intégrer et personnaliser des modules CMS". Vous devriez déjà être familiarisé avec le dossier développeur bx_Mod et l'utilisation de vos propres fichiers _own.
1. Génération automatique des fichiers JavaScript
Lorsque vous enregistrez une configuration de module, le CMS régénère automatiquement tous les fichiers JavaScript dépendants de la langue nécessaires.
Seules les versions linguistiques activées via le module Lang sont créées.
Les langues activées sont définies par la configuration globale du module :
bx_Mod/config_own.phpSi vous avez par exemple activé l'allemand, l'anglais et l'espagnol, le CMS créera des fichiers JavaScript correspondants pour ces trois langues.
Un changement de jeux de couleurs ou de mise en page n'affecte plus les fichiers JavaScript. La régénération automatique se produit lors de l'enregistrement d'une configuration de module.
2. Générer manuellement des fichiers JavaScript
En plus de la génération automatique, vous pouvez également faire créer manuellement les fichiers JavaScript dépendants de la langue.
Pour ce faire, en tant qu'administrateur, ouvrez l'adresse suivante. Remplacez le domaine exemple par l'adresse de votre CMS :
https://xxxx.bxserver.net/bx_Mod/BxScript.phpVia cet appel, vous pouvez régénérer les fichiers JavaScript indépendamment de l'enregistrement d'une configuration de module.
3. Configuration globale du module
La configuration globale du module se trouve sous :
bx_Mod/config_own.phpCe fichier contient les paramètres individuels de votre projet. Il est configuré après l'installation en fonction des besoins de l'utilisateur.
Ici, il est notamment déterminé quels modules et sections doivent être utilisés, par exemple la boutique ou le blog. En outre, les langues activées sont prises en compte.
La configuration constitue donc une base importante pour la génération des fichiers JavaScript dépendants de la langue.
4. Configurations de module et fichiers de langue
Lors de la génération, le CMS prend en compte les fichiers de configuration des modules respectifs. Cela inclut la configuration par défaut, les ajustements individuels et les textes dépendants de la langue.
Prenons l'exemple du module boutique :
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.phpLes fichiers remplissent différentes fonctions :
config.php : Contient la configuration par défaut du module boutique.
config_own.php : Contient vos paramètres de configuration individuels.
config_text_de.php : Contient les textes standard en allemand du module boutique.
config_text_de_own.php : Contient vos ajustements individuels des textes en allemand.
Pour d'autres langues activées, les fichiers linguistiques correspondants sont pris en compte.
Essayez de ne pas modifier directement les fichiers par défaut. Utilisez les fichiers _own prévus pour les ajustements individuels afin que vos modifications soient conservées lors des mises à jour normales du CMS.
5. JavaScript par défaut et personnalisations propres
Les fichiers JavaScript généraux se trouvent dans le dossier développeur bx_script.
Pour les fonctions JavaScript centrales, les fichiers suivants sont pris en compte :
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js est le fichier standard du CMS bluetronix. Il peut être écrasé lors de mises à jour du système.
Les fichiers BxScript_own.js et BxScript_own_min.js sont prévus pour des ajustements individuels.
Ces fichiers peuvent être pris en compte lors de la génération des fichiers JavaScript dépendants de la langue.
6. JavaScript d'en-tête et personnalisations propres
En plus des fichiers JavaScript généraux, il existe des fichiers séparés pour l'en-tête de votre site web.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js contient les fonctions JavaScript d'en-tête fournies par le CMS. Ce fichier standard peut être écrasé lors d'une mise à jour du système.
Pour vos propres ajustements, vous avez à votre disposition BxHeadScript_own.js et BxHeadScript_own_min.js.
Les versions dépendantes de la langue correspondantes sont également générées à partir de ces fichiers.
7. Fichiers JavaScript générés
À partir des fichiers de configuration, de langue et de JavaScript existants, le CMS génère des fichiers séparés pour chaque langue activée.
Par exemple, les fichiers JavaScript généraux suivants sont créés :
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsDe plus, les fichiers JavaScript d'en-tête correspondants sont créés :
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsLes abréviations linguistiques désignent la langue respective. Par exemple, de signifie allemand, en signifie anglais, ru signifie russe et es signifie espagnol.
Le CMS génère seulement les fichiers pour les langues effectivement activées.
8. Optimisation des fichiers JavaScript générés
Lors de la génération, les fichiers JavaScript sont également optimisés. Cela permet de supprimer les commentaires inutiles et les espaces superflus.
L'optimisation simple comprend les étapes suivantes :
1. Les lignes commençant par // sont supprimées.
2. Les lignes contenant uniquement des espaces sont supprimées.
3. Plusieurs espaces peuvent être remplacés par un seul espace.
Une minification complète n'est pas nécessaire pour le moment.
L'optimisation réduit les contenus inutiles dans les fichiers JavaScript générés.
9. Inclusion automatique des fichiers JavaScript dépendants de la langue
Le CMS bluetronix vérifie lors de la génération de votre site web si un fichier JavaScript correspondant est disponible pour la langue actuellement sélectionnée.
Dans la mise en page HTML, par exemple, le fichier JavaScript général peut être intégré par le biais de la balise CMS suivante :
__FV_/bx_script/BxScript_own_min.js__Lorsque le visiteur accède à la version allemande de votre site web et que le fichier de langue correspondant est disponible, le CMS remplace automatiquement la balise par :
__FV_/bx_script/BxScript_de.js__Le même principe s'applique pour le fichier JavaScript d'en-tête.
De:
__FV_/bx_script/BxHeadScript_own_min.js__deviendra par exemple:
__FV_/bx_script/BxHeadScript_de.js__L'intégration HTML existante n'a pas besoin d'être adaptée séparément pour chaque langue.
Si aucun fichier de langue approprié n'est disponible, le fichier JavaScript général reste intégré.
10. Mettre à jour le cache du navigateur par la date de modification des fichiers
Pour que les navigateurs ne chargent pas une ancienne version du fichier JavaScript à partir du cache après une modification, le CMS peut également utiliser la date de modification du fichier en question.
Le fichier JavaScript intégré reçoit un paramètre de version.
Exemple :
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMSi le fichier change, le paramètre de version peut également changer. Cela permet au navigateur de reconnaître la version modifiée du fichier et de la recharger.
Cette méthode peut être utilisée à la fois pour les fichiers JavaScript généraux et pour les fichiers JavaScript d'en-tête.
11. Résumé
Le CMS bluetronix crée automatiquement des fichiers JavaScript séparés pour chaque langue activée de votre site web.
La génération a lieu à chaque sauvegarde d'une configuration de module. De plus, vous pouvez la démarrer manuellement via bx_Mod/BxScript.php.
Lors de la création, la configuration globale du module, les fichiers de configuration et de langue des modules, ainsi que les fichiers JavaScript standards et personnalisés sont pris en compte.
Dans la mise en page, le CMS reconnaît automatiquement si un fichier de langue correspondant est disponible et l'intègre à la place du fichier JavaScript général.
Pour des ajustements individuels, utilisez toujours les fichiers _own prévus, afin que vos modifications soient conservées lors des mises à jour système normales.
FAQ
ce que nos clients nous demandent souvent
Quand les fichiers JavaScript dépendants de la langue sont-ils générés ?
Le CMS bluetronix génère les fichiers automatiquement dès que vous enregistrez une configuration de module. Les fichiers JavaScript sont recréés pour toutes les langues activées.
Comment puis-je régénérer manuellement les fichiers JavaScript ?
En tant qu'administrateur, accédez à l'adresse https://xxxx.bxserver.net/bx_Mod/BxScript.php. Remplacez le domaine d'exemple par l'adresse de votre CMS.
Des fichiers JavaScript sont-ils générés pour toutes les langues disponibles ?
Non. Le CMS crée uniquement les versions linguistiques que vous avez activées via le module Lang. Les paramètres correspondants sont définis dans bx_Mod/config_own.php.
Les fichiers JavaScript sont-ils modifiés lors du changement de jeu de couleurs ou de disposition ?
Non. Le jeu de couleurs ou la disposition ne modifient plus les fichiers JavaScript. La régénération automatique a lieu lors de la sauvegarde d'une configuration de module.
Quels fichiers puis-je personnaliser ?
Pour des ajustements JavaScript individuels, vous avez accès notamment à BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js et BxHeadScript_own_min.js. Les modules disposent également de leurs propres fichiers de configuration et linguistiques marqués _own.
Que se passe-t-il avec les fichiers JavaScript par défaut lors d'une mise à jour du CMS ?
Les fichiers par défaut BxScript.js et BxHeadScript.js peuvent être écrasés lors des mises à jour du système. Par conséquent, vous devriez enregistrer vos propres modifications uniquement dans les fichiers _own prévus à cet effet.
Comment le CMS sait-il quel fichier JavaScript doit être inclus ?
Le CMS vérifie lors de la génération de la page Web si un fichier JavaScript correspondant est présent pour la langue actuellement choisie. Par exemple, si BxScript_de.js existe, il sera inclus pour la version allemande à la place du fichier général.
Comment empêcher les visiteurs de charger des fichiers JavaScript obsolètes à partir du cache du navigateur ?
Le CMS peut également utiliser la date de modification du fichier comme paramètre de version lors de l'inclusion des fichiers JavaScript. Cela permet au navigateur de charger la nouvelle version du fichier après une modification.