Aller au contenu principal

Guide d’installation

5 min · Intermédiaire

Installer BackToMe sur PrestaShop.

Suivez le chemin propre à PrestaShop, collez votre tag puis contrôlez sa détection. Collez le tag dans le fichier head.tpl de votre thème, ou via un module d’injection de code.

Installation

Avant de copier le tag.

Vérifiez les accès nécessaires, puis utilisez l’emplacement indiqué pour votre plateforme.

Prérequis

  • Une boutique PrestaShop 1.7, 8.x ou 9.x (les versions 1.6 et antérieures fonctionnent mais ne sont plus maintenues et ont une autre structure de fichiers)
  • Un accès administrateur à votre back-office (profil SuperAdmin)
  • Un accès aux fichiers du thème (FTP, SFTP ou gestionnaire de fichiers de votre hébergeur), ou la possibilité d’installer un module

Emplacement dans PrestaShop

Méthode fiable : coller le tag dans head.tpl du thème, juste avant </head>. Alternative sans fichier : un module d’injection de code.

  1. 01Par fichier (fiable, toutes versions) : connectez-vous aux fichiers de votre thème en FTP, SFTP ou via le gestionnaire de fichiers de votre hébergeur
  2. 02Ouvrez themes/[votre-thème]/templates/_partials/head.tpl (thème par défaut : themes/classic/). Vérifiez bien head.tpl, qui contient le <head>, à ne pas confondre avec header.tpl (l’en-tête visible : logo, menu, panier)
  3. 03Collez le tag BackToMe juste avant la balise </head>, puis enregistrez le fichier
  4. 04Videz le cache : back-office, Paramètres avancés > Performances > Vider le cache
  5. 05Alternative sans toucher aux fichiers : installez un module d’injection de code (type « Custom Code »), collez la ligne dans son champ d’en-tête (head), puis enregistrez. Vérifiez d’abord sa compatibilité : les modules gratuits ne suivent pas toujours PrestaShop 8 et 9

Copiez votre tag BackToMe

Remplacez VOTRE_ID par l’identifiant de la boutique affiché dans votre compte.

Enregistrez et publiez

La modification doit être publiée sur la version réellement visible par vos clients.

Tag à copier dans la balise <head>

<script async src="https://backtome.fr/widget.js" data-site="VOTRE_ID"></script>

Dans la durée

Ce qui retire le bouton d’une boutique PrestaShop

Une mise à jour ou un changement de thème peut retirer un script qui fonctionnait jusque-là.

  • Une mise à jour du thème, qui réécrit head.tpl et efface la modification.
  • Le cache non vidé après un changement : l’ancien rendu continue d’être servi.
  • Une surcharge de thème qui reprend la main sur le fichier que vous avez modifié.

BackToMe surveille le dernier signal reçu

Le tableau de bord indique la dernière détection du tag. Si le bouton disparaît, vous disposez d’un point de départ précis pour contrôler la boutique.

Vérification

Contrôlez la boutique publiée.

Ne vous arrêtez pas au message de l’éditeur. Ouvrez le site public et vérifiez ce qui est réellement chargé.

Résultat attendu

Le statut passe à Détecté dans BackToMe et le bouton apparaît sur la boutique publique.

  1. 01Ouvrez une fenêtre privée.
  2. 02Chargez une page publique de la boutique.
  3. 03Vérifiez la position et le libellé du bouton.
  4. 04Ouvrez le formulaire sans envoyer de demande réelle.

Après le clic

Chaque demande rejoint un dossier vérifiable.

BackToMe enregistre la demande, envoie l’accusé de réception et conserve les éléments nécessaires au suivi. Le certificat indique précisément ce qui peut être contrôlé.

Comprendre le certificat

Dépannage

Les blocages les plus courants.

Les réponses restent fermables et utilisables au clavier.
head.tpl et header.tpl : ne les confondez pas
La balise </head> se trouve dans themes/[votre-thème]/templates/_partials/head.tpl. Le fichier header.tpl, lui, contient l’en-tête visible de la page (logo, menu, panier) : y coller le tag ne l’injecterait pas dans le <head>. Éditez bien head.tpl.
Videz le cache après chaque modification
PrestaShop met agressivement en cache les templates compilés (.tpl). Sans vider le cache, votre tag n’apparaît pas même si le fichier est correct. Le bouton « Vider le cache » est dans Paramètres avancés > Performances, en haut à droite.
Thème par défaut : attention aux mises à jour
Modifier directement head.tpl du thème Classic fonctionne, mais votre ligne peut être écrasée lors d’une mise à jour du thème. Pour une boutique en production, préférez un thème enfant ou la méthode par module, qui survivent aux mises à jour.
Une CSP trop stricte bloque le bouton
Si un module de sécurité impose un Content-Security-Policy, autorisez https://backtome.fr dans script-src et les requêtes vers le sous-domaine api dans connect-src, sinon le navigateur bloque le chargement du script.
Le bouton n’apparaît pas après la publication
Ouvrez la boutique PrestaShop en navigation privée. Vérifiez ensuite le thème publié, l’identifiant du tag et son emplacement dans le head.
Le statut reste sur Non détecté
Le tag se signale lorsqu’une page publique le charge. Visitez la boutique publiée dans une fenêtre privée, puis actualisez le statut dans BackToMe.
Le formulaire ne s’ouvre pas
Testez sans extension de navigateur. Vérifiez aussi la politique CSP et les outils qui bloquent les scripts tiers.
Puis-je transmettre l’installation à mon développeur ?
Oui. Envoyez-lui le tag et ce guide. Il n’a pas besoin d’accéder à votre compte pour ajouter la ligne au site.

Toujours bloqué ? Contactez-nous avec l’URL de la boutique et une capture d’écran.

Un module d’injection, et PrestaShop est en règle.