Vous utilisez un navigateur obsolète. Il se peut que ce site ou d'autres sites Web ne s'affichent pas correctement.
Vous devriez le mettre à jour ou utiliser un navigateur alternatif.
Les 3 essentiels XenForo
Comment installer une nouvelle langue, un nouveau style et un module complémentaire.
L'installation d'une langue, d'un style ou d'un module complémentaire avec XenForo se fait généralement en quelques clics et tout se passe au niveau de votre panneau de configuration administrateur, appelé communément ACP (Admin Control Panel).
Il y a malgré tout quelques principes à respecter pour utiliser au mieux vos nouvelles installations et nous allon vous les décrire dans ce tutoriel. D'ici dix minutes l'installation d'une langue, d'un style ou d'un module complémentaire n'aura plus de secret pour vous ! C'est parti ?
Installer une nouvelle langue
Vous venez d'installer votre premier forum Xenforo et la première chose que vous avez remarqué c'est que tout est en anglais, aussi bien la partie publique que le partie administrative.
Il se présente sous la forme d'un fichier avec l'extension .xml, en général vous le trouverez disponible au téléchargement dans un fichier compressé de type .zip, il suffira de le dézipper pour pouvoir l'utiliser dans XenForo.
Installer le fichier de langue XML
Connectez-vous à votre ACP et à l'aide du menu de navigation latéral (figure 1) positionnez-vous sur la page Languages (figure 2) :
Menu
ACP Appearance Languages
Cliquez ensuite sur le bouton
Une nouvelle page s'ouvre : Import a language (figure 3)
Import from uploaded XML file : cliquez sur "Choisir un fichier" et sélectionner le fichier de langue XML sur votre disque dur.
Import as : chosissez Child of language et dans la liste déroulante laissez le choix par défaut No parent.
Skip import checks : laissez décoché
Cliquez sur le bouton
Le processus d'importation de la langue commence (figure 4).
Une fois le processus terminé votre nouvelle langue apparait sur la page des langues installées, French (FR) dans notre exemple (figure 5).
Pensez à la choisir comme langue par défaut et à éventuellement désactiver la langue anglaise si vous n'en avez pas l'utilité - Ne la supprimez pas elle pourrait servir ultérieurement (figure 6).
Votre forum XenForo est en français !
Astuce : affinez vos réglages de langue !
Si vous cliquez sur le nom d'une langue une nouvelle page s'ouvre et affiche quelques réglages linguistiques supplémentaires.
(Note : si votre fichier de langue est bien conçu vous ne devriez pas avoir à changer les réglage sur cette page)
Mettre à jour une langue
Les fichiers de traduction évoluent au gré des mises à jour de XenForo.
Si vous devez mettre à jour une langue il suffit de répéter les opérations décrites ci-dessus mais à l'étape Importer comme (figure 3) choisissez Écraser la langue
plutôt que Langue enfant le système se charge du reste et mettra à jour les phrases modifiées et/ou ajoutera les nouvelles prases traduites.
figure 1 : ACP - Menu de navigation latéral
figure 2 : ACP - page des langues
figure 3 : ACP - Import a language
figure 4 : ACP - L'importation est en cours...
figure 5 : ACP - La nouvelle langue est installée
figure 6 : ACP - Derniers petits réglages
Installer un nouveau style
Votre forum est maintenant traduit en français, c'est à peu près la seule chose qui le différencie d'un forum XenForo de base. Alors peut être avez vous envie de lui donner un style plus personnel qui correspondra mieux avec le thème de votre forum.
Tout est prévu rassurez-vous. Dans le gestionnaire de ressources officielles XenForo vous trouverez plusieurs dizaines de styles, gratuits ou payants, et probablement qu'un ou plusieurs d'entre eux conviendra à votre forum.
Les fichiers de Style Xenforo
On pourrait classer les Styles en deux catégories :
le Style simple : seul un fichier XML (il peut être sous forme d'archive .zip également) est nécessaire pour l'installer
le Style avancé : un fichier XML plus d'autres dossiers ou fichiers sont nécessaire pour son installation
Nous allons détailler l'installation des deux types de style :
Installer un style simple
Connectez-vous à votre ACP et à l'aide du menu de navigation latéral (figure 1) positionnez-vous sur la page Styles (figure 2) :
Menu
ACP Apparence Styles
Cliquez sur le bouton
Une nouvelle page s'ouvre : Importer un style (figure 3)
Importer à partir d'un fichier XML ou d'archive : cliquez sur le bouton "Choisir un fichier" et sélectionner le fichier de style XML/ZIP sur votre disque dur.
Importer comme : choisissez Style enfant et sélectionnez le style XenForo par défaut.
Ignorer les contrôles d'importation : laissez décoché.
Il est important de sélectionner le style enfant cela permet de ne pas casser votre style lors d'une mise à jour XenForo qui modifierait les templates.
Nous y reviendrons un peu plus tard.
Cliquez sur le bouton
Le processus d'installation du style commence (figure 4).
Une fois le processus d'installation terminé le nouveau style (Shades of Blue dans notre exemple) apparait dans la page des styles de votre panneau administrateur (figure 5).
À l'image d'une nouvelle langue, pensez à l'activer et le cas échéant à le définir comme style par défaut.
Votre forum dispose d'un nouveau style !
Installer un style avancé
L'installation d'un style "avancé" (terme inventé pour l'occasion) ne différe que très peu de celle d'un style simple.
Le dossier compressé contient, en plus du fichier XML classique vu plus haut, d'autres dossiers et fichiers.
Par convention tout est réuni dans un dossier nommé styles
(qui contient généralement un autre dossier dont le nom est celui du style que vous installez) et qu'il conviendra de fusionner avec le dossier éponyme qui se trouve à la racine sur votre serveur (figure 6).
Une fois effectué la procédure est la même que pour un style simple : import du fichier style XML dans votre ACP !
Illustrations : installer un style simple
figure 1 : ACP - Menu de navigation latéral
figure 2 : ACP - Page des styles
figure 3 : ACP - Importer un style
figure 4 : ACP - Installation du style en cours...
figure 5 : ACP - Le nouveau style est installé !
Illustration : installer un style avancé
figure 6 : FileZilla - Charger les fichiers du style sur votre serveur
Installer un module complémentaire
Maintenant que l'installation d'une langue ou d'un style n'a plus de secret pour vous l'installation d'un module complémentaire (ou add-on en anglais) va vous paraitre enfantin, et c'est le cas !
Le principe est le même, il s'agit d'importer un fichier ZIP et de lancer l'installation, et ça vous savez faire !
Il y a un préalable néanmoins...
Il est nécessaire d'éditer le fichier config.php qui se trouve sur votre serveur root/src/config.php et d'y rajouter la ligne suivante avant de pouvoir installer un module complémentaire(figure 1) :
PHP:
$config['enableAddOnArchiveInstaller'] = true;
Sinon vous recevrez un message d'erreur accompagné d'instructions si vous tentez d'installer un module complémentaire (figure 2).
Installer un module complémentaire
Connectez-vous à votre ACP et à l'aide du menu de navigation latéral (figure 3) positionnez-vous sur la page d'accueil des Modules complémentaires (figure 4) :
Une fenêtre contextuelle (pop-up) s'ouvre (figure 5) :
Choisir des fichiers : sélectionnez le fichier ZIP du module complémentaire sur votre disque dur.
Pour le tutoriel nous avons choisi d'installer notre module complémentaire Auto OpenGraph
Cliquez sur le bouton
Une nouvelle page se charge et vous demande de confirmer l'installation du module complémentaire (figure 6):
Cliquez sur le bouton
La procédure d'installation et après quelques secondes ou minutes selon la taille du fichier ZIP une nouvelle page se charge et vous indique que l'installation est complétée (figure 7).
Vous pouvez cliquer sur le lien "Voir tous les modules complémentaires" pour revenir à la page d'accueil et constater que votre module complémentaire est bien dans la liste des modules installés (figure 8).
Mission accomplie !
figure 1 : ajout de la ligne de code dans config.php
figure 2 : message d'erreur config.php
figure 3 : ACP - Menu Modules complémentaires
figure 4 : page d'accueil des modules complémentaires
figure 5 : choisir le fichier sur son disque dur
figure 6 : confirmer l'installation du module complémentaire
figure 7 : confirmation de l'installation
figure 8 : page d'acceuil avec le module complémentaire nouvellement installé