Menu de la documentationFront-ends découplés

Front-ends découplés

Comptez les visites du front-end Astro, Next.js ou autre qui affiche vos articles WordPress, rattachées aux articles qu'il montre, avec une seule balise script.

Sur cette page

Si WordPress ne sert que d’éditeur et qu’un autre site présente les pages aux lecteurs, Vireo peut compter ce front-end. Chaque page vue est rattachée à l’article WordPress qu’elle affiche, si bien que les pages les plus vues, les statistiques par article et Search Console par article fonctionnent comme avec un thème. C’est gratuit pour un front-end.

Mise en place

  1. Allez dans Vireo Analytics > Réglages > Autres sites > Front-end découplé.
  2. Saisissez l’« Adresse du site front-end » : l’adresse que les lecteurs voient dans leur navigateur, https:// compris.
  3. Cliquez sur « Enregistrer les réglages ».
  4. Copiez la balise affichée sous « Ajouter au front-end » et collez-la avant </body> sur chaque page du front-end.

La balise ressemble à ceci, avec vos propres adresses :

<script defer src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js" data-endpoint="https://cms.example.com/..."></script>

Sur un site Astro, installez @rebelcode/vireo-astro et ajoutez à la place l’extrait que l’écran affiche sous la balise.

Copiez-la toujours depuis l’écran des réglages. L’adresse du point de terminaison dépend de votre hébergeur, et l’écran indique celle qui est utilisée.

Les pages vues envoyées depuis toute autre adresse sont refusées : la balise n’enregistre donc rien si elle est collée ailleurs.

Comment les pages sont rattachées aux articles

Par le chemin. Un front-end qui conserve la structure des permaliens WordPress n’a besoin de rien d’autre : /my-post/ sur le front-end compte pour l’article situé à /my-post/ dans WordPress.

Si vos chemins diffèrent, ajoutez l’ID de l’article à chaque page :

<meta name="vireo:post-id" content="123">

Tout le reste peut être associé en PHP avec le filtre vireo_headless_post_id.

Applications monopages

  • Les view transitions d’Astro sont comptées automatiquement.
  • Pour tout autre front-end qui change de page sans rechargement, ajoutez data-spa="history" à la balise. Chaque pushState et chaque navigation avant ou arrière compte alors comme une page vue.
  • Si votre routeur fonctionne à sa façon, appelez vireo('pageview') après le rendu de chaque nouvelle page.

Robots d’exploration et Search Console

  • Les robots d’exploration et les robots d’IA sont comptés quand ils demandent une page à WordPress.
  • Connectez Search Console pour l’adresse du front-end, puisque c’est le site que Google indexe.

Plusieurs front-ends

Le réglage du mode découplé accepte une seule adresse. Pour compter d’autres sites avec leurs propres chiffres, utilisez les sites connectés. Un développeur peut autoriser d’autres origines pour la balise découplée avec le filtre vireo_headless_allowed_origins.

Mis à jour le 11 octobre 2026. Une erreur ou un oubli ? Signalez-le-nous.