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

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.

Consultez la référence des métadonnées SEOPress pour les autres clés des contenus et termes.