Les 3 essentiels XenForo

Comment installer une nouvelle langue, un nouveau style et un module complémentaire.

  Menu

Comment installer une nouvelle langue, un nouveau style et un module complémentaire.  

  1. Généralités
  2. Installer une nouvelle langue
  3. Installer un nouveau style
  4. Installer un module complémentaire

  Généralités

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.

Pas de panique ! Vous pouvez, en quelques clics, installer la langue française ! (ou tout autre langue de votre choix...)

Le fichier de traduction XenForo

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)
  1. Import from uploaded XML file : cliquez sur "Choisir un fichier" et sélectionner le fichier de langue XML sur votre disque dur.
  2. Import as : chosissez Child of language et dans la liste déroulante laissez le choix par défaut No parent.
  3. 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
Menu langue ACP XenForo
figure 2 : ACP - page des langues
Page langue ACP XenForo
figure 3 : ACP - Import a language
Import langue ACP XenForo
figure 4 : ACP - L'importation est en cours...
Installation langue ACP XenForo
figure 5 : ACP - La nouvelle langue est installée
Installation langue terminée
figure 6 : ACP - Derniers petits réglages
Réglages langue ACP XenForo

  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 :
  1. le Style simple : seul un fichier XML (il peut être sous forme d'archive .zip également) est nécessaire pour l'installer
  2. 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)
  1. 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.
  2. Importer comme : choisissez Style enfant et sélectionnez le style XenForo par défaut.
  3. 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
Menu Styles ACP XenForo
figure 2 : ACP - Page des styles
Page Styles ACP XenForo
figure 3 : ACP - Importer un style
Import Styles ACP XenForo
figure 4 : ACP - Installation du style en cours...
Installation Styles ACP XenForo
figure 5 : ACP - Le nouveau style est installé !
Style installé ACP XenForo


 Illustration : installer un style avancé

figure 6 : FileZilla - Charger les fichiers du style sur votre serveur
Fichiers Styles serveur FTP

  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) :

Menu
ACP    Modules complémentaires    Modules complémentaires

Cliquez sur le bouton  

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
config.php XenForo
figure 2 : message d'erreur config.php
Erreur config.php
figure 3 : ACP - Menu Modules complémentaires
Menu add-ons XenForo
figure 4 : page d'accueil des modules complémentaires
Page add-ons XenForo
figure 5 : choisir le fichier sur son disque dur
Choix fichiers disque dur
figure 6 : confirmer l'installation du module complémentaire
Confirmer installation add-on
figure 7 : confirmation de l'installation
Confirmation installation add-on
figure 8 : page d'acceuil avec le module complémentaire nouvellement installé
Add-on installé
Discussion
  1. Besoin d'aide supplémentaire ?

    Rendez vous dans la discussion dédiée à ce tutoriel et posez vos questions à la communauté.
  • Publié le
    13 Novembre 2022
  • Affichages
    1.400
Haut