Installer une extension Facile

Partager sur FacebookPartager sur TwitterPartager sur Google+

Installer une extension

Documentation sur l'installation d'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. Voilà, il n'y avait rien de sorcier, n'est-ce pas ?

» Configurer une extension

Certaines extensions mettent en place un module d'administration 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.

02.png

Ceci était un aperçu de la configuration de l'extension « Règles du forum » (en anglais c'est « Board Rules »).

» Support technique

Toute question relative aux extensions doit être posée dans cette section. Donc n'hésitez pas à poser vos questions si nécessaire.

_________________
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 ainsi que FoFa et Skouat qui m'ont également aidé à corriger la documentation.
29/03/2017 - modifié par Steph pour mettre l’article à jour
19/06/2015 - modifié par Jester pour convertir le sujet en article.
Avatar de l’utilisateur
Dakin Quelia
Floodeur universel
Floodeur universel
 
Rédigé le: 15 Juin 2015 à 22:35
Articles: 7
Contributeurs:
Noter cet article: 123456 Votants: 9
Mots-clés: Installer, extension, 31x

Retourner vers Extensions