WP-CLI existe depuis un certain temps déjà (environ 2011) et a pris de l’élan dans la communauté des développeurs WordPress. Mais de quoi s'agit-il exactement et comment pouvez-vous l'utiliser dans votre flux de travail WordPress??
L’idée de WP-CLI est de permettre l’interaction et la gestion de sites WordPress via une interface de ligne de commande. Selon la documentation officielle, il s'agit d'une alternative en ligne de commande à l'utilisation de l'interface utilisateur d'administration classique de WordPress..
L'approche en ligne de commande est logique car vous pouvez généralement faire les choses sur un ordinateur beaucoup plus rapidement via la ligne de commande, et WP-CLI n'est pas différent. Si vous avez déjà utilisé la ligne de commande sous Windows ou le terminal sous macOS, vous serez comme à la maison avec WP-CLI..
Cependant, il s’agit d’un tutoriel destiné aux débutants. Ne vous inquiétez donc pas si vous n’êtes pas un gourou de la ligne de commande. Si vous n'avez jamais utilisé WP-CLI ou la ligne de commande, vous êtes en bonne compagnie et à la bonne place.!
Avant d'aller plus loin, j'ai une confession à faire. Comme je l'ai indiqué plus haut, je n'ai jamais utilisé le WP-CLI auparavant! Je le connais depuis un bon bout de temps et je suis impatient de l'essayer, mais je n'ai jamais réussi à l'installer et à l'utiliser. Jusqu'à présent, c'est…
Nous allons donc littéralement participer à ce projet et voir comment utiliser le WP-CLI en tant que débutant complet. Je suis vraiment intéressé de voir comment le WP-CLI s'intègre dans mon flux de travail de développement WordPress existant et s'il peut aider à augmenter la productivité..
Es-tu prêt à commencer? OK alors allons-y!
Installation de WP-CLI
Installer la WP-CLI pour la première fois peut sembler un peu intimidant. J'ai dû lire les instructions d'installation plusieurs fois avant que cela ait du sens. Mais, il s'avère que ce n'est pas si difficile une fois que vous comprenez exactement ce qui est requis.
Pour commencer, nous devons obtenir la dernière version de WP-CLI. Pour ce faire, il est recommandé de télécharger le WP-CLI en tant que fichier Phar via la ligne de commande. Il s’agit d’un fichier d’archive PHP contenant tous les fichiers PHP nécessaires au fonctionnement de WP-CLI, le tout réuni dans un seul fichier pratique prêt à être téléchargé..
Installation sur macOS
Ouvrez une fenêtre de terminal et tapez ce qui suit:
Cela téléchargera le fichier Phar WP-CLI sur votre ordinateur. Vérifions que tout va bien en testant l'archive WP-CLI.
php wp-cli.phar --info
Vous devriez voir une sortie semblable à celle-ci:
Binaire PHP: / usr / bin / php Version PHP: 5.6.30 php.ini utilisé: répertoire racine WP-CLI: phar: //wp-cli.phar Progiciels WP-CLI répertoire: config global WP-CLI: WP-CLI configuration du projet: version WP-CLI: 1.1.0
Pour rendre l’utilisation de WP-CLI plus pratique, nous voulons pouvoir l’exécuter depuis n’importe où et via une commande plus courte, telle que wp plutôt que d'avoir à taper wp-cli.phar à chaque fois.
Nous pouvons le faire via les deux commandes suivantes:
chmod + x wp-cli.phar sudo mv wp-cli.phar / usr / local / bin / wp
Maintenant, essayez de courir wp --info dans une fenêtre de terminal (pointant vers n'importe quel répertoire). Si vous voyez le même résultat que précédemment lorsque vous avez exécuté php wp-cli.phar --info alors vous êtes en affaires. WP-CLI est configuré et prêt à être utilisé!
Il existe d'autres moyens d'installer WP-CLI, tels que via Composer. Vous pouvez donc consulter les méthodes alternatives si vous avez des difficultés avec la méthode par défaut recommandée..
Installation sous Windows
L'installation sous Windows est légèrement plus compliquée, car PHP n'est pas disponible par défaut en ligne de commande. Vous pouvez installer PHP manuellement, mais le moyen le plus simple consiste à utiliser un serveur de développement local tel que MAMP, car PHP est automatiquement installé dans le package global..
Une fois que PHP est disponible sur votre système, vous devez trouver le chemin d'accès à l'exécutable PHP et le rendre disponible globalement (cela est décrit en détail dans le manuel PHP)..
Avec PHP installé et disponible depuis n’importe quel répertoire, téléchargez le fichier wp-cli.phar manuellement et enregistrez-le dans un dossier tel que c: \ wp-cli. Pour pouvoir exécuter le WP-CLI via le wp comme nous l'avons fait sur macOS, créez un fichier de commandes appelé wp.bat dans le même dossier que vous avez enregistré le wp-cli.phar fichier d'archive.
Ajoutez ceci au fichier de commandes:
@ECHO OFF php "c: /wp-cli/wp-cli.phar"% *
Enfin, ajoutez c: \ wp-cli à votre chemin global:
setx path "% path%; c: \ wp-cli"
WP-CLI devrait maintenant être disponible à partir de n'importe quelle fenêtre de ligne de commande.
Une manière encore plus facile!
Si vous vous sentez un peu perdu en ce moment, alors je pourrais avoir une bouée de sauvetage pour vous. Si vous êtes un utilisateur de DesktopServer, WP-CLI est extrêmement facile à configurer. Depuis DesktopServer 3.8.2, un nouveau plug-in de développement est disponible. Il installe WP-CLI sur tout vos sites de développement!
Une fois activé, vous pouvez accéder à WP-CLI via la liste principale du site DesktopServer ou la barre d’outils WordPress..
Si vous avez accès à DesktopServer, je recommanderais certainement d'installer WP-CLI de cette façon, car il s'agit de loin de la méthode de configuration la plus simple. J'utilise DesktopServer depuis deux ans et j'ai donc la chance que l'installation de WP-CLI soit un jeu d'enfant pour moi..
Utilisation de WP-CLI à distance
Ce didacticiel s’adresse aux débutants qui découvrent le WP-CLI, en utilisant une installation locale de WordPress. Toutefois, si vous souhaitez exécuter des commandes sur un serveur distant (c'est-à-dire un site WordPress actif), vous pouvez toujours suivre si WP-CLI est installé..
Vous devez pouvoir vous connecter au serveur via un client SSH et disposer des informations de connexion de votre compte d'hébergement. Une fois connecté et connecté, vous pourrez utiliser toutes les commandes WP-CLI de ce tutoriel..
Cela vaut la peine de contacter votre hôte pour savoir s’il prend en charge le WP-CLI, car l’installer sera beaucoup plus simple..
Tester les eaux
J'espère que maintenant vous aurez installé WP-CLI, auquel cas vous pourrez vous détendre un peu car vous venez de faire la partie la plus difficile.!
Ouvrez une fenêtre de ligne de commande dans le répertoire racine du site Web WordPress avec lequel vous souhaitez travailler, qui devrait ressembler à la capture d'écran ci-dessous..
Un des avantages de DesktopServer est qu’il ouvre automatiquement une fenêtre de commande pointant vers le répertoire de site racine WordPress approprié. Je pensais que c'était une bonne idée, surtout si vous travaillez sur plusieurs sites..
Essayons maintenant notre installation de WP-CLI. C'est notre première commande…
wp --info
Binaire PHP: C: \ xampplite \ php \ php.exe Version PHP: 5.5.24 php.ini utilisé: C: \ xampplite \ php \ php.ini Répertoire racine de la CLI WP: C: \ xampplite \ ds-plugins \ ds -cli \ vendor \ wp-cli \ wp-cli Versions des packages WP-CLI: config globale WP-CLI: config de projet WP-CLI: version de WP-CLI: 1.0.0
Donc, pour accéder à la WP-CLI, vous tapez wp suivi d'une commande et / ou d'un paramètre. Si wp est entré, vous obtenez juste une longue liste de commandes et de paramètres disponibles (que je ne montrerai pas ici, mais essayez vous-même).
Notre première commande contenait un paramètre. La différence est qu'un paramètre est précédé de deux traits d'union. La clé de WP-CLI est que presque toutes les commandes contiennent des sous-commandes (et paramètres). Cette hiérarchie est très bien organisée et est facile à comprendre et à suivre.
Toutes les commandes suivent une structure similaire. Une fois que vous avez maîtrisé quelques commandes, il vous sera facile de les développer pour apprendre davantage de commandes. La suite de ce tutoriel consistera à apprendre certaines des commandes et paramètres disponibles dans WP-CLI..
Jetons un coup d'œil à quelques commandes WP-CLI de base et à leur sortie pour avoir une idée de son fonctionnement..
D'abord, obtenons la version actuelle de WP-CLI que nous utilisons.
wp --version
WP-CLI 1.0.0
Nous pouvons exécuter une commande similaire pour trouver la version actuelle de WordPress.
version de base wp
4.7.3
Que diriez-vous d'une liste de tous les thèmes actuellement installés?
liste de thèmes wp
+-----------------+----------+--------+---------+ | nom | statut | mise à jour | version | + ----------------- + ---------- + -------- + --------- + | vingt-cinq | inactif | aucun | 1,7 | | vingt-sept ans | actif | aucun | 1.1 | | vingt-six ans | inactif | aucun | 1,3 | | vingtten | inactif | aucun | 2,2 | +-----------------+----------+--------+---------+
Notez également comment nous obtenons des informations utiles, telles que le statut d'un thème et sa version, ainsi que la disponibilité d'une mise à jour..
Nous pouvons faire la même chose pour les plugins.
liste des plugins wp
+-------------+----------+--------+------------+ | nom | statut | mise à jour | version | + ------------- + ---------- + -------- + ------------ + | Akismet | inactif | aucun | 3,3 | | bonjour | inactif | aucun | 1,6 | | thème-vérifier | inactif | aucun | 20160523.1 | +-------------+----------+--------+------------+
Nous pouvons utiliser des paramètres pour affiner la liste des plugins.
Nous avons ici un paramètre qui nécessite une ou plusieurs valeurs à spécifier. Ceci est très courant et vous vous y habituerez très rapidement. Dans ce cas, nous avons répertorié uniquement les champs que nous voulions afficher (nom, version).
Nous pouvons également afficher uniquement les plugins répondant à des critères spécifiques.
Liste des plugins wp --status = inactive
+-------------+----------+--------+------------+ | nom | statut | mise à jour | version | + ------------- + ---------- + -------- + ------------ + | Akismet | inactif | aucun | 3,3 | | bonjour | inactif | aucun | 1,6 | | thème-vérifier | inactif | aucun | 20160523.1 | +-------------+----------+--------+------------+
Cela a simplement sorti à nouveau tous les plugins car ils sont tous actuellement inactifs. Nous allons changer cela bientôt lorsque nous commencerons à entrer des commandes pour gérer les plugins (et les thèmes).
Vous avez peut-être remarqué dans les commandes ci-dessus que deux mots de commande sont utilisés (brancher et liste). Si vous tapez plugin wp seul, cela n'exécutera pas de commande mais listera toutes les sous-commandes de plugin wp. Essayez vous-même.
plugin wp
utilisation: plugin wp activer […] [--All] [--network] ou: le plugin wp désactive […] [--Uninstall] [--all] [--network] ou: wp plugin delete … Ou: plugin wp get [--field =] [--fields =] [--format =] ou: installation du plugin wp … [--Version =] [--force] [--activate] [--activate-network] ou: le plug-in wp est installé ou: liste des plugins wp [--=] [--field =] [--fields =] [--format =] ou: chemin du plugin wp [] [--dir] ou: recherche de plug-in wp [--page =] [--per-page =] [--field =] [--fields =] [--format =] ou: statut du plug-in wp [] ou: bascule du plugin wp … [--Network] ou: désinstallation du plug-in wp … [--Deactivate] [--skip-delete] ou: mise à jour du plugin wp […] [--All] [--format =] [--version =] [--dry-run] Voir 'plug-in d'aide wp 'pour plus d'informations sur une commande spécifique.
Alors le liste commande n'est qu'une des nombreuses sous-commandes disponibles pour le 'parent' brancher commander. Beaucoup d'autres commandes fonctionnent de la même manière.
Tapez noyau wp et thème wp pour voir aussi une liste de leurs sous-commandes.
Vous pouvez également utiliser plusieurs paramètres sur la même ligne. Par exemple, si nous voulions répertorier les plugins avec les mises à jour disponibles et limiter les champs en sortie, nous pouvons combiner les paramètres sur une seule ligne comme suit:
Liste des plug-ins wp --fields = nom, version --update = disponible
Par défaut, vous obtenez les résultats d'une commande WP-CLI générée sous forme de tableau, mais vous pouvez facilement le remplacer par JSON ou par une valeur séparée par des virgules (CSV). --format paramètre.
liste des plugins wp --format = json
["name": "akismet", "status": "inactif", "update": "aucun", "version": "3.3", "name": "bonjour", "status": "inactif "," update ":" none "," version ":" 1.6 ", " name ":" vérification du thème "," status ":" inactif "," update ":" none "," version ": "20160523.1"]
liste des plugins wp --format = csv
nom, statut, mise à jour, version akismet, inactif, aucun, 3.3 salut, inactif, aucun, vérification de thème 1.6, inactif, aucun, 20160523.1
Maintenant que nous savons comment entrer les commandes de base WP-CLI, voyons comment effectuer certaines tâches d'administration WordPress utiles via la ligne de commande..
Plugins et thèmes
La puissance réelle de WP-CLI devient claire lorsque vous commencez à manipuler WordPress via la ligne de commande. Dans cette section, nous verrons à quel point il est facile d’installer / supprimer et d’activer / désactiver les plugins et les thèmes via WP-CLI.
Pour les plugins et les thèmes hébergés dans le référentiel WordPress, entrez simplement le nom après le installer commande comme suit:
plugin wp installer jetpack
Installation de Jetpack par WordPress.com (4.8.2) Téléchargement du package d'installation à partir de https://downloads.wordpress.org/plugin/jetpack.4.8.2.zip… Déballage du package… Installation du plug-in… Plug-in installé. Succès: installé 1 des 1 plugins.
Sortons à nouveau une liste de plugins, pour nous assurer que Jetpack a été installé, mais cette fois-ci, listez simplement le nom du plugin.
Nous pouvons installer des thèmes de la même manière:
thème wp installer vingt et un ans
Installation de Twenty Eleven (2.5) Téléchargement du package d'installation à partir de https://downloads.wordpress.org/theme/twentyeleven.2.5.zip… Déballage du package… Installation du thème… Le thème a été correctement installé. Succès: installé 1 des 1 thèmes.
Et vérifions que le thème Twenty Eleven a été installé correctement:
liste de thèmes wp
+-----------------+----------+--------+---------+ | nom | statut | mise à jour | version | + ----------------- + ---------- + -------- + --------- + | vingt et un | inactif | aucun | 2,5 | | vingt-cinq | inactif | aucun | 1,7 | | vingt-sept ans | actif | aucun | 1.1 | | vingt-six ans | inactif | aucun | 1,3 | | vingtten | inactif | aucun | 2,2 | +-----------------+----------+--------+---------+
Pour les plugins et les thèmes hébergés ailleurs, entrez simplement le chemin complet du fichier zip. Le nom du plugin / thème est en fait le slug, ce qui est pratique pour se rappeler si le nom de votre plugin / thème est composé de plusieurs mots..
Par exemple, pour installer le plugin Theme Check à partir du référentiel WordPress:
plugin wp installer thème-vérifier
Pour activer un plugin, utilisez le Activer commander.
plugin wp activer jetpack
Ou vous pouvez installer et activer un plugin sur une seule ligne.
plugin wp installer jetpack --activer
Pour supprimer un plugin, utilisez le effacer commander.
wp plugin supprimer jetpack
Notez que vous n'aviez pas besoin de désactiver le plugin avant de le supprimer, comme vous devez le faire dans l'administrateur WordPress. Le processus d'installation / activation / suppression est le même pour les thèmes.
Articles et pages
Il existe différentes commandes WP-CLI pour gérer tout type de publication, y compris un moyen de générer en masse des publications..
Commençons par afficher la liste actuelle des publications.
Comme vous pouvez le constater, cinq nouveaux articles ont été créés, chacun avec un titre générique et aucun contenu. Nous pouvons générer un nombre quelconque de messages et pour n'importe quel type de message..
wp post generate --post_type = page --count = 3
Génération de messages 100% [=============] 0:02 / 0:03
Cela génère trois nouvelles pages avec des titres génériques et aucun contenu de page. Je ne suis pas trop sûr de l'utilité de la création après publication en masse. Cependant, cela pourrait être très utile à des fins de test.
Si nous voulons créer des publications individuelles, nous avons un contrôle total sur le contenu des publications. Créons un seul article avec un titre et un exemple de contenu spécifiques.
wp post create --post_title = 'Juste un post' --post_content = 'Je me suis baladé seul comme un nuage.' --post_status = 'publier'
Succès: créé après 45.
Cela crée un article avec un titre et un contenu spécifiques. Par défaut, les publications seront créées avec le statut de brouillon. Par conséquent, si nous voulons qu’elles soient publiées immédiatement, nous devons définir le post_status paramètre à publier.
Créer une page avec du contenu est tout aussi simple: il vous suffit de définir le Type de poste paramètre à page (ceci est configuré pour poster par défaut).
wp post create --post_type = page --post_title = 'Bienvenue dans une nouvelle aube' --post_content = 'Continuez votre lecture pour des aperçus incroyables.' --post_status = publier
Nous pouvons également mettre à jour les publications existantes en utilisant le mettre à jour commander.
wp post update 45 --post_content = 'Je viens de mettre à jour le contenu du message via WP-CLI.' --post_status = 'publier'
Succès: mise à jour après 45.
Assurez-vous que le post ID est correct. sinon, vous aurez un Avertissement: identifiant de post invalide Message d'erreur. Et encore une fois, vous pouvez mettre à jour tout type de message, pas seulement les messages!
Comme vous vous en doutez, vous pouvez également supprimer des publications via WP-CLI..
wp post delete 45
Succès: poste détruit 45.
Cela enverra le message à la corbeille. Si vous voulez ignorer cela et simplement supprimer définitivement un message, ajoutez le --Obliger paramètre.
wp post delete 45 --force
Globalement, je pense que la gestion des publications via WP-CLI est assez intuitive. Je n'ai pas l'impression de devoir me souvenir de nombreux détails chaque fois que je veux créer ou mettre à jour un message..
C’est formidable, car cela signifie que je suis beaucoup plus susceptible de continuer à revenir à la WP-CLI plutôt que de me faufiler à nouveau à l’aide de la confortable interface utilisateur de l’administrateur de WordPress, à laquelle je suis plus habitué.
Commentaires WordPress
La gestion des commentaires est assez similaire aux messages. Pour voir tous les commentaires sur votre site, utilisez cette commande:
Assurez-vous de spécifier le compter paramètre si vous ne voulez pas générer 100 commentaires factices, car 100 est la valeur par défaut!
Pour supprimer un commentaire, utilisez simplement la commande suivante avec l’ID de votre commentaire et éventuellement le --Obliger paramètre si vous voulez éviter de l'envoyer à la corbeille.
wp comment delete 26 --force
Success: Commentaire supprimé 26.
Rappelez-vous, cependant, l'identifiant ici est un identifiant de commentaire et ne pas un identifiant de poste.
Ressources WP-CLI recommandées
Voilà pour notre introduction de base à la WP-CLI. Vous trouverez ci-dessous une liste de ressources si vous souhaitez approfondir et approfondir vos connaissances..
Page principale du projet WP-CLI
Manuel officiel WP-CLI
Feuille de route WP-CLI
Slack Channel
Liste complète des commandes WP-CLI
WP-CLI Twitter Feed
Tutoriel complet sur le serveur de bureau
Conclusion
Nous venons tout juste de vous montrer ce que vous pouvez faire avec WP-CLI. Mais si tout va bien, vous aurez maintenant assez de confiance pour approfondir la WP-CLI et expérimenter avec des commandes plus avancées.
Nous avons appris ce qu'est le WP-CLI et son utilité dans le développement quotidien de WordPress. Même si les commandes que nous avons couvertes étaient plutôt basiques, elles étaient quand même très utiles!
C'était la première fois que j'utilisais personnellement le WP-CLI et, rétrospectivement, je peux dire en toute honnêteté que je ne sais pas comment j'ai réussi à m'en passer. C'est certainement quelque chose que je me vois utiliser beaucoup plus.
J'aimerais avoir une expérience avec des commandes beaucoup plus complexes pour voir vraiment ce que vous pouvez faire avec WP-CLI..
Certains utilisateurs, en particulier les débutants, pourraient toutefois être rebutés par le processus d'installation recommandé par défaut. C’est dommage car le WP-CLI est extrêmement utile et tous les développeurs WordPress devraient au moins le vérifier..
C'est très amusant et utile. Si vous avez accès à DesktopServer, utilisez-le avec certitude pour installer WP-CLI, c'est une évidence..
Enfin, si vous souhaitez plus de développement WordPress, n'oubliez pas de consulter les autres documents WordPress que nous avons ici sur Envato Tuts+.
Utilisez-vous déjà le WP-CLI, ou s'agissait-il de votre première expérience? Si oui, comment ça s'est passé? J'aimerais entendre vos commentaires!
Share
Accentsconagua
