--- title: SEOPress & WP-CLI url: "https://www.seopress.org/fr/support/guides/seopress-wp-cli/" lang: fr-FR updated: 2026-09-29 --- # SEOPress & WP-CLI Gérez SEOPress en ligne de commande avec WP-CLI. Exécutez les commandes dans la bonne installation WordPress ou utilisez l’option `--path` de WP-CLI. Sauvegardez la base avant les imports, suppressions ou migrations. Remplacez les identifiants et chemins d’exemple par vos valeurs. Les commandes spécifiques de réglages, IA, analyse de contenu, licence et redirections nécessitent SEOPress PRO et SEOPress Free. Les commandes `wp post meta`, `wp term meta` et `wp option` sont fournies par WP-CLI pour WordPress. Les commandes Insights nécessitent SEOPress Insights. ## Exporter les réglages vers un fichier JSON privé ``` wp seopress settings export --destination='/home/example/private/seopress-settings.json' --exclude=license,api_keys ``` Créez d’abord le dossier privé et donnez à l’utilisateur de la commande le droit d’y écrire. `--destination` accepte un fichier JSON ou un dossier. Un dossier utilise le nom `seopress-settings.json`. Sans cette option, le dossier de travail courant est utilisé. Les destinations publiques, dont la racine Web et uploads, et les destinations symboliques sont refusées. Un export existant au même emplacement est remplacé. Sans exclusions, l’export peut contenir la clé de licence et les identifiants API. Utilisez `--exclude=license,api_keys` pour une configuration réutilisable sans ces catégories. Les autres catégories comprennent `knowledge_graph`, `social_profiles`, `analytics_ids` et `verification_codes`. Exécuter `wp seopress settings export --exclude` affiche les catégories disponibles sous forme d’erreur de validation et n’exporte aucun fichier. Des extensions peuvent ajouter des catégories. ## Importer les réglages globaux ``` wp seopress settings import --from='/home/example/private/seopress-settings.json' ``` `--from` accepte un fichier JSON ou un dossier contenant `seopress-settings.json`. Sans cette option, la commande cherche dans le dossier courant puis dans uploads pour les anciens exports. Préférez un chemin privé explicite. L’import applique des réglages globaux ; contrôlez ensuite la configuration du site cible. Il ne remplace pas une sauvegarde complète de la base WordPress ou des métadonnées des contenus. ## Lire, modifier et supprimer des métadonnées SEO Ces exemples lisent le titre d’un contenu, le remplacent et suppriment la valeur personnalisée. La suppression laisse les valeurs par défaut habituelles de SEOPress s’appliquer. Exécutez uniquement l’opération souhaitée. ``` wp post meta get 123 _seopress_titles_title wp post meta update 123 _seopress_titles_title "Example SEO title" wp post meta delete 123 _seopress_titles_title ``` Pour les termes de taxonomie, utilisez l’identifiant du terme et la même clé de métadonnée : ``` wp term meta get 45 _seopress_titles_title wp term meta update 45 _seopress_titles_title "Example category title" wp term meta delete 45 _seopress_titles_title ``` ## Générer des titres, descriptions et textes alternatifs Configurez un fournisseur IA dans SEOPress PRO avant la génération. Les commandes de métadonnées utilisent les identifiants des contenus ; celles de textes alternatifs utilisent les identifiants des pièces jointes. Les résultats sont affichés pour chaque identifiant. La génération peut consommer des crédits et est enregistrée par défaut. ``` wp seopress ai metadata --id=123,124 --meta=desc --language=en_US wp seopress ai alt_text --id=456,457 --language=en_US ``` Pour les métadonnées, `--meta=title` génère le titre, `--meta=desc` la description ; omettez `--meta` pour générer les deux. `--language` vaut `en_US` par défaut ; utilisez une locale comme `fr_FR` ou `es_ES`. Pour les métadonnées, omettez `--autosave` pour conserver l’enregistrement par défaut ; `--autosave=0` génère sans enregistrer. Considérez `alt_text` comme une commande d’écriture : son argument `--autosave` ne fournit pas de prévisualisation fiable sans enregistrement. Elle peut aussi générer et enregistrer la légende et la description de la pièce jointe. Par défaut, elle peut remplacer des valeurs existantes. Utilisez `--update_empty_alt_text=0` pour limiter les modifications aux champs vides. Testez sur une pièce jointe sauvegardée avant de traiter une liste. ``` wp seopress ai metadata --id=123 --meta=title --autosave=0 wp seopress ai alt_text --id=456 --update_empty_alt_text=0 ``` ## Lire et modifier les options globales ``` wp option get seopress_titles_option_name --format=json wp option patch update seopress_titles_option_name seopress_titles_home_site_title "Example homepage title" ``` La première commande lit l’option ; la seconde modifie seulement le champ imbriqué du titre d’accueil. Pour supprimer l’ensemble de l’option Titres et métas, utilisez volontairement la commande suivante après sauvegarde. Elle supprime toute l’option, pas uniquement le titre d’accueil. ``` wp option delete seopress_titles_option_name ``` ## Gérer la licence PRO | Commande | Effet | | --- | --- | | `wp seopress-pro license activate` | Active la clé enregistrée ; `--key` permet d’en fournir une. Une constante `SEOPRESS_LICENSE_KEY` définie est prioritaire. | | `wp seopress-pro license deactivate` | Désactive la licence du site actuel. | | `wp seopress-pro license status` | Affiche l’état enregistré, l’expiration et les informations masquées de la clé. | | `wp seopress-pro license reset` | Efface les réglages de licence enregistrés et les caches de mise à jour ; ne supprime pas une constante de wp-config.php. | | `wp seopress-pro license update` | Vérifie et installe une mise à jour PRO disponible ; une licence valide est nécessaire pour obtenir les mises à jour sous licence. | ## Importer des redirections par lots Placez l’export sur le serveur à un emplacement lisible. Listez les formats pris en charge par la version installée, puis lancez un essai avant l’import réel. Un essai prépare et vérifie le fichier sans créer de redirections. ``` wp seopress-pro redirections sources wp seopress-pro redirections import '/home/example/private/redirects.csv' --dry-run wp seopress-pro redirections import '/home/example/private/redirects.csv' --batch=1000 wp seopress-pro redirections import '/home/example/private/rankmath.json' --source=rankmath ``` `--source` accepte `csv`, `redirections_plugin`, `yoast`, `rankmath`, `rankmath_csv`, `slimseo`, `aioseo` et `smartcrawl`. Un CSV sans source explicite est traité comme un CSV SEOPress. Un JSON nécessite sa source, car l’extension seule ne permet pas d’identifier l’outil d’export. `--separator` accepte `auto` (défaut), `comma`, `semicolon`, `tab` ou `pipe`. `--batch` contrôle le nombre de redirections écrites par tranche. Si un import est interrompu, reprenez le traitement enregistré sans démarrer un nouveau fichier : ``` wp seopress-pro redirections import --resume ``` ## Actualiser l’analyse de contenu en arrière-plan ``` wp seopress content-analysis run wp seopress content-analysis status wp seopress content-analysis cancel ``` Activez d’abord l’audit de site. La commande run met des lots en file d’attente et rend la main avant la fin. WP-Cron, ou un ordonnanceur système exécutant les événements WordPress dus, doit fonctionner. La taille de lot et les exclusions configurées s’appliquent. Consultez status pour l’avancement et la dernière erreur. Cancel arrête la file partagée de l’audit sans supprimer les scores enregistrés. Sans `--post_type`, le périmètre existant est conservé. Fournir cette option modifie le réglage enregistré des types de contenus de l’audit ; ce n’est pas une substitution temporaire. Utilisez des types publics enregistrés et pris en charge. Un seul audit peut s’exécuter à la fois. ``` wp seopress content-analysis run --post_type=post,page ``` ## Migrer les données SEOPress Insights Avec SEOPress Insights 3.0, la migration déplace l’historique des positions et backlinks des métadonnées vers des tables dédiées. Ces commandes appartiennent à Insights, pas à Free ou PRO. Sans `--full`, chaque commande traite un lot. ``` wp seopress-insights migrate-backlinks wp seopress-insights migrate-backlinks --full wp seopress-insights migrate-rankings wp seopress-insights migrate-rankings --full ``` Pour les positions, `--force` remet à zéro la progression et l’état enregistrés puis relance la migration. Utilisez-le seulement pour abandonner l’état de migration enregistré, après sauvegarde de la base. ``` wp seopress-insights migrate-rankings --full --force ``` ## Dépanner les commandes Si une commande spécifique est inconnue, vérifiez le site ciblé, le chargement des extensions nécessaires et l’aide de la version installée avec `wp help seopress` ou `wp help seopress-pro`. Un export nécessite un accès direct au système de fichiers WordPress et une destination privée accessible en écriture. Un audit en attente sans progression nécessite de vérifier les événements planifiés et l’erreur de status. Pour les commandes natives, consultez la [référence WP-CLI](https://developer.wordpress.org/cli/commands/). Consultez la [référence des métadonnées SEOPress](https://www.seopress.org/support/guides/list-of-all-post-metas-generated-by-seopress/) pour les autres clés des contenus et termes.