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

Retrouvez ici quelques tutoriels pour vos forums phpBB
Avatar du membre
OriginFrance
Fondateur
Messages : 1372
Enregistré le : 01 janv. 2020, 18:26
Prénom : Fred
Site internet : https://caforum.fr
Localisation : IDF
avr. 2020 11 15:03

Installer une extension téléchargée sur GitHub

Message par OriginFrance

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.

:warning: 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 Image

Ensuite on clique sur "Download ZIP"

Image

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

Image

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

Image


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
Dernière modification par OriginFrance le 03 nov. 2020, 09:53, modifié 1 fois.


Vous devez être membre du forum pour répondre
Inscrivez-vous pour participer au forum ou Connecter-vous à votre compte.
CAForum-phpBB  : Disclaimer