WP Mautic

Description

Le plugin WordPress Mautic injecte l’image de suivi et les formulaires dans votre site WordPress. Votre instance Mautic sera capable de suivre vos visiteurs. Vous pouvez aussi insérer du contenu Mautic dans votre site en utilisant différents codes courts.

Fonctionnalités principales

  • Vous n‘avez pas besoin de modifier le code source de vos template pour insérer le code de suivi.
  • L’extension ajoute des informations complémentaires à l’URL de l’image de suivi pour vous permettre d’avoir des résultats plus précis qu’avec uniquement l’image (referer par exemple).
  • Vous pouvez utiliser les formulaires Mautic embarqués avec le code court ci-dessous.
  • Vous pouvez choisir où le script est injecté (en-tête / pied de page).
  • L’image de suivi peut être utilisée comme solution de repli lorsque JavaScript est désactivé.

Configuration

Une fois installé, l’extension devrait apparaitre dans votre liste d’extension :

  1. Activez-la.
  2. Allez dans la page de réglages pour définir l’URL de votre instance Mautic.

Et c’est tout !

Utilisation

Code de suivi Mautic

Le script de suivi est intégré dès que vous avez terminé les dernières étapes de configuration. Ca signifie qu’il va insérer le script mtc.js provenant de votre instance Mautic. Vous pouvez vérifier le code HTML (CTRL + U) de votre site WordPress pour être sur que l’extension fonctionne. Vous devriez trouver quelque chose comme :

<script>
    (function(w,d,t,u,n,a,m){w['MauticTrackingObject']=n;
        w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)},a=d.createElement(t),
        m=d.getElementsByTagName(t)[0];a.async=1;a.src=u;m.parentNode.insertBefore(a,m)
    })(window,document,'script','http://yourmauticsite.com/mtc.js','mt');

    mt('send', 'pageview');
</script>

Manipulation des attributs personnalisés

Si vous avez besoin d’envoyer des attributs personnalisés dans les évènements Mautic, vous pouvez utiliser le filtre wpmautic_tracking_attributes.

add_filter('wpmautic_tracking_attributes', function($attrs) {
    $attrs['preferred_locale'] = $customVar;
    return $attrs;
});

Les attributs retournés seront ajoutés au données envoyées à Mautic.

Formulaires Mautic

Pour charger un formulaire Mautic dans votre contenu, insérez ce code court à l’endroit où vous voulez qu’il apparaisse :

[mautic type="form" id="1"]

Remplacez « 1 » avec l’identifiant du formulaire que vous souhaitez charger. Pour trouver l’identifiant, connectez vous sur Mautic, ouvrez le détail du formulaire et regarder l’URL, l’identifiant se trouve à cet endroit. Par exemple, l’identifiant est 3 dans l’URL : http://yourmautic.com/s/forms/view/3.

Focus Mautic

Pour charger un « focus » Mautic dans votre contenu, insérez ce code court à l’endroit où vous voulez qu’il apparaisse :

[mautic type="focus" id="1"]

Remplacez « 1 » avec l’identifiant du « focus » que vous souhaitez charger. Pour trouver l’identifiant, connectez vous sur Mautic, ouvrez le détail du « focus » et regarder l’URL, l’identifiant se trouve à cet endroit. Par exemple, l’identifiant est 3 dans l’URL : http://yourmautic.com/s/focus/3.js.

Contenu dynamique Mautic

Pour charger un bloc de contenu dynamique dans votre contenu, insérez le code court à l’endroit où vous voulez qu’il apparaisse :

[mautic type="content" slot="slot_name"]Default content to display in case of error or unknown contact.[/mautic]

Remplacez le « slot_name » avec le nom du « slot » que vous souhaitez charger. Ce nom correspond à ce que vous avez définit en construisant votre campagne, au moment d’ajouter le bloc « Request Dynamic Content ».

Suivi de vidéo Mautic

Mautic peut créer des vidéos dynamique avec une source YouTube, Vimeo ou un fichier MP4.

Pour charger des vidéos dynamique dans votre contenu, insérez ce code court à l‘endroit où vous voulez qu’elle apparaisse :

[mautic type="video" gate-time="#" form-id="#" src="URL"]
[mautic type="video" src="URL"]

Remplacez le caractère # avec l’identifiant approprié. Pour le « gate-time », entez le temps (en secondes) à partir duquel vous souhaitez que la vidéo soit mise en pause et que le formulaire Mautic soit affiché. Pour le « form-id », utilisez l’identifiant du formulaire Mautic que vous souhaitez afficher. Remplacer « URL » avec l’url permettant de visualiser la vidéo. Dans le cas de Youtube ou Vimeo, vous pouvez simplement utiliser l’URL qui apparait dans votre barre d’adresse lorsque vous visualiser la vidéo sur leur site. Pour les vidéos MP4, entrez l’URL HTTP complète vers le fichier MP4 sur le serveur.

De la sortie de Mautic v2.9.1, le champ form-id n’est plus obligatoire, les vidéos mautic peuvent être suivies.

Étiquettes Mautic

Vous pouvez ajouter ou supprimer des étiquettes de contact sur certaines pages en utilisant des virgules. Pour supprimer une étiquette elle doit être préfixée d’un signe moins « – » :

[mautic type="tags" values="mytag,anothertag,-removetag"]

Installation

Depuis l’interface d’administration WordPress

Mautic – Extension WordPress est listé sur le dépôt d’extension officiel. Ce dépôt permet d’installer l’extension directement depuis l’interface d’administration de WordPress.

  1. Allez dans Extensions / Ajouter.
  2. Cherchez WP Mautic dans le champ de recherche.
  3. L’extension « WP Mautic » devrait apparaitre. Cliquez pour l’installer.

À partir de l’archive ZIP

Si l’installation depuis le dépôt d’extension officiel ne fonctionne pas pour vous, suivez ces étapes :

  1. Télécharger l’archive ZIP.
  2. Dans votre interface d’administration WordPress aller dans Extensions / Ajouter / Mettre une extension en ligne.
  3. Sélectionnez le ZIP que vous avez téléchargé à l’étape 1.

Avis

2 juillet 2017
Works perfectly thank you! Saved me a lot of time from using the manual way of copying the code across from Mautic to WordPress. Now if I update my form in Mautic, its automatically updated in my WordPress.
3 septembre 2016
A must have to interface WordPress and mautic. Works like a charm, gret work !
Lire les 7 avis

Contributeurs & développeurs

« WP Mautic » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.

Contributeurs

“WP Mautic” a été traduit dans 1 locale. Remerciez l’équipe de traduction pour ses contributions.

Traduisez « WP Mautic » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.

Journal

v2.2.2

Date de sortie : 13/11/2017

  • Mis à jour
    • Nous sommes maintenant compatible avec PHP7.2 et WordPress 4.9.

v2.2.1

Date de sortie : 24/08/2017

  • Mis à jour
    • Correction d’une erreur d’encodage lors de l’utilisation d’HTML dans le code court de contenu dynamique Mautic. Auparavant, le code HTML était échappé…
    • Suppression de la documentation et des commentaires dans le code de la syntaxe obsolète des codes courts. Ils sont toujours pris en charge et ne sont pas déclarés obsolètes pour le moment.

v2.2.0

Date de sortie : 07/08/2017

  • Mis à jour
    • Ajout de la compatibilité avec les nouvelles fonctionnalités vidéo de Mautic 2.9.1. Vous pouvez maintenant suivre les vidéos même si elles ne sont pas liées à un identifiant de formulaire (https://github.com/mautic/mautic/pull/4438).

v2.1.1

Date de sortie : 19/07/2017

  • Mis à jour
    • Modification de plusieurs libellés qui n’étaient pas très clair.

v2.1.0

Date de sortie : 19/07/2017

  • Ajouté

    • Application des traductions sur tous les libellés, l’extension est prête à être traduite !
    • Ajout d’une fonction wpmautic_get_tracking_attributes qui définit les attributs envoyés par le JavaScript et les images de suivi.
    • Ajout d’un filtre wpmautic_tracking_attributes pour permettre aux développeurs d’injecter des attributs personnalisés dans les informations de suivi.
    • Ajout de la capacité à suivre les utilisateurs connectés (à travers une option)
  • Mis à jour

    • Ajout d’un domaine de traduction valide et démarrage du processus de traduction officiel.

v2.0.4

Date de sortie : 03/06/2017

  • Mis à jour
    • Version corrective, l’attribut async sur le script du générateur de formulaire bloque document.write.

v2.0.3

Date de sortie : 02/06/2017

  • Mis à jour
    • Version corrective, le groupe d’option n’était pas valide.

v2.0.2

Date de sortie : 02/06/2017

  • Ajouté

    • Ajout d’une suite de test solide pour vérifier toutes les parties du plugin (réglages, chargement, injection du script)
    • Ajout d‘un nouveau réglage pour activer l’image de suivi comme une solution de repli lorsque le javascript est désactivé
  • Mis à jour

    • Mise à jour de la gestion des codes courts et création d’un fichier « shortcodes.php » pour séparer la logique.
    • Nettoyage du « vieux » code dans le répertoire (wpmautic_wp_title).

v2.0.1

Date de sortie : 25/05/2017

  • Ajouté
    • Ajout d’une nouvelle option dans l’écran de réglages pour choisir à quel endroit le script est injecté.
    • Ajout de nouveaux tests sur l’injection du script.

v2.0.0

Date de sortie : 25/05/2017

  • Ajouté

    • Déclaration des dépendances de développement avec Composer (squizlabs/php_codesniffer).
    • Configuration du sniffeur de code : phpcs.xml.
    • Restructuration du code grâce aux sniffs.
    • Ajout de tests unitaire basique avec PHPUnit.
    • Activation de l’intégration continue avec Travis-CI (vérifiez le fichier .travis.yml).
  • Mis à jour

    • Utilisation des fonctions d’échappement pour afficher les données : esc_url.

v1.1.0

Date de sortie : 25/05/2017

  • Ajouté

    • Ajourt du support pour les vidéos embarquées.
    • Utilise le tracker JavaScript à la place de l’image Gif.
  • Mis à jour

    • Première version sortie sur Github, nous démarrons le changelog à partir de ce point…

v1.0.1

Date de sortie : 13/11/2017

v1.0.0

Date de sortie : 02/06/2017

  • Mis à jour
    • Première version sortie sur WordPress.org.