[phpBB 3.1.x] Installer une extension

Toutes les documentations phpBB seront ici.
Verrouillé
Avatar du membre
Dakin Quelia
Webmaster
Webmaster
Messages : 565
Enregistré le : ven. 27 nov. 2009 05:47
Localisation : Belgique
Contact :

[phpBB 3.1.x] Installer une extension

Message par Dakin Quelia »

» Installer une extension
Dans cette documentation, je vais vous expliquer comment installer une extension.

» Définir une extension et sa différence avec les MODs

Tout d'abord, il faut savoir qu'une extension est un module que l'on installe sur un forum :
  • Soit pour avoir une nouvelle fonctionnalité :
    • Ajouter des pages personnalisées,
    • Ajouter des règles à son forum,
    • Gérer des annonces sur le forum.
  • Soit pour améliorer une fonctionnalité existante :
    • Ajouter des modèles de messages dans la partie rédaction,
    • Améliorer les BBCodes du forum,
    • Etendre la recherche du forum phpBB avec le moteur de recherche de Google.
  • Soit pour modifier la mise en page du forum :
    • Séparer les différents types de sujet par des tableaux,
    • Ajouter un bouton « Nouveau sujet » dans les sujets.
Contrairement à phpBB 3.0.x, les extensions ne nécessitent AUCUNE modification des fichiers du forum ce qui est un gros avantage par rapport à son prédécesseur.

» Utilité d'une extension

La question que l'on se pose parfois est de savoir à quoi sert une extension.

Chaque forum a ses propres besoins. Les extensions sont là, comme je l'ai indiqué précédemment, pour ajouter une fonctionnalité ou en modifier une déjà existante.

En somme, les extensions ne sont pas obligatoires mais, selon les besoins, certaines vous seront utiles.

» Installer une extension

L'installation d'une extension n'est guère compliquée. Dans la plupart des extensions, vous trouverez les instructions d'installation dans le fichier « readme.md » (que l'on peut ouvrir avec n'importe quel éditeur de texte tel que Notepad++). Mais ce fichier n'est pas toujours fourni.

Dans le cas où vous n'auriez pas les instructions d'installation, à la racine de votre forum, vous trouverez un répertoire nommé « ext ». C'est dans ce répertoire que vous devrez transférer les fichiers de l'extension que vous souhaitez installer sur votre forum. Pour que l'extension puisse être installée, il faut utiliser le modèle d'arborescence suivant /ext/nom_de_l_auteur/nom_de_l_extension. Ainsi une extension nommée « boardrules » et développée par un auteur nommé « phpbb » aura l'arborescence suivante : /ext/phpbb/boardrules/.

Aussi deux cas peuvent se présenter :
  • L'auteur a prévu le répertoire à son nom dans l'archive que vous avez téléchargée; dans ce cas, il suffit simplement de placer l'extension dans le dossier « ext » de votre forum.
  • L'auteur n'a pas prévu le répertoire à son nom dans l'archive que vous avez téléchargée; dans ce cas précis, il faut donc créer un dossier que l'on nommera « nomauteur » dans le dossier « ext » puis placer l'extension dans le dossier « nomauteur ».
Attention: le nom du dossier de l'auteur ainsi que celui de l'extension doivent obligatoirement correspondre aux noms indiqués dans le fichier « composer.json ». Recherchez une ligne similaire à : "name": "nomauteur/nomextension", Si le contenu de la ligne ne correspond pas exactement à l'arborescence présente dans le répertoire « ext », l'extension ne fonctionnera pas.

Une fois l'extension transférée avec votre logiciel FTP au bon endroit, il ne reste plus qu'à l'activer. Pour ce faire, il suffit de se connecter au panneau d'administration, de se rendre dans l'onglet « Personnaliser » et de cliquer sur « Gérer les extensions ». Là, vous pourrez voir toutes les extensions actives et désactivées.
01.png
Pour activer l'extension, il suffit simplement de cliquer sur « Activer » à côté du nom de l'extension tout simplement. Voilà, il n'y avait rien de sorcier, n'est-ce pas?

» Configurer une extension

Certaines extensions ont mis en place une partie administrative pour pouvoir les configurer. Pour cela, rendez-vous dans l'onglet « Extensions ». Dans le menu sur votre gauche, vous verrez les extensions qui ont une page de configuration.

Voici ce que donne l'écran d'une extension à configurer :
02.png
Ceci était un aperçu de la configuration de l'extension « Règles du forum » (en anglais c'est « Board Rules »).

» Mot de la fin

Je tiens à remercier Galixte de la communauté phpbb-fr.com et de la communauté Ezcom-fr.com qui m'a aidé à finaliser la documentation et à relire le tout.

» Support technique

Cette dernière partie concerne simplement le support relatif à cette documentation. Toute question relative aux extensions doit être posée soit sur la communauté phpbb-fr.com (francophone) soit sur la communauté phpBB.com (anglophone). Donc n'hésitez pas à poser vos questions si nécessaire.

Verrouillé

Qui est en ligne

Utilisateurs parcourant ce forum : Aucun utilisateur enregistré et 23 invités