PS PrestaShop Principiante

Iniettore di codice Header/Footer (CSS/JS): guida completa

Installare, configurare e usare l'iniezione di codice CSS/JS/HTML: posizioni, targeting per pagina, modalità test, duplicazione e multinegozio per PrestaShop 8 e 9.

Aggiornato Versione del modulo 1.1.0

Panoramica

L’Iniettore di codice Header/Footer aggiunge codice CSS, JavaScript o HTML al tuo negozio PrestaShop senza modificare i file del tema. Ogni blocco di codice è uno snippet gestito dal back-office, con la sua posizione, le sue pagine, il suo ordine di iniezione e il suo stato.

Usi frequenti: Google Tag Manager, Google Analytics, Meta Pixel, tag di verifica (Search Console, Pinterest), CSS personalizzato, widget di chat.

Installazione

  1. Scarica l’archivio dfcodeinjector.zip dal tuo account DataFirefly.
  2. Nel back-office, apri Moduli > Gestore moduli, fai clic su Carica un modulo e rilascia l’archivio.
  3. Fai clic su Configura per aprire l’elenco degli snippet.

Compatibile con PrestaShop da 8.0 a 9.x e con il multinegozio. Interfaccia disponibile in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.

Aggiornamento dalla versione 1.0.0

Carica il nuovo archivio dal gestore moduli: l’aggiornamento si esegue automaticamente e i tuoi snippet vengono conservati. Uno snippet che era limitato a certe pagine passa al targeting Solo le pagine selezionate, gli altri a Tutte le pagine.

Creare uno snippet

Nell’elenco, fai clic su Aggiungi uno snippet.

Campi del modulo

  • Nome: nome interno, ad esempio «Google Tag Manager».
  • Posizione: dove viene iniettato il codice (vedi sotto).
  • Codice: il codice completo, tag inclusi. Viene iniettato così com’è. In questo campo il tasto Tab inserisce 4 spazi; premi Esc e poi Tab per passare al campo successivo.
  • Targeting, Pagine e Altre pagine: le pagine su cui si applica lo snippet.
  • Ordine: ordine di iniezione all’interno di una posizione. Se resta vuoto, lo snippet viene messo per ultimo.
  • Modalità test: limita l’iniezione agli indirizzi IP di manutenzione.
  • Attivo: attiva o disattiva lo snippet senza eliminarlo.
  • Negozio (solo multinegozio): tutti i negozi o uno solo.

Le tre posizioni

  • Header (tag head): stili, tag meta, tag di verifica, script principale di GTM. Hook displayHeader.
  • Inizio del body: subito dopo l’apertura del body, per la parte noscript di GTM. Hook displayAfterBodyOpeningTag.
  • Fine del body: subito prima della chiusura del body, per gli script di tracciamento e di chat. Hook displayBeforeBodyClosingTag.

Se il tuo tema non richiama gli hook di inizio o fine del body, il modulo inserisce il codice direttamente nell’HTML finale della pagina, nello stesso punto (hook actionOutputHTMLBefore). Le tre posizioni funzionano quindi con tutti i temi, senza alcuna impostazione.

Targeting per pagina

Il campo Targeting propone tre modalità: Tutte le pagine, Solo le pagine selezionate oppure Tutte le pagine tranne quelle selezionate.

L’elenco Pagine contiene 30 pagine PrestaShop: home page, categoria, scheda prodotto, CMS, ricerca, carrello, processo d’ordine, conferma d’ordine, accesso, il mio account, storico ordini, contatto, pagina 404 e altre. Il campo Altre pagine accetta altri nomi tecnici di pagina, separati da virgole. Per una pagina di modulo il formato è module-nomemodulo-controller.

Per trovare il nome tecnico di una pagina, guardane il codice sorgente: nel tema Classic e nei suoi derivati è l’attributo id del tag body.

Modalità test

Uno snippet in modalità test viene iniettato solo per gli indirizzi IP inseriti nel campo IP di manutenzione della pagina Manutenzione dei parametri del negozio. Sono accettati intervalli in formato CIDR. Verifichi così un tag sul negozio online senza che alcun visitatore lo riceva, poi disattivi la modalità test per pubblicarlo.

Duplicare uno snippet

Il menu di ogni riga dell’elenco propone Duplica. La copia viene creata disattivata e messa per ultima: rileggila prima di attivarla.

Esempi

Google Tag Manager

GTM richiede due snippet:

  1. «GTM head», posizione Header, con il primo script fornito da 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», posizione Inizio del body, con la parte noscript fornita da Google.

Pixel di conversione

Posizione Fine del body, targeting Solo le pagine selezionate, pagina Conferma d’ordine. Il pixel si attiva solo dopo un acquisto.

CSS personalizzato

Posizione Header, con il CSS dentro un tag style:

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

Tag di verifica

Per Search Console o un social network, posizione Header:

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

Multinegozio

Con il multinegozio attivo, il campo Negozio permette di mostrare uno snippet su tutti i negozi o su uno solo. In un’installazione con un solo negozio il campo è nascosto e lo snippet si applica all’intero negozio.

Risoluzione dei problemi

  • Il codice non appare: verifica che lo snippet sia attivo, che la modalità test sia disattivata (o che il tuo IP sia tra gli IP di manutenzione) e che la pagina corrente rientri nel targeting.
  • È installato un modulo di cache delle pagine: svuotane la cache dopo ogni modifica di uno snippet.
  • Lo snippet non compare su una pagina di modulo: verifica il nome tecnico inserito in Altre pagine, deve corrispondere esattamente a quello della pagina.
  • Due script vengono eseguiti nell’ordine sbagliato: regola il campo Ordine.

Il codice viene iniettato senza alcun filtro. Controllane la sintassi (tag chiusi correttamente) e usa la modalità test prima di attivarlo su un negozio in produzione.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza