 |  | | | Comme vous l'avez peut-être lu sur XF ou sur xoops.org, la version 1.4 de XOOPS Multilangues est maintenant disponible !
Les changements majeurs
Plusieurs changements ont été apportés avec cette nouvelle version. Voici les principaux :
- Adaptation de XOOPS Multilangues pour supporter XOOPS 2.0.7
- Une constante est maintenant disponible pour représenter le lien pour changer la langue dans une langue spécifique. Par exemple, _LANG_LINK_FRENCH contient le lien pour changer à la langue française;
- Un nouveau paramètre à été ajouté dans le profile des membres : Langue Préférée. Lorsqu'un utilisateur n'est pas connecté (Anonyme), le hack utilisera la langue sélectionnée dans le cookie. Si l'utilisateur est connecté, la langue du profile sera utilisé. Aussi, si l'utilisateur connecté change de langue au moyen du bloc de Langue, son profil est autmatiquement mis à jour.
- Ajout du support multilingue pour le module Liaise v1.21;
- Ajout du support multilingue pour le module iContent v4.5;
- Ajout du support multilingue pour le module xDirectory v1.5;
- Et plusieurs autres petites corrections...
Problèmes d'installation ?
Depuis la sortie du package, plusieurs d'entre vous m'avez écrit pour me signaler quelques problèmes à l'installation. Malheureusement (ou heureusement ?  ), à tous les coups, ces problèmes étaient causés par le non respect de la procédure d'installation. Je sais qu'il peut être ardu de le faire mais j'insiste encore sur le même point : XOOPS Multilangues n'est pas un simple module ordinaire : il est ULTRA IMPORTANT de lire le fichier LisezMoi.txt et de suivre à la lettre les instructions d'installation.
Pour ceux qui auraient omis de le faire voici la prodécure pour une nouvelle installation. La procédure pour une mise à jour de la 1.3 est défini juste après.
Installer XOOPS Multilangues pour la première fois
Vous devez tout d'abord avoir installé CORRECTEMENT la version 2.0.7 de XOOPS. Dézipper le fichier XOOPS2_hack_xoopsml_1_4_marcan.zip et copier le contenu du dossier 'Core' dans le "root" (racine) de votre site.
De plus, au même niveau que le dossier 'Core', se trouve le dossier 'hacked_modules'. Ce dossier contient d'autres modules ne faisant pas partie du 'core' de XOOPS, mais qui ont été modifiés afin de supporter les fonctionnalités multilingues. Si vous utilisé un des ces modules, vous n'avez qu'à copier le dossier dudit module dans XOOPS_ROOT/modules/. Ceci activera les fonctions multilingues pour ce module.
Vous devez maintenant installer le module 'Language'. Rendez vous sur Admin System > Modules et installer le module 'Language'.
Finalement, pour que ce XOOPS Multilangues fonctionne pour vous (pour les langues autres que français et anglais), vous devez modifier 1 fichier.
Vous devez adapter la fonction formatForML() dans le fichier class/module.textsanitizer.php selon vos besoins. Ouvrez ce fichier dans votre éditeur PHP favori. Allez à la ligne 153. Vous verrez ceci : // LANGUAGE DEFINITION TAGS BEGINS HERE
/**
* Language : french
* Tags : [fr]...[/fr]
**/
$patterns[] = "/\[fr](.*)\[\/fr\]/sU";
if ($xoopsConfig['language'] == "french") {
$replacements[] = '\\1';
} else {
$replacements[] = "";
}
/** End of french language tags definition **/
/**
* Language : english
* Tags : [en]...[/en]
**/
$patterns[] = "/\[en](.*)\[\/en\]/sU";
if ($xoopsConfig['language'] == "english") {
$replacements[] = '\\1';
} else {
$replacements[] = "";
}
/** End of english language tags definition **/
// LANGUAGE DEFINITION TAGS ENDS HERE
Vous aurez besoin d'un bloc IF-ELSE pour chaque langage que vous désirez installer sur votre site. Vous aurez besoin du nom du langage, à savoir le nom du dossier dans lequel sont conservés vos fichiers de langues pour chaque module. Par exemple, le pack français est contenu dans les dossiers 'french', donc le nom du langage est 'french'. Vous devrez aussi décider des lettres à utiliser pour identifier les chaînes de texte à traduire. Dans notre cas, les langues sont 'english' et 'french' et les lettres utilisées sont 'en' et 'fr'.
Voici un autre exemple. Si vous désirez ajouter le support pour l'espagnol, vous devrez ajouter les ligne suivantes :
/**
* Language : spanish
* Tags : [sp]...[/sp]
**/
patterns[] = "/\[sp](.*)\[\/sp\]/sU";
if ($xoopsConfig['language'] == "spanish") {
$replacements[] = '\\1';
} else {
$replacements[] = "";
}
/** End of spanish language tags definition **/
Évidement, le tout ne fonctionnera correctement que si vous avez les fichiers de langues correspondantes dans les bon répertoires, mais vous le saviez surement déjà !
Mise à jour à partir de XOOPS Multilangues v1.3
Si vous avez déjà installé XOOPS Multilangues version 1.3, voici les instructions que vous devez suivre pour mettre à jour XOOPS Multilangues à la version 1.4.
- Vous devez déjà avoir une version FONCTIONNELLE de XOOPS 2.0.7. Veuillez noter que XOOPS Multilangues 1.4 ne fonctionne qu'avec la version 2.0.7 de XOOPS;
- Dézippez le fichier XOOPS2_hack_xoopsml_1_4_marcan.zip et copiez le contenu du dossier 'Core' dans le "root" (racine) de votre site;
- Ouvrez votre navigateur et rendez vous à la page suivante : XOOPS_ROOT/modules/language/upgrade/mlhack_1_4.php
- Ceci exécutera le script de mise à niveau de XOOPS Multilangues;
- Une fois le script exécuté, veuillez supprimer ce fichier XOOPS_ROOT/modules/language/upgrade/mlhack_1_4.php;
- Il ne vous reste plus qu'à modifier le fichier class/module.textsanitizer.php, tout comme vous l'aviez fait lors de l'installation de la version 1.3. Pour ce faire, veuillez suivre les instructions de la section 'Installer XOOPS Multilangues pour la première fois';
- Voilà ! XOOPS Multilangues v1.4 a été correctement installé !
Comme à l'habitude, le support de ce module est offert sur NotreVie.ca. Vos questions et commentaires sont toujours les bienvenus
Marc-André | |
4523
