Intégration WordPress : connectez votre CMS pour publier depuis Semji

​

En un coup d’œil

• Ce que vous pouvez faire : donner aux agents Semji un accès contrôlé à votre contenu WordPress : articles, pages et types de contenu personnalisés, avec taxonomies, champs ACF, titres SEO et méta descriptions (Yoast SEO, Rank Math ou SEOPress).
• Pour qui : propriétaires de l’espace de travail et administrateurs WordPress.
• Compatibilité : à partir de WordPress 5.6.

​

Prérequis

• WordPress 5.6 ou plus récent. Les mots de passe d’application, qui servent à la connexion, existent depuis cette version.
• Un site en ligne, public et en HTTPS. Un site local ou sur réseau interne ne peut pas être connecté.
• L’API REST de WordPress accessible. Elle est active par défaut, mais un plugin de sécurité peut l’avoir désactivée.
• Un compte WordPress autorisé à gérer les articles, rôle Auteur au minimum. Choisissez le rôle Éditeur si les agents doivent pouvoir modifier les articles rédigés par d’autres.
• Si un pare-feu, un WAF ou une protection anti-bot (Cloudflare, Akamai, Sucuri, …) se trouve devant votre site, il doit autoriser les adresses IP de Semji. Voir Pare-feu, Cloudflare et autorisation d’IP.
• Vous êtes propriétaire du workspace dans Semji. La connexion est partagée avec tout le workspace.

​

Comment connecter votre site WordPress

1

Créer un mot de passe d'application dans WordPress

Un mot de passe d’application est un mot de passe dédié que WordPress génère pour un service extérieur, ici Semji. Il n’est lié qu’à cette connexion et vous pouvez le révoquer à tout moment, sans toucher au mot de passe habituel du compte.Dans l’administration WordPress, ouvrez le compte que Semji utilisera, via Comptes → Profil (Users → Profile) ou Comptes → Tous les comptes (Users → All Users). Descendez jusqu’à la section Mots de passe d’application (Application Passwords), saisissez un nom comme Semji, puis cliquez sur Ajouter un nouveau mot de passe d’application (Add New Application Password).WordPress affiche ce mot de passe une seule fois, sous la forme xxxx xxxx xxxx xxxx xxxx xxxx. Copiez-le tout de suite. Vous pourrez le coller dans Semji avec ou sans les espaces.

La section Mots de passe d’application n’apparaît pas ? C’est que votre site n’est pas en HTTPS, tourne sur une version antérieure à WordPress 5.6, ou qu’un plugin de sécurité a désactivé la fonctionnalité.

2

Connecter depuis Semji

Vous devez être propriétaire du workspace, car la connexion vaut pour toute l’équipe. Dans Semji, ouvrez Paramètres → Intégrations, allez dans l’onglet CMS et cliquez sur Connecter sur la ligne WordPress.Remplissez les trois champs :

• URL du site : l’adresse exacte de votre site en HTTPS, par exemple https://votre-site.com. Entrez l’adresse réellement utilisée par votre site : s’il bascule de exemple.com vers www.exemple.com, saisissez la version www. Semji ne suit pas les redirections.
• E-mail ou nom d’utilisateur : l’identifiant WordPress ou l’adresse e-mail du compte auquel appartient le mot de passe d’application. WordPress accepte les deux : il cherche d’abord le nom d’utilisateur, puis l’adresse e-mail.
• Mot de passe d’application : celui généré à l’étape précédente.

Cliquez sur Suivant. Semji teste la connexion en direct en appelant GET /wp-json/wp/v2/users/me sur votre site avec ces identifiants, et détecte quel plugin SEO votre site utilise.

3

Choisir les outils WordPress

Décidez ce que les agents IA peuvent faire sur votre site. Les six outils sont activés par défaut : Créer des articles, Lire des articles, Lister les types de contenu, Lister les articles, Lister les termes de taxonomie et Mettre à jour les articles. Vous pourrez modifier cette sélection à tout moment.Mettre à jour les articles couvre aussi le titre SEO et la méta description, qui peuvent demander une configuration préalable sur votre site WordPress selon votre plugin SEO. Voir Activer la mise à jour du titre SEO et de la méta description. Et si vos types de contenu utilisent des champs ACF, exposez-les à l’API REST pour que les agents puissent les lire et les remplir. Voir Exposer les champs ACF à Semji.

4

Enregistrer

Cliquez sur Enregistrer. La ligne WordPress s’affiche désormais comme connectée.

​

Ce que Semji peut faire une fois connecté

​

Plugins SEO pris en charge

​

Activer la mise à jour du titre SEO et de la méta description

• Yoast SEO 28.1 et plus récent : rien à faire. Les versions récentes de Yoast exposent nativement leurs champs de titre SEO et de méta description à l’API REST, et Semji peut les mettre à jour tout de suite.
• Yoast SEO plus ancien, Rank Math et SEOPress : ils stockent le titre SEO et la méta description dans des champs personnalisés protégés, sur lesquels l’API REST n’accepte pas l’écriture par défaut. Un court extrait de code PHP doit d’abord déclarer ces champs auprès de l’API REST.

/**
 * Plugin Name: Semji SEO fields REST support
 * Description: Registers the SEO title and meta description fields of
 * the active SEO plugin (Yoast SEO, Rank Math, or SEOPress) with the
 * WordPress REST API so they can be read and updated by authorized
 * applications, on every public post type. Writing requires the
 * edit_posts capability.
 */

add_action('init', function () {
    // Each pair of fields is registered only while its plugin is active,
    // so an inactive plugin's fields are never exposed by mistake.
    $seo_meta_keys_by_plugin_constant = [
        'WPSEO_VERSION'      => ['_yoast_wpseo_title', '_yoast_wpseo_metadesc'],
        'RANK_MATH_VERSION'  => ['rank_math_title', 'rank_math_description'],
        'SEOPRESS_VERSION'   => ['_seopress_titles_title', '_seopress_titles_desc'],
    ];

    foreach ($seo_meta_keys_by_plugin_constant as $plugin_constant => $seo_meta_keys) {
        if (!defined($plugin_constant)) {
            continue;
        }

        foreach (get_post_types(['public' => true], 'names') as $post_type) {
            foreach ($seo_meta_keys as $meta_key) {
                register_post_meta($post_type, $meta_key, [
                    'type'          => 'string',
                    'single'        => true,
                    'show_in_rest'  => true,
                    'auth_callback' => static function () {
                        return current_user_can('edit_posts');
                    },
                ]);
            }
        }
    }
}, 20);

<?php
/**
 * Plugin Name: Semji SEO fields REST support
 * Description: Registers the SEO title and meta description fields of
 * the active SEO plugin (Yoast SEO, Rank Math, or SEOPress) with the
 * WordPress REST API so they can be read and updated by authorized
 * applications, on every public post type. Writing requires the
 * edit_posts capability.
 */

add_action('init', function () {
    // Each pair of fields is registered only while its plugin is active,
    // so an inactive plugin's fields are never exposed by mistake.
    $seo_meta_keys_by_plugin_constant = [
        'WPSEO_VERSION'      => ['_yoast_wpseo_title', '_yoast_wpseo_metadesc'],
        'RANK_MATH_VERSION'  => ['rank_math_title', 'rank_math_description'],
        'SEOPRESS_VERSION'   => ['_seopress_titles_title', '_seopress_titles_desc'],
    ];

    foreach ($seo_meta_keys_by_plugin_constant as $plugin_constant => $seo_meta_keys) {
        if (!defined($plugin_constant)) {
            continue;
        }

        foreach (get_post_types(['public' => true], 'names') as $post_type) {
            foreach ($seo_meta_keys as $meta_key) {
                register_post_meta($post_type, $meta_key, [
                    'type'          => 'string',
                    'single'        => true,
                    'show_in_rest'  => true,
                    'auth_callback' => static function () {
                        return current_user_can('edit_posts');
                    },
                ]);
            }
        }
    }
}, 20);

​

Vérifier que les champs sont exposés

curl -s -u 'USERNAME:APP_PASSWORD' \
  'https://votre-site.com/wp-json/wp/v2/posts/123' | jq '.meta.rank_math_description'

​

Exposer les champs ACF à Semji

​

Activer « Show in REST API » sur le groupe de champs

​

Vérifier que les champs ACF sont exposés

curl -s -u 'USERNAME:APP_PASSWORD' \
  'https://votre-site.com/wp-json/wp/v2/faq/123' | jq '.acf'

​

Aider les agents à bien remplir les champs

• Utilisez des noms de champs descriptifs. Un agent comprend answer_short, il ne peut que deviner ce que contient field_2.
• Gardez au moins un élément bien rempli pour chaque type de contenu. Les agents le lisent pour savoir quel champ contient quoi, et la forme de valeur attendue (texte brut ou HTML, ID de média pour un champ image, …).
• Briefez l’agent. Quand les noms de champs sont ambigus, dites dans vos instructions à quoi sert chaque champ, et l’agent y placera son contenu en conséquence.

​

Gérer ou déconnecter

• Gérer les outils : activer ou désactiver chacun des six outils.
• Déconnecter : retirer l’intégration pour tout le workspace.

​

Pare-feu, Cloudflare et autorisation d’IP

63.34.75.122
63.35.78.179
54.228.104.165
18.200.156.37
34.248.117.83
52.213.28.177

​

Dépannage

​

Articles liés

• Connecter votre CMS : publiez vos contenus dans votre CMS sans quitter Semji
• Synchroniser des brouillons vers votre CMS : le flux de publication par API, si vous préférez piloter la synchronisation vous-même.