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 :
» 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 :
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.
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 :
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.
» 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.
» 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 ».
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.
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 :
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.