PS PrestaShop Débutant

Injecteur de code Header/Footer (CSS/JS) : guide complet

Installer, configurer et utiliser l'injection de code CSS/JS/HTML : emplacements, ciblage par page, mode test, duplication et multiboutique pour PrestaShop 8 et 9.

Mis à jour Version du module 1.1.0

Présentation

L’Injecteur de code Header/Footer ajoute du code CSS, JavaScript ou HTML à votre boutique PrestaShop sans modifier les fichiers du thème. Chaque bloc de code est un snippet géré depuis le back-office, avec son emplacement, ses pages cibles, son ordre d’injection et son statut.

Usages courants : Google Tag Manager, Google Analytics, Meta Pixel, balises de vérification (Search Console, Pinterest), CSS personnalisé, widget de chat.

Installation

  1. Téléchargez l’archive dfcodeinjector.zip depuis votre compte DataFirefly.
  2. Dans le back-office, ouvrez Modules > Gestionnaire de modules, cliquez sur Envoyer un module et déposez l’archive.
  3. Cliquez sur Configurer pour ouvrir la liste des snippets.

Compatible PrestaShop 8.0 à 9.x et multiboutique. Interface disponible en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais.

Mise à jour depuis la version 1.0.0

Envoyez la nouvelle archive par le gestionnaire de modules : la mise à jour s’exécute automatiquement et vos snippets sont conservés. Un snippet qui était limité à certaines pages passe en ciblage Uniquement les pages sélectionnées, les autres en Toutes les pages.

Créer un snippet

Dans la liste, cliquez sur Ajouter un snippet.

Champs du formulaire

  • Nom : nom interne, par exemple « Google Tag Manager ».
  • Emplacement : où le code est injecté (voir ci-dessous).
  • Code : le code complet, balises comprises. Il est injecté tel quel. Dans ce champ, la touche Tab insère 4 espaces ; appuyez sur Échap puis Tab pour passer au champ suivant.
  • Ciblage, Pages et Autres pages : les pages sur lesquelles le snippet s’applique.
  • Ordre : ordre d’injection au sein d’un même emplacement. Laissé vide, le snippet est placé en dernier.
  • Mode test : limite l’injection aux adresses IP de maintenance.
  • Actif : active ou désactive le snippet sans le supprimer.
  • Boutique (multiboutique uniquement) : toutes les boutiques ou une seule.

Les trois emplacements

  • Header (balise head) : styles, balises meta, balises de vérification, script principal de GTM. Hook displayHeader.
  • Début du body : juste après l’ouverture du body, pour la partie noscript de GTM. Hook displayAfterBodyOpeningTag.
  • Fin du body : juste avant la fermeture du body, pour les scripts de suivi et de chat. Hook displayBeforeBodyClosingTag.

Si votre thème n’appelle pas les hooks de début ou de fin de body, le module insère le code directement dans le HTML final de la page, au même endroit (hook actionOutputHTMLBefore). Les trois emplacements fonctionnent donc avec tous les thèmes, sans réglage.

Ciblage des pages

Le champ Ciblage propose trois modes : Toutes les pages, Uniquement les pages sélectionnées, ou Toutes les pages sauf celles sélectionnées.

La liste Pages contient 30 pages PrestaShop : accueil, catégorie, fiche produit, CMS, recherche, panier, tunnel de commande, confirmation de commande, connexion, compte client, historique des commandes, contact, page 404, etc. Le champ Autres pages accepte d’autres noms techniques de pages, séparés par des virgules. Pour une page de module, le format est module-nomdumodule-controleur.

Pour connaître le nom technique d’une page, affichez son code source : dans le thème Classic et ses dérivés, c’est l’attribut id de la balise body.

Mode test

Un snippet en mode test n’est injecté que pour les adresses IP saisies dans Paramètres de la boutique > Paramètres généraux > Maintenance (champ IP de maintenance). Les plages au format CIDR sont acceptées. Vous vérifiez ainsi un tag sur la boutique en ligne sans qu’aucun visiteur ne le reçoive, puis vous désactivez le mode test pour le publier.

Dupliquer un snippet

Le menu de chaque ligne de la liste propose Dupliquer. La copie est créée désactivée et placée en dernier : relisez-la avant de l’activer.

Exemples

Google Tag Manager

GTM se pose en deux snippets :

  1. « GTM head », emplacement Header, avec le premier script fourni par Google :
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){ ... })(window,document,'script','dataLayer','GTM-XXXXXX');</script>
<!-- End Google Tag Manager -->
  1. « GTM body », emplacement Début du body, avec la partie noscript fournie par Google.

Pixel de conversion

Emplacement Fin du body, ciblage Uniquement les pages sélectionnées, page Confirmation de commande. Le pixel ne se déclenche qu’après un achat.

CSS personnalisé

Emplacement Header, CSS entouré d’une balise style :

<style>
.header-banner { background:#0f172a; color:#fff; }
</style>

Balise de vérification

Pour Search Console ou un réseau social, emplacement Header :

<meta name="google-site-verification" content="VOTRE_CODE" />

Multiboutique

En multiboutique, le champ Boutique permet de diffuser un snippet sur toutes les boutiques ou sur une seule. En mono-boutique, ce champ est masqué et le snippet s’applique à toute la boutique.

Dépannage

  • Le code n’apparaît pas : vérifiez que le snippet est actif, que le mode test est désactivé (ou que votre IP figure dans les IP de maintenance) et que la page courante fait partie du ciblage.
  • Un module de cache de pages est installé : videz son cache après chaque modification de snippet.
  • Le snippet ne s’affiche pas sur une page de module : vérifiez le nom technique saisi dans Autres pages, il doit correspondre exactement à celui de la page.
  • Deux scripts s’exécutent dans le mauvais ordre : ajustez le champ Ordre.

Le code est injecté sans aucun filtrage. Vérifiez sa syntaxe (balises bien fermées) et utilisez le mode test avant de l’activer sur une boutique en production.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support