[Tuto] Installer une extension téléchargée sur GitHub

[Fred]

Lorsque tu télécharges une extension depuis le dépôt GitHub il faut faire une petite manipulation pour la rendre utilisable.
Les extensions venant de GitHub ont un nom de dossier bien particulier après extraction du fichier .zip.
le plus simple est d'utiliser un exemple afin de mieux visualiser les étapes.

Attention
Toutes les extensions venant de Github ne sont pas forcément compatibles avec votre version de forum de part leurs développements.
Il faut bien garder à l'esprit que certaines de ces extensions peuvent endommager sérieusement un forum en production ! En guise d'exemple nous allons prendre l'extension RecentTopics téléchargeable ici : https://github.com/sajaki/RecentTopics

En premier lieu il faut télécharger le fichier en cliquant sur le bouton

Ensuite on clique sur "Download ZIP"



On retrouve le fichier téléchargé dans le dossier des téléchargements de son prdinateur



Il faut par la suite décompresser le fichier RecentTopics-develop32.zip




Pour connaître le nom de dossier qui sera reconnu par phpBB il faut ouvrir le fichier composer.json, toutes les extensions ont un fichier en .json

Code: Tout sélectionner

{
    "name": "paybas/recenttopics",
    "type": "phpbb-extension",
    "description": "Recent topics Extension for phpBB3.2. Adds a list with a number of recent topics to the index.php",
    "homepage": "https://github.com/sajaki/RecentTopics",
    "version": "2.2.12",
    "time": "2020-03-28",
    "license": "GPL-2.0-only",
    "authors": [
        {
            "name": "PayBas",
            "role": "Previous Developer"
        },
        {
            "name": "nickvergessen",
            "role": "Previous Developer"
        },
        {
            "name": "Andreas Vandenberghe",
            "homepage": "https://www.avathar.be",
            "role": "Developer"
        }
    ],
    "require": {
        "php": ">=5.4",
        "phpbb/phpbb": ">=3.2.0",
        "composer/installers": "~1.0"
    },
    "require-dev": {
        "phpbb/epv": "dev-master"
    },
    "extra": {
        "display-name": "Recent Topics",
        "soft-require": {
            "phpbb/phpbb": ">=3.2.0"
        },
        "version-check": {
            "host": "www.avathar.be",
            "directory": "/versioncheck",
            "filename": "recenttopics22.json",
            "ssl": true
        }
    }
}

Dans ce fichier la première ligne nous intéresse car elle indique l'auteur de l'extension et le nom de l'extension :

Code: Tout sélectionner

"name": "paybas/recenttopics",

Il faut renommer le dossier extrait qui porte le nom RecentTopics-develop32 en recenttopics
Ensuite il faut créer un dossier du nom de l'auteur paybas dans lequel on glisse le dossier de l'extension recenttopics


Avec ton client FTP il suffit d'envoyer le dossier parent paybas dans le répertoire ./ext du serveur Si le dossier parent est déjà présent sur le serveur il ne faut envoyer que le dossier du nom de l'extension à l'intérieur