Installer les plugins et les thèmes du référentiel WordPress avec Composer

Dans mon dernier guide, je vous expliquais comment installer vos thèmes et plugins WordPress maintenus par GitHub avec composer. Et si je vous disais que vous pouvez également utiliser composer pour installer n’importe quel thème ou plugin à partir du référentiel WordPress ?

WordPress Packagist est un service fantastique et gratuit qui prend des plugins et des thèmes du référentiel WordPress et crée des packages de composition pratiques.

Conditions préalables

• Installer le compositeur
• Assurez-vous que le thème ou le plugin que vous souhaitez utiliser se trouve dans le référentiel WordPress et connaissez le slug

Configurez votre projet WordPress

Nous voulons configurer votre projet WordPress afin qu’il intègre des thèmes et des plugins via Composer.

Créez un composer.jsonà la racine de votre projet WordPress (ou modifiez un existant s’il existe déjà).

Assurez-vous qu’il contient les lignes de code suivantes :

{
    "name": "wholesomecode/composer-example",
    "description": "Demonstration of how to use composer within WordPress",
    "require": {
        "wpackagist-plugin/wholesome-publishing":">=1.3.0"
    },
    "repositories": [
        {
            "type":"composer",
            "url":"https://wpackagist.org"
        }
    ]
}

Dans la requirezone, nous avons mis un lien vers le plugin que nous souhaitons télécharger, préfixé par wpackagist-plugin(pour les thèmes use wpackagist-theme). Il indique également la version que nous voulons télécharger. Dans ce cas supérieur ou égal à la version 1.3.0.

Référentiels

Dans le repositoriesnous avons ajouté une entrée du type composeravec l’url pointant vers WordPress Packagist.

GitIgnore

Si vous utilisez GitHub pour gérer votre projet, assurez-vous d’ajouter le chemin du plugin (ou du thème) à votre .gitignorefichier :

/vendor
wp-content/plugins/wholesome-publishing

N’oubliez pas d’ajouter également /vendorau fichier pour vous assurer que nous ne commettons pas de fichiers supplémentaires installés par composer.

Composer en cours d’exécution

Si votre projet WordPress a le composer.jsonfichier dans le même dossier que votre wp-contentdossier, nous ne devrions pas avoir à configurer quoi que ce soit d’autre (sinon, consultez le guide du chemin d’installation personnalisé dans mon article précédent sur le compositeur).

Dans votre terminal, assurez-vous d’être dans le même dossier que votre composer.jsonfichier et saisissez la commande suivante :

Si vous avez déjà exécuté composer et que vous avez un composer.lockfichier, vous pouvez exécuter composer update.

Le plugin sera installé danswp-content/plugins/wholesome-publishing:

Exécution de Composer Install pour installer un thème à partir du référentiel WordPress

Qu’est-il arrivé?

• Le plugin a été installé danswp-content/plugins/wholesome-publishing

• Un vendora été créé qui contient les fichiers d’installation utilisés pour mettre le thème au bon endroit

• Un composer.lockdossier a été créé. Cela fait une note des versions de fichiers que vous utilisez. Si vous validez cela, les autres personnes qui exécutent la composer installcommande obtiendront les mêmes versions.

• Installer vos propres plugins et thèmes depuis GitHub avec composer

• Configuration d’un chemin d’installation personnalisé