Intégration Olark Chat : installation et aide

Vous devez disposer d'un compte existant auprès du service et de son ID du site. Configurez les conversations et le widget visible dans le compte du service.

L'action "Configure" du module ouvre Configuration Olark. Son contrôleur de configuration affiche aussi un avis de configuration requise et une bannière d'intégrité. Utilisez les pages Paramètres, "Integrity", Licence, Assistance et Mettre à jour du module pour les opérations de maintenance correspondantes.

Trouver la valeur de connexion

Copiez l'identifiant ID du site depuis votre code d'installation Olark. Le module vous renvoie vers "Settings" > "Installation". Collez uniquement l'identifiant. Ne collez pas une URL ou un script complet.

La valeur par défaut est vide. Pour les identifiants nouveaux ou modifiés, le module attend quatre chiffres, trois chiffres, deux chiffres et quatre chiffres, séparés par des traits d'union. Un identifiant rejeté laisse la configuration précédemment enregistrée intacte. Corrigez la valeur et enregistrez à nouveau.

Renseignez ces champs dans Configuration Olark, puis cliquez sur Enregistrer.

Groupes de pages

Le ciblage utilise les noms des contrôleurs. Un contrôleur de commande personnalisé absent de cette liste n'est pas inclus par Pages de commande uniquement. Aucun champ ne permet de définir des règles d'URL personnalisées. Afficher sur mobile utilise la détection mobile de PrestaShop, et pas uniquement la largeur du navigateur.

Champs client

Le module se connecte à votre ID de site Olark configuré. Pour un client connecté, il transmet son adresse e-mail et son nom complet à Olark.

Pour les visiteurs non connectés, ce module ne transmet aucune donnée d'identité client PrestaShop à Olark. Le service peut toujours recueillir des informations via son propre widget. Ce module ne synchronise ni l'historique des commandes ni le contenu du panier.

Exemple de configuration

Pour les pages de commande sur ordinateur, choisissez Pages de commande uniquement, réglez Afficher sur mobile sur Non et "Fallback Delay (seconds)" sur 2. Le chargeur démarre à la première interaction ou après deux secondes sans interaction.

Le module enregistre displayBeforeBodyClosingTag. Il vérifie d'abord l'activation, la valeur de connexion, la règle d'appareil et la règle de page. Il insère ensuite un chargeur différé vers la fin de la page.

Faites défiler, cliquez, touchez la page ou appuyez sur une touche pour déclencher le chargeur. Sans interaction, attendez le délai de secours configuré. Le chargeur partagé supprime le délai interne du template, les deux délais ne s'additionnent donc pas. Avec la valeur par défaut d'installation 0, attendez 10 secondes avant de considérer qu'une page sans interaction présente un échec de chargement.

Dans les outils de développement du navigateur, recherchez une requête correspondant à :

//static.olark.com/jsclient/loader.js

Ouvrez le widget et envoyez un message de test. Vérifiez qu'il arrive dans la boîte de réception du service. Testez avec un compte connecté si vous avez activé Transmettre les données client, et vérifiez les champs d'identité reçus par le service. Enfin, testez les pages et appareils mobiles exclus.

Gérez l'apparence du widget, les messages d'accueil, le comportement hors ligne, les opérateurs et l'automatisation dans Olark. Le module ne propose aucun champ pour le contenu ou la valeur du panier, les adresses, les numéros de téléphone, l'historique des commandes ou des champs client personnalisés.

• Si aucun chargeur n'est généré, vérifiez Activer Olark Chat, ID du site, Afficher sur les pages et Afficher sur mobile.
• Si la page reste sans interaction, attendez le délai de secours ou interagissez avec elle. "Fallback Delay (seconds)" à 0 ne signifie pas un chargement immédiat.
• Si l'enregistrement échoue, gardez l'identifiant renseigné, vérifiez son format, rechargez la page de configuration et réessayez. N'utilisez pas d'identifiants fictifs pour un test réel.
• Si la requête externe échoue, vérifiez les erreurs de la console du navigateur, le blocage des scripts, la Content Security Policy et les outils de consentement de votre boutique.
• Si le script se charge mais que le bouton d'ouverture est absent, vérifiez la publication du widget côté service, la disponibilité du compte et les règles d'affichage.
• Si un champ client manque, connectez-vous et confirmez que Transmettre les données client est sur Oui. Comparez avec les champs précis énumérés ci-dessus.
• Si une autre intégration insère aussi le script du service, recherchez dans la page générée un code d'installation en double ou conflictuel.

Vérifier un thème personnalisé

Votre thème doit exécuter le hook de fermeture du corps de page. Un développeur peut rétablir cet appel avant </body> s'il manque dans le thème :

{hook h='displayBeforeBodyClosingTag'}

Pour modifier le template du thème, copiez :

modules/mprolark/views/templates/hook/displayBeforeBodyClosingTag.tpl

vers :

themes/your-theme/modules/mprolark/views/templates/hook/displayBeforeBodyClosingTag.tpl

Conservez les variables Smarty du module et l'échappement de l'identifiant. L'enveloppe d'interaction partagée s'applique toujours à ce template de hook.

Le formulaire utilise le préfixe MPROLARK_ pour les noms des champs envoyés. Le stockage actuel utilise le module mprolark dans la table partagée mpr_config, avec des clés courtes :

ENABLED
SITE_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

La table de base de données utilise le préfixe des tables de votre boutique ; ps_mpr_config est donc seulement un exemple de nom. Utilisez le formulaire de configuration pour les modifications courantes. Ne considérez pas les noms des champs du formulaire comme les clés actuelles de la base de données.

Réglez Activer Olark Chat sur Non et enregistrez en laissant l'identifiant renseigné pour suspendre l'affichage de ce module. Vous pouvez aussi désactiver le module dans "Module Manager".

Pour le supprimer, utilisez "Uninstall" dans "Module Manager", puis confirmez. La désinstallation supprime sa configuration et ses entrées de menu d'administration. Elle ne ferme pas le compte du service externe et ne supprime pas le code inséré par un autre module ou thème.