Skip to Content
UsingMode headless

Mode headless

Utilisez le mode headless lorsque vos lecteurs visitent un site web différent de cette installation WordPress. Configurations courantes :

  • Ce WordPress fonctionne sous cms.example.com et votre blog est servi depuis example.com par un frontend Next.js, Astro ou un autre générateur statique.
  • Ce WordPress est le backend éditorial d’une SPA ou d’une application mobile, et « le site public » est un site marketing hébergé sur un domaine séparé.

Sans le mode headless, Structura suppose que cette installation WordPress est le site public. Cette hypothèse est vraie pour la grande majorité des installations mais échoue dans les configurations ci-dessus : les suggestions IA s’appuient sur la page d’accueil WP (vide en headless), les liens internes que Structura ajoute aux nouveaux articles pointent vers des URLs cms.example.com que personne ne visite, et les partages de canaux (LinkedIn, IndexNow, Slack) publient les mauvaises URLs.

Avant de commencer

Vous aurez besoin :

  • De l’URL complète de votre site web public (par exemple https://example.com).
  • D’un accès administrateur à wp-admin.

Si vous publiez depuis ce WordPress vers votre frontend via un pipeline de build CMS (Vercel ISR, Astro Content Collections, etc.), assurez-vous que cette intégration fonctionne déjà avant d’activer le mode headless — les paramètres de Structura ne décrivent que ce qui est déjà déployé.

Étapes

  1. Dans wp-admin, allez dans Réglages → Général → Site web public.
  2. Activez Mon site web public est hébergé ailleurs (mode headless).
  3. Cliquez sur Détecter et configurer automatiquement. Structura va :
    • Proposer une URL publique en supprimant un préfixe cms. de l’hôte de cette installation (donc cms.xerx.io → https://xerx.io).
    • Analyser cette URL via Jina et proposer une description et des pages clés.
    • Ouvrir une boîte de dialogue de confirmation affichant les suggestions.
  4. Vérifiez les suggestions. Appliquer les suggestions les inscrit dans le formulaire — vous pouvez toujours modifier chaque champ avant d’enregistrer.
  5. Optionnel : ajustez :
    • Description — un court paragraphe utilisé en repli lorsque l’ancrage IA ne peut pas atteindre votre page d’accueil.
    • Pages clés — les pages « à propos », « tarifs », « services », etc., vers lesquelles Structura devrait envisager de créer des liens depuis les nouveaux articles. La liste est auto-détectée depuis votre navigation ; supprimez ou renommez les lignes selon vos besoins.
    • Modèle d’URL des articles — comment Structura doit composer les URLs des articles publiés depuis ce WordPress. Le choix par défaut Substitution de préfixe ({publicUrl}/{lang}/blog/{slug}) correspond à la mise en page recommandée par Structura ; choisissez Modèle personnalisé… si votre frontend utilise un autre schéma (par exemple /news/{year}/{slug}).
    • Langue par défaut des URLs — utilisée lorsque {lang} apparaît dans le modèle d’URL. Par défaut, la langue de votre site WP.
  6. Cliquez sur Enregistrer.

Ce qui se passe ensuite

Une fois le mode headless activé :

  • L’ancrage IA analyse votre site web public, et non WordPress. Les suggestions reflètent la marque et le contenu que les lecteurs voient réellement.
  • Les liens internes que Structura ajoute aux nouveaux articles pointent vers les URLs publiques réécrites (par exemple https://example.com/fr/blog/<slug>).
  • Les canaux qui partagent des URLs d’articles (LinkedIn, Slack, webhooks) publient l’URL publique.
  • IndexNow pointe également vers l’URL publique — voir la page du canal IndexNow pour l’étape d’upload du fichier de clé spécifique aux installations headless.

À la prochaine sauvegarde d’un article par WordPress, l’URL d’article émise par Structura sur structura/post/inserted sera la version réécrite. Les articles existants conservent l’URL inscrite dans leurs méta _structura_* — une republication n’est pas nécessaire, sauf si vous souhaitez rafraîchir un état dérivé.

Problèmes courants

Le bouton « Détecter et configurer automatiquement » reste désactivé. Ce bouton ne se déclenche que s’il y a quelque chose à analyser — vérifiez que le champ URL publique contient une valeur ou que l’hôte de cette installation commence par cms. (le déclencheur de dérivation automatique). Sinon, saisissez d’abord l’URL publique manuellement.

La configuration rapide indique « scrape failed ». La cause la plus probable est que le site public est protégé (mot de passe Vercel, liste d’IP autorisées, authentification basique). Ajoutez l’URL manuellement, remplissez la description et les pages clés vous-même, puis enregistrez.

Les aperçus de canal affichent toujours des URLs cms.*. Déclenchez une nouvelle publication — Structura ne calcule l’URL réécrite qu’au moment de l’insertion, donc les cartes d’aperçu cachées sur les articles existants ne seront pas mises à jour tant que l’article n’est pas réenregistré ou qu’un nouvel événement n’est pas envoyé sur le canal.

Le fichier de clé IndexNow ne se vérifie pas. Consultez la section de dépannage IndexNow. La cause la plus fréquente est que le fichier n’est pas accessible à l’URL exacte affichée — généralement un déploiement encore en cours ou le fichier placé dans un sous-répertoire plutôt qu’à la racine publique du frontend.

Pages associées

Last updated on
Images à la une et visuelsMigrer depuis WordPress