Installer sur WordPress

WordPress propose deux emplacements pour du code compatibles avec les enquêtes Voxtrics : le Footer global de l’extension WPCode pour un pop-up, un pop-up sans bouton ou une enquête chat sur toutes les pages, et le bloc Custom HTML pour un formulaire intégré placé sur une page. Les deux fonctionnent sur un site WordPress que vous hébergez vous-même et sur WordPress.com avec n’importe quel forfait payant.

Avec le forfait Free de WordPress.com, vous ne pouvez ni installer d’extensions ni ajouter de scripts : une enquête ne peut donc pas être placée sur la page. Ajoutez plutôt un bouton qui renvoie vers une enquête sur site : elle s’ouvre sur sa propre page et ne nécessite aucun code sur votre site.

Avant de commencer

Dans Domaines, ajoutez le domaine sur lequel s’ouvre votre site WordPress, par exemple example.com, ou son adresse WordPress.com comme your-site.wordpress.com. Une enquête ne se charge que sur le domaine auquel elle appartient.
Créez l’enquête sous ce domaine et publiez-la.
Copiez l’ID de l’enquête : dans la liste Enquêtes, ouvrez le code d’intégration de l’enquête. L’ID est la valeur de formId.

Pop-up, pop-up sans bouton ou chat : WPCode

WordPress n’a pas de champ à lui pour du code exécuté sur toutes les pages : le code passe donc par une extension. Ces étapes utilisent WPCode (anciennement Insert Headers and Footers), une extension gratuite conçue pour cela.

Dans votre tableau de bord WordPress, ouvrez Plugins → Add New Plugin, recherchez WPCode, cliquez sur Install Now, puis sur Activate.
Allez dans Code Snippets → Header & Footer.

Dans Footer, collez ceci, en remplaçant YOUR_SURVEY_ID par l’ID de votre enquête :

<script src="https://feedback.voxtrics.io/assets/prod/index.iife.js"></script>
<script>
  window.SiteUtilsFeedback.initiateFeedbackModule({ formId: 'YOUR_SURVEY_ID' });
</script>

Le code du Footer s’exécute à la fin de chaque page, une fois la page elle-même chargée.

Cliquez sur Save Changes.

Le guide de WPCode sur ces champs (en anglais) : Using the Global Header & Footer settings.

Formulaire intégré : le bloc Custom HTML

Ouvrez la page ou l’article dans l’éditeur et cliquez sur + à l’endroit où l’enquête doit apparaître.
Recherchez Custom HTML et ajoutez le bloc.

Collez le code d’intégration de votre enquête, en remplaçant YOUR_SURVEY_ID par l’ID de votre enquête :

<div id="feedback-widget"></div>

<script src="https://feedback.voxtrics.io/assets/prod/index.iife.js"></script>
<script>
  window.SiteUtilsFeedback.initiateFeedbackModule({
    formId: 'YOUR_SURVEY_ID',
    container: document.getElementById('feedback-widget'),
  });
</script>

Enregistrez la page.

Les pages construites avec Elementor acceptent le même code dans son widget HTML, et les pages Divi dans son module Code.

WordPress ne conserve les scripts d’un bloc Custom HTML que pour les Administrateurs et les Éditeurs (sur un réseau multisite, uniquement pour le Super Admin). Si quelqu’un d’autre enregistre le bloc, celui-ci perd ses balises <script> et l’enquête ne se charge pas. Vérifiez l’enquête sur la page publiée, pas dans l’éditeur.

Si l’enquête n’apparaît pas

Vérifiez que l’enquête est publiée et qu’elle appartient au domaine sur lequel s’ouvre votre site. Un domaine ajouté sous la forme example.com couvre aussi www.example.com, mais pas your-site.wordpress.com.
Videz le cache de votre extension de cache ou de votre hébergeur après avoir ajouté le code : une copie de la page en cache ne le contient pas encore.
Les extensions qui retardent, diffèrent ou combinent le JavaScript pour accélérer le site (WP Rocket, LiteSpeed Cache, Autoptimize et autres) peuvent démarrer l’enquête en retard ou l’empêcher de démarrer. Excluez feedback.voxtrics.io et SiteUtilsFeedback de ces réglages.
Le code placé dans le Header de WPCode s’exécute avant le chargement de la page : l’enquête ne démarre donc pas. Déplacez-le dans Footer.
L’enquête ne reste sur le site que tant que WPCode est actif : désactiver l’extension la retire.
Les enquêtes sur site et par e-mail ne se placent pas sur un site. Partagez plutôt leur lien.