[Tuto] Installer, mettre à jour ou supprimer une extension

Retrouvez ici quelques tutoriels pour vos forums phpBB
Message par Fred »
Avatar du membre
Fred Fred
Messages: 3135
Enregistré depuis: 4 ans 1 mois
Identité: Fred Rimbert
Forum phpBB: https://caforum.fr
Localisation: Le Lude - Pays de la Loire
Intérêt: GitHub

Installer, mettre à jour ou supprimer une extension

Message

Installer, mettre à jour ou supprimer une extension


► Installer une extension

Dans le répertoire du forum se trouve le dossier ext. Il s'agit de l'emplacement où toutes les extensions seront stockées.
Pour la plupart des extensions, vous trouverez les instructions d'installation dans le fichier readme.md.
Dans le cas où vous n'auriez pas les instructions d'installation, il faut consulter le fichier composer.json de chaque extension
Pour qu'une 'extension puisse être installée, il faut cette arborescence :
/ext/nom_de_l_auteur/nom_de_l_extension

Exemple : si on télécharge l'extension nommée lightbox, elle sera téléchargée sur ext/vse/lightbox.
Toute autre extension créée par vse sera également stockée dans ext/vse.

Par exemple :
phpBB/ext/vse
- lightbox
- pmbars
- topicpreview


1. Télécharger et décompresser
Une fois qu'on a téléchargé une extension, il faut la décompresser sur l'ordinateur, car les extensions sont généralement disponibles au format de fichier compressé .zip.

2. Uploader vers le forum
Pour uploader des fichiers, on ouvre un client FTP (FileZilla, CuteFTP, SmartFTP, etc...) et on se connecte à son compte.
On accede au dossier du forum. Dans cet exemple, il s'agit d'uploader l'extension lightbox.
On accede au répertoire /ext

On fait glisser le dossier vse vers le répertoire /ext du client FTP.
S'il existe déjà un dossier /vse dans le répertoire /ext, on copie simplement le dossier lightbox dans /ext/vse

3. Activer
Une fois l'extension uploadée sur le forum, on navigue dans le panneau d'administration pour l'activer : PCA - PERSONNALISER - Gérer les extensions.
On doit voir l'extension lightbox répertoriée sous «Extensions désactivées».
On clique sur le bouton "Activer" et l'installation est terminée !



► Mettre à jour une extension

La mise à jour d'une extension est un processus simple qui peut être effectué en quelques étapes simples.
Les étapes suivantes supposent qu'on a déjà téléchargé et décompressé une nouvelle version d'une extension existante.

1. Désactiver
La désactivation d'une extension la désactivera efficacement et la supprimera du forum.
Si l'extension est essentielle à la fonctionnalité du forum, il est plus sûr de la désactiver avant d'effectuer ce processus de mise à jour.
Ne pas supprimer les données pour ne pas perdre une personnalisation apportée à l'extension

2. Supprimer les fichiers de l'extension
À l'aide de votre programme FTP, on supprime les fichiers de l'extension. Dans la plupart des cas, il faut simplement supprimer l'intégralité du dossier de l'extension, ce qui supprimera tous ses fichiers.

3. On téléchargez les nouveaux fichiers de l'extension
À l'aide du client FTP, on télécharge les nouveaux fichiers de l'extension (ou le répertoire de l'extension au complet) à l'emplacement correct.

4. Activer
Une fois la mise à jour terminée il faut aller activer l'extension dans le panneau d'administration



► Supprimer une extension

Parfois, il est nécessaire de supprimer une extension. phpBB permet de désactiver une extension et de la supprimer définitivement du forum.

1. Désactiver
La désactivation d'une extension la désactivera efficacement et la supprimera du forum. Cependant, toutes les modifications apportées à la base de données sont toujours intactes, on peut donc réactiver l'extension sans perdre aucun de ses paramètres et données stockés.
Pour désactiver une extension, on clique simplement sur son bouton "Désactiver" dans la page Gestion des extensions.

2. Supprimer les données
Pour supprimer l'extension, on clique sur le bouton "Supprimer les données" dans la page Gestion des extensions une fois l'extension déjà désactivée. Il s'agit d'un mouvement destructeur qui supprimera tous les paramètres et données utilisés par l'extension de la base de données (si on réactive l'extension à ce stade, ce sera comme si elle était installée pour la première fois.)
Une fois les données supprimées, on peut utiliser en toute sécurité le client FTP pour supprimer le dossier de l'extension du répertoire /ext


► Supprimer une extension directement depuis le serveur

Par mégarde il peut arriver de supprimer une extension directement depuis le serveur, ce n'est évidemment la bonne manière de procéder !

Dans le PCA vous aurez alors ce genre de message d'erreur

Capture d’écran 2021-08-27 à 09.52.05.png

Ce message d'erreur informe qu'il manque le fichier composer.json de l'extension 24 Hour Activity Stats, ce message arrive si l'extension n'a pas été désactivée et que ses données n'ont pas été supprimées avant d'effacer son dossier sur le serveur.

Pour corriger ceci il faut replacer le dossier de l'extension sur le serveur et de suivre la procédure de désinstallation donnée ici
Vous n’avez pas les permissions nécessaires pour voir les fichiers joints à ce message.
Partagez cette page
Twitter Whatsapp Linkedin Email
Vous devez être membre du forum pour répondre
Inscrivez-vous pour participer au forum ou Connecter-vous à votre compte.