Intéragir et manager Wordpress avec WP-CLI

WP-CLI, mais qu'est-ce que c'est ?

WP-CLI est une interface en ligne de commande pour Wordpress. Elle vous permet d’interagir et manager Wordpress, sans utiliser votre navigateur Web. Le but est d'offrir une alternative complète au panneau d'administration de WP. Installer Wordpress, mettre à jour ses extensions, ses thèmes, créer, éditer et supprimer des pages, devient un véritable jeu d'enfant!

Installation de WP-CLI

Tout d'abord, et avant d'installer WP-CLI, assurez-vous que votre environnement répond aux éxigences minimales : - Environnement UNIX (OS X, Linux, FreeBSD, Cygwin), support limité sur les environnement Windows - PHP 5.3.29 ou plus - Wordpress 3.7 ou plus, les versions versions plus anciennes de Wordpress auront des fonctionnalités dépréciées Une fois votre environnement vérifié, téléchargez le fichier wp-cli.phar en utilisant wget, curl ou en cliquant sur le lien précédent. [code language="bash"] curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar [/code] Il faut ensuite vérifier que le fichier .phar fonctionne : [code language="bash"] php wp-cli.phar --infos [/code] Pour utiliser WP-CLI en tapant "wp" dans la console, il faut rendre le fichier exécutable et le déplacer quelque part dans votre PATH. Par exemple : [code language="bash"] chmod +x wp-cli.phar sudo mv wp-cli.phar /usr/local/bin/wp [/code] Aussi, si WP-CLI est bien installé, vous devriez obtenir quelque chose comme ceci lorsque vous entrez la commande wp --info : [code language="bash"] $ wp --info OS: Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jan 11 22:59:40 PST 2018; root:xnu-3789.73.8~1/RELEASE_X86_64 x86_64 Shell: /bin/zsh PHP binary: /usr/local/bin/php PHP version: 7.0.22 php.ini used: /etc/local/etc/php/7.0/php.ini WP-CLI root dir: /home/wp-cli/.wp-cli WP-CLI vendor dir: /home/wp-cli/.wp-cli/vendor WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/ WP-CLI global config: /home/wp-cli/.wp-cli/config.yml WP-CLI project config: WP-CLI version: 1.5.1 [/code]

Installer Wordpress avec WP-CLI

Avant toutes choses, rendez-vous sur votre serveur de développement (MAMP, Vagrant, Serveur mutualisé ou dédié via ssh) et créez un nouveau dossier : [code language="bash"] $ cd path/to/folder $ mkdir mon-wordpress $ cd mon-wordpress [/code]

Téléchargement de Wordpress

Ensuite téléchargez Wordpress avec la commande wp core : [code language="bash"] # On télécharge Wordpress en forçant la langue en FR $ wp core download --locale=fr_FR Downloading WordPress 4.9.2 (fr_FR)... md5 hash verified: c5366d05b521831dd0b29dfc386e56a5 Success: WordPress downloaded. # On affiche la version de Wordpress $ wp core version 4.9.2 # Mettre à jour la version de Wordpress $ wp core update Updating to version 4.5.2 (fr_FR)... Downloading update from https://downloads.wordpress.org/release/wordpress-4.5.2-no-content.zip... Unpacking the update... Cleaning up files... No files found that need cleaning up Success: WordPress updated successfully. [/code] Cette commande va télécharger tous les fichiers Wordpress + les sous dossiers (wp-content, wp-includes, ...) dans votre dossier de travail.

Création du fichier wp-config.php et de la base de données

Ensuite il faut installer Wordpress, pour ce faire il faudra créer le fichier de configuration wp-config.php  avec la commande wp-config : [code language="bash"] # wp-config.php standard $ wp config create --dbname=my_database --dbuser=root --dbpass=root --dbprefix=wp123 --locale=fr_FR [/code]

•  --dbname : Nom de la base de données
• --dbuser : Utilisateur de la base de données
• --dbpass : Mot de passe de la base de données
• --dbprefix : Préfixe de la base de données
• --locale : Langue de votre instance Wordpress

Une fois le fichier wp-config.php créé, il faudra initier la base de données avec la commande suivante wp db : [code language="bash"] # Création de la base de données $ wp db create Success: Database created. [/code] La création de la base de données va se concentrer sur les infos contenues dans le fichier wp-config.php. Dans notre exemple, les renseignements de la BDD seront les suivants :

• Nom : my_database
• Utilisateur : root
• Mot de passe : root.

Installation de Wordpress

Une fois votre fichier wp-config.php et votre base de données créés, vous pouvez installer Wordpress avec la commande wp core : [code language="bash"] # Installation de Wordpress $ wp core install --url=http://local.dev/mon-wordpress --title="Mon site Wordpress" --admin_user=admin --admin_password=strongpassword [email protected] Success: WordPress installed successfully. [/code]

• --url : Url du site
• --title : Titre du site
• --admin_user : administrateur du site
• --admin_password : mot de passe de l'administrateur
• --admin_email : email de l'adinistrateur

CONGRATULATIONS!!! Vous venez d'installer un nouveau site Wordpress avec WP-CLI. Votre site est maintenant accessible à l'url http://local.dev/mon-wordpress.

Manager les thèmes Wordpress

Grâce à WP-CLI vous pouvez installer et manager des thèmes sur votre site Wordpress. Pour ce faire, il vous faudra utiliser la commande wp theme : [code language="bash"] # Installation d'un thème (ex: twentysixteen) $ wp theme install twentysixteen Installing Twenty Sixteen (1.2) Downloading install package from https://downloads.wordpress.org/theme/twentysixteen.1.2.zip... Unpacking the package... Installing the theme... Theme installed successfully. # Activation du thème $ wp theme activate twentysixteen Success: Switched to 'Twenty Seventeen' theme. # Vous pouvez installer et activer un thème avec cette commande $ wp theme install twentysixteen --activate Installing Twenty Sixteen (1.2) Downloading install package from https://downloads.wordpress.org/theme/twentysixteen.1.2.zip... Unpacking the package... Installing the theme... Theme installed successfully. Activating 'twentysixteen'... Success: Switched to 'Twenty Sixteen' theme. # Afficher la liste des thèmes $ wp theme list +--------------------+----------+-----------+---------+ | name | status | update | version | +--------------------+----------+-----------+---------+ | twentysixteen | active | available | 1.4 | +--------------------+----------+-----------+---------+ # Mettre un jour un thème $ wp theme update twentysixteen Downloading update from https://downloads.wordpress.org/theme/twentysixteen.1.2.zip... Unpacking the update... Installing the latest version... Removing the old version of the theme... Theme updated successfully. +-----------------+-------------+-------------+---------+ | name | old_version | new_version | status | +-----------------+-------------+-------------+---------+ | twentysixteen | 1.4 | 1.6 | Updated | +-----------------+-------------+-------------+---------+ Success: Updated 1 of 1 themes. # Supprimer un thème $ wp theme delete twentysixteen Deleted 'twentytsixteen' theme. Success: Deleted 1 of 1 themes. # Vous pouvez intéragir sur plusieurs thèmes à la fois en listant les thèmes les un à la suite des autres $ wp theme install twentyfifteen twentysixteen twentyseventeen # Ou intéragir sur tous les thèmes $ wp theme delete --all [/code]

Manager les plugins Wordpress

Grâce à WP-CLI vous pouvez installer et manager des plugins sur votre site wordpress, pour ce faire il faut utiliser la commande wp plugin : [code language="bash"] # Installation d'un plugin Wordpress (ex: bbpress) $ wp plugin install bbpress Installing bbPress (2.5.9) Downloading install package from https://downloads.wordpress.org/plugin/bbpress.2.5.9.zip... Using cached file '/home/vagrant/.wp-cli/cache/plugin/bbpress-2.5.9.zip'... Unpacking the package... Installing the plugin... Plugin installed successfully. Success: Installed 1 of 1 plugins. # Activation d'un plugin $ wp plugin activate bbpress Plugin 'bbpress' activated. Success: Activated 1 of 1 plugins. # Désactivation d'un plugin $ wp plugin deactivate bbpress Plugin 'bbpress' deactivated. Success: Deactivated 1 of 1 plugins. # Installation et activation d'un plugin $ wp plugin install bbpress --activate Installing bbPress (2.5.9) Downloading install package from https://downloads.wordpress.org/plugin/bbpress.2.5.9.zip... Using cached file '/home/vagrant/.wp-cli/cache/plugin/bbpress-2.5.9.zip'... Unpacking the package... Installing the plugin... Plugin installed successfully. Activating 'bbpress'... Plugin 'bbpress' activated. Success: Installed 1 of 1 plugins. # Désinstaller un plugin $wp plugin delete bbpress Deleted 'bbpress' plugin. Success: Deleted 1 of 1 plugins. # Vous pouvez intéragir sur plusieurs plugins en même temps $wp plugin install hello bbpress contact-form-7 --activate $wp plugin delete --all [/code]

En conclusion

WP-CLI est un outil très pratique pour manager votre site Wordpress sans utiliser le panneau d'administration dans votre navigateur. Nous venons donc de partager avec vous des exemples basiques comme la gestion des thèmes et des plugins, mais ce n'est qu'un léger aperçu de tout ce que vous pouvez réaliser grâce aux commandes WP-CLI. Si vous voulez plus d'informations n'hésitez pas à consulter le site officiel de WP-CLI : wp-cli.org.