# Barra annunci & Conto alla rovescia (dfannouncebar)

> Panoramica Il modulo dfannouncebar aggiunge una barra annunci intelligente al tuo negozio PrestaShop 8 o 9: più messaggi in rotazione nella stessa barra, un countdown live, targeting per lingua, paese…

- Pagina: <https://www.datafirefly.com/it/documentation/dfannouncebar/>
- Lingua: it
- Aggiornato il: 2026-07-16
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfannouncebar/index.md), [en](https://www.datafirefly.com/en/documentation/dfannouncebar/index.md), [es](https://www.datafirefly.com/es/documentation/dfannouncebar/index.md), [de](https://www.datafirefly.com/de/documentation/dfannouncebar/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfannouncebar/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfannouncebar/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfannouncebar/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Panoramica

Il modulo **dfannouncebar** aggiunge una barra annunci intelligente al tuo negozio PrestaShop 8 o 9: più messaggi in rotazione nella stessa barra, un countdown live, targeting per lingua, paese e gruppo clienti, programmazione per date e un pulsante di chiusura memorizzato tramite cookie. Sono disponibili tre posizioni: in alto nella pagina, in alto fissa (sticky) e in basso fissa.

## Installazione

1. Nel back office, apri **Moduli → Gestore dei moduli → Carica un modulo**.
2. Carica il file `dfannouncebar.zip` e clicca su **Installa**.
3. Clicca su **Configura** per aprire la pagina del modulo.

All'installazione, il modulo crea una **barra di esempio inattiva** con un messaggio multilingua (codice HELLO10 e countdown a 7 giorni): attivala per vedere subito il risultato, poi adattala o eliminala.

Nessuna dipendenza: niente Composer, niente jQuery. I file JS e CSS del modulo vengono caricati nel front end solo se almeno una barra è attiva.

## Configurazione generale

La pagina di configurazione contiene un'impostazione globale: l'**hook di visualizzazione** della posizione «in alto nella pagina».

- **displayBanner** (predefinito): posizione standard sopra l'header nel tema Classic.
- **displayTop**: alternativa se il tuo tema non dichiara displayBanner.

Una protezione interna impedisce qualsiasi doppia visualizzazione se il tuo tema esegue entrambi gli hook. Le posizioni fisse (in alto fissa e in basso fissa) non dipendono da questa impostazione.

## Creare una barra

Dalla pagina di configurazione, clicca su **Gestisci le barre**. Ogni barra ha:

- **Posizione**: in alto nella pagina, in alto fissa (segue lo scorrimento) o in basso fissa. Il modulo compensa automaticamente il padding della pagina per le posizioni fisse.
- **Priorità**: se più barre puntano alla stessa posizione, viene mostrata solo quella con il valore di priorità più basso.
- **Colori**: sfondo e testo, applicati tramite variabili CSS.
- **Rotazione**: intervallo in secondi tra due messaggi. La rotazione si mette in pausa al passaggio del mouse.
- **Chiusura**: pulsante di chiusura opzionale; la durata del cookie (in ore) definisce quando la barra riappare.
- **Programmazione**: data di inizio e di fine in formato AAAA-MM-GG, completate automaticamente a 00:00:00 e 23:59:59.
- **Negozio**: in multinegozio, una barra può essere globale o limitata a un negozio.

## Messaggi e countdown

Dalla lista delle barre, l'azione **Messaggi** apre i messaggi della barra. Ogni messaggio è **multilingua** e comprende:

- **Testo**: il contenuto mostrato. Inserisci il segnaposto `{countdown}` nel punto in cui deve apparire il timer.
- **Scadenza**: l'obiettivo del countdown, mostrato nel formato `Xd HH:MM:SS` e aggiornato ogni secondo (l'etichetta dei giorni è traducibile).
- **Nascondi alla scadenza**: il messaggio sparisce automaticamente alla scadenza, nel browser e sul server (non viene mai servito HTML morto).
- **Pulsante di azione**: etichetta e URL opzionali, mostrato in stile pill.
- **Ordine**: la posizione del messaggio nella rotazione.

Esempio: «Saldi estivi: -20 % con il codice HELLO10 — termina tra {countdown}». Se tutti i messaggi di una barra scadono, la barra si ritira da sola.

## Targeting

Ogni barra può essere limitata per:

- **Lingue**: la barra appare solo per le lingue selezionate.
- **Paesi**: basato sul paese del contesto PrestaShop; la precisione migliora se la geolocalizzazione IP è attivata in **Internazionale → Localizzazione**.
- **Gruppi clienti**: visitatori, ospiti, clienti o qualsiasi gruppo personalizzato (VIP, B2B…).

Un campo vuoto significa «tutti». I tre criteri si combinano.

## Risoluzione dei problemi

- **La barra non appare in cima alla pagina**: probabilmente il tuo tema non dichiara displayBanner; imposta l'hook di visualizzazione su displayTop nella configurazione.
- **La barra non appare affatto**: verifica che sia attiva, che la programmazione copra la data odierna, che il targeting corrisponda al tuo profilo di test e che nessuna barra con priorità inferiore occupi la stessa posizione. Pensa anche al cookie di chiusura: apri una finestra di navigazione privata.
- **Il countdown non appare**: assicurati che il messaggio contenga `{countdown}` e che sia impostata una scadenza futura.
- **Appaiono due barre in alto**: l'hook di visualizzazione potrebbe essere stato cambiato mentre una cache di pagina serviva la vecchia versione; svuota la cache di PrestaShop.