Commandes courantes

Il existe un certain nombre de commandes qui peuvent vous être utiles lorsque vous travaillez sur votre site. Ces commandes et leurs paramètres courants sont présentés ci-dessous. De nombreuses autres commandes utiles sont également disponibles, et ces sections ne les couvrent pas toutes. Veuillez consulter le guide des commandes CLI pour les développeurs de WordPress.org pour plus d’informations.

Gérer les utilisateurs

Utilisez les commandes suivantes pour gérer les utilisateurs locaux de votre site. Veuillez noter que la modification des paramètres utilisateur dans la CLI ne modifiera pas les réglages des comptes utilisateur WordPress.com qui peuvent être associés aux comptes locaux.

wp user list

Liste tous les utilisateurs du site. Si vous avez de nombreux utilisateurs, vous pouvez restreindre la liste à des rôles spécifiques en utilisant l’option --role :

wp user list –role=adminstrator

wp user get {USER ID/NAME/EMAIL}

Renvoie un utilisateur spécifique, soit par ID utilisateur, nom d’utilisateur ou adresse e-mail.

wp user create {NAME} {USER EMAIL} –role={ROLE}

Crée un nouvel utilisateur avec le nom, l’adresse e-mail et le rôle définis.

Cette commande ne crée pas d’utilisateur WordPress.com correspondant. Si vous utilisez la connexion sécurisée WordPress.com (SSO), vous devriez plutôt créer l’utilisateur local en invitant un utilisateur via Utilisateurs > Ajouter. Cela garantira qu’un compte WordPress.com et un utilisateur local seront tous deux créés.

wp user update {USER ID/NAME/EMAIL} –{KEY}={VALUE}

Met à jour un utilisateur en fonction de l’ID utilisateur, du nom ou de l’adresse e-mail. Met à jour l’ensemble des paires clé/valeur spécifiées. 

Les clés incluent display_name, user_email, role et user_pass

Remarque : vous ne pourrez pas mettre à jour le user_login d’un utilisateur avec la commande wp user update. À la place, la mise à jour du user_login nécessite l’utilisation de wp search-replace. Ce changement n’est cependant pas recommandé, car il effectue des remplacements partiels. Par exemple : s’il y a deux utilisateurs avec les noms d’utilisateur « techie » et « nontechie », remplacer « techie » par « sense » donnera « sense » et « nonsense ».

Si vous souhaitez tout de même remplacer un user_login, la commande à utiliser est :

wp --skip-plugins --skip-themes search-replace "old username" "new username" *users --include-columns=user_login,user_nicename --dry-run

Gérer les extensions et les thèmes

Utilisez les commandes suivantes pour gérer vos extensions et vos thèmes. Lorsque vous travaillez avec des extensions et des thèmes, veuillez noter que le slug associé ne correspond pas toujours au nom de l’extension ou du thème.

Si vous rencontrez des problèmes avec une extension ou un thème, vous pouvez commencer votre commande par wp --skip-themes --skip-plugins pour exécuter les commandes malgré les conflits.

Vous trouverez plus d’informations sur les commandes skip ci-dessous.

wp plugin/theme list

Liste toutes les extensions et tous les thèmes installés sur le site, ainsi que leur statut. Dans ces listes, vous trouverez les slugs de vos extensions et thèmes installés, que vous pourrez utiliser pour exécuter les commandes ci-dessous.

wp plugin/theme activate {SLUG}

Active l’extension ou le thème spécifié.

Pour désactiver un thème, vous devez en activer un autre à sa place.

wp plugin deactivate {SLUG}

Désactive l’extension spécifiée.

wp plugin/theme delete {SLUG}

Supprime l’extension ou le thème spécifié.

Vous ne pouvez pas supprimer un thème actif ou des thèmes gérés avec cette commande. Pour supprimer un thème actif, basculez d’abord vers un autre thème, puis supprimez le thème souhaité. Pour supprimer des thèmes gérés, vous pouvez le faire via SFTP.

wp plugin/theme install {SLUG or URL TO INSTALLATION_FILE}

Installe une extension ou un thème depuis le dépôt WordPress.org à partir du slug ou via un chemin d’URL vers un fichier d’installation .zip.

Vous ne pouvez pas écraser une extension ou un thème existant à moins d’exécuter la commande avec le drapeau --force. Vous pouvez utiliser cette option pour mettre à jour des extensions et réparer des dossiers d’extensions corrompus.

Pour activer automatiquement une extension après l’installation, ajoutez le drapeau --activate.

wp plugin/theme update {SLUG}

Met à jour l’extension ou le thème spécifié si une mise à jour est disponible. Vous ne pouvez pas utiliser cette commande pour mettre à jour des extensions ou thèmes gérés.

Vous pouvez également utiliser le drapeau --all si vous souhaitez mettre à jour toutes les extensions et tous les thèmes.

wp plugin auto-updates {COMMAND} {PLUGIN SLUG}

Affiche le statut des mises à jour d’extensions ou active/désactive les mises à jour pour une extension spécifique.

Les COMMANDES disponibles sont status, enable, disable.

Vous ne pouvez pas désactiver les mises à jour pour les extensions ou thèmes gérés.

Gérer Jetpack

Utilisez les commandes suivantes pour ajuster les modules Jetpack, vérifier votre connexion Jetpack ou résoudre les problèmes liés à Jetpack.

wp jetpack module list

Liste les modules Jetpack et leurs statuts.

wp jetpack module activate {MODULE NAME}

Active le module Jetpack spécifié.

Vous pouvez également utiliser all à la place de {MODULE NAME}

wp jetpack module deactivate {MODULE NAME}

Désactive le module Jetpack spécifié.

Vous pouvez également utiliser all à la place de {MODULE NAME}

wp jetpack status

Affiche l’état de Jetpack, y compris le compte utilisateur qui constitue la connexion principale (il doit toujours s’agir du propriétaire du site).

Un paramètre supplémentaire, full, peut être ajouté pour afficher les détails complets, y compris la version de Jetpack, la version de WordPress et l’état des modules.

Gérer les Réglages du site

Utilisez les commandes suivantes pour gérer divers aspects de votre site et de vos utilisateurs.

wp site empty –yes

Vider un site de son contenu (articles et pages).

wp site empty –uploads –yes

Vider le site, y compris les fichiers médias.

Les commandes wp site ne supprimeront pas les thèmes ni les extensions, et ne réinitialiseront pas un thème ni n’effaceront les réglages des extensions. Si vous avez besoin de réinitialiser complètement votre site, veuillez contacter l’assistance WordPress.com.

wp option get {OPTION}

Retourner la valeur d’une option.

wp option update {OPTION} {VALUE}

Mettre à jour la valeur d’une option.

wp option add {OPTION} {VALUE}

Ajouter une nouvelle option.

wp option delete {OPTION}

Supprimer une option.

Lorsque vous utilisez les commandes wp option, si vous obtenez l’erreur suivante dans le terminal, cela peut signifier que la table des options est corrompue :

One or more database tables are unavailable. The database may need to be repaired

Vous pouvez restaurer la table en rembobinant la table SQL du site vers une dernière copie fonctionnelle. Veuillez noter que cela annulera toutes les modifications apportées à la base de données après le point de restauration et peut entraîner une perte de données.

Pour restaurer une table SQL :

1. Dans le tableau de bord du site, accédez à Jetpack > Journal d’activités.
2. Sélectionnez un point de sauvegarde vers lequel rembobiner.
3. Décochez toutes les cases sauf Base de données du site (SQL).
4. Cliquez sur Confirmer le rembobinage.

wp role list

Renvoie une liste de rôles

wp role reset {ROLE}

Réinitialise le rôle spécifié. Vous pouvez lister plusieurs rôles (sans virgules)

wp reset role administrator editor

Vous pouvez également remplacer {ROLE} par --all pour tout réinitialiser en une seule fois

Gérer le contenu

Vous pouvez utiliser les commandes suivantes pour gérer le contenu de votre site, y compris les articles/pages, les menus et les médias.

wp post list

Renvoie une liste d’articles de blog.

Vous pouvez utiliser différents indicateurs avec cette commande, notamment :

--format={FORMAT}

--posts_per_page={#}

--post_type={TYPE}

Les types de publication possibles incluent posts, pages, attachments et products.

Plusieurs indicateurs peuvent être utilisés simultanément.

wp post list --post_type=posts,pages --format=count

wp post update {POST_ID} –{KEY}={VALUE}

Met à jour les informations d’une publication.

wp post update123 --post_status=draft

wp post delete {POST_ID}

Supprimer une publication.

wp post exists {POST_ID}

Vérifier si une publication existe.

wp menu list

Lister les menus du site.

wp menu item list {TERM_ID}

Lister les éléments de menu d’un menu spécifique.

wp menu item update {MENU_ITEM_PARENT_ID}

Mettre à jour un élément de menu spécifique.

wp media regenerate

Régénérer les miniatures des médias lorsque le module Photon de Jetpack est désactivé.

Vous pouvez utiliser le drapeau --only-missing pour ignorer les tailles d’image existantes.

Résolution des problèmes du site

Vous pouvez utiliser les commandes suivantes lors de la résolution des problèmes sur votre site. Vérifier les erreurs PHP peut vous aider à identifier les sources d’erreurs sur votre site, ou vous pouvez utiliser les commandes wp wpcomsh pour effectuer rapidement des vérifications de conflits d’extensions ou ajuster l’utilisation de versions gérées d’extensions.

wp php-errors

Afficher les journaux d’erreurs dans WP-CLI.

Cette commande n’affiche que les erreurs PHP, et non celles d’autres langages tels que HTML, Javascript ou CSS. Pour voir ces autres erreurs, utilisez l’inspecteur du navigateur.

Vous pouvez ajouter le drapeau --limit pour réduire le nombre d’erreurs affichées afin d’améliorer la lisibilité.

wp php-errors –limit10

wp wpcomsh deactivate-user-plugins

Désactiver les extensions utilisateur.

Vous pouvez utiliser le drapeau --interactive pour demander une confirmation pour chaque extension.

Cette commande ne désactivera pas Akismet, Jetpack ni les extensions e-commerce gérées.

wp wpcomsh reactivate-user-plugins

Réactiver les extensions utilisateur.

Vous pouvez utiliser le drapeau --interactive pour demander une confirmation pour chaque extension.

wp wpcomsh persistent-data {DATA}

Renvoie les données persistantes (que Jetpack utilise pour vérifier les capacités du site).

Les options de DATA disponibles incluent :

WPCOM_PLAN_EXPIRATION

JETPACK_BLOG_TOKEN

WPCOM_PURCHASES

WPCOM_PUBLIC_COMING_SOON

wp wpcomsh plugin use-managed {SLUG}

Utilise une version gérée (par lien symbolique) d’une extension.

Cette commande supprimera les versions existantes non gérées et les remplacera par des versions gérées. Elle est disponible pour amp, classic-editor, coblocks, crowdsignal-forms, full-site-editing, gutenberg, layout-grid, page-optimize, wp-seo, woocommerce, les extensions WooCommerce de la Marketplace WordPress.com, et les extensions incluses dans le plan Commerce.

Vous pouvez utiliser le drapeau --remove-existing pour ignorer l’étape de confirmation.

wp wpcomsh theme use-managed {SLUG}

Utiliser une version gérée (avec lien symbolique) d’un thème.

Cette commande supprimera les versions existantes non gérées et les remplacera par des versions gérées. Elle est disponible pour tous les thèmes WordPress.com, Storefront et tous les thèmes Twenty * (ex. : Twenty Twenty Two).

Vous pouvez utiliser le drapeau --remove-existing pour ignorer l’étape de confirmation.

wp wpcomsh plugin use-unmanaged {SLUG}

Utiliser une version non gérée (sans lien symbolique) d’une extension.

Cette commande supprimera les versions gérées existantes et les remplacera par des versions non gérées provenant du répertoire d’extensions WordPress.org. Elle ne fonctionnera pas pour les extensions WooCommerce du Marketplace WordPress.com ni pour les extensions incluses dans le plan Commerce. Vous devrez installer ces extensions manuellement pour obtenir la version non gérée.

Vous pouvez utiliser le drapeau --remove-existing pour ignorer l’étape de confirmation et le drapeau --version={X.Y.Z} pour définir la version à installer.

wp wpcomsh theme use-unmanaged {SLUG}

Utiliser une version non gérée (sans lien symbolique) d’un thème.

Cette commande supprimera les versions gérées existantes et les remplacera par des versions non gérées provenant du dépôt de thèmes WordPress.org, si elles sont disponibles.

Vous pouvez utiliser le drapeau --remove-existing pour ignorer l’étape de confirmation et le drapeau --version={X.Y.Z} pour définir la version à installer.

Le WordPress.com Site Helper ou l’extension incontournable (must-use) wpcomsh s’exécute sur les sites dont les fonctionnalités d’hébergement sont activées afin d’assurer leur bon fonctionnement dans l’écosystème WordPress.com.

wp cache flush

Vider le cache.

Cette commande n’est pas conçue pour résoudre des problèmes et peut masquer les causes profondes. Veuillez l’utiliser avec précaution. Vider le cache peut également ralentir votre site pendant sa reconstruction au chargement des pages.

Ignorer les extensions et les thèmes

Vous pouvez souhaiter ignorer les extensions, et parfois les thèmes, lors de l’exécution de commandes CLI. Cela peut être utile pour résoudre des conflits ou pour contourner des restrictions imposées par des extensions, comme le contrôle des rôles.

• --skip-plugins peut être ajouté avant n’importe quelle commande et permet d’ignorer les extensions
• --skip-themes peut être ajouté avant n’importe quelle commande et permet d’ignorer les thèmes

Vous pouvez utiliser ces commandes ensemble. Vous pouvez également utiliser ces commandes avec des slugs pour ignorer des extensions ou des thèmes spécifiques. Cela peut être utile pour écarter les effets de certaines extensions ou de certains thèmes lorsque la désactivation n’est pas possible.

Par exemple :

wp --skip-plugins=woocommerce, code-snippets, elementor-pro plugin list