# Centro Notifiche — Guida completa

> Panoramica Il modulo Centro Notifiche (dfnotificationcenter) aggiunge una campanella di notifiche nell'header del tuo negozio, proprio accanto al carrello e al link «Il mio account». Un badge rosso segnala le…

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

## Panoramica

Il modulo **Centro Notifiche** (`dfnotificationcenter`) aggiunge una **campanella di notifiche** nell'header del tuo negozio, proprio accanto al carrello e al link «Il mio account». Un **badge rosso** segnala le notifiche non lette. I tuoi **nuovi prodotti** compaiono lì automaticamente e puoi inviare i tuoi **codici promozionali**, che il cliente copia con un clic. Il tutto è multilingua, multinegozio e compatibile con PrestaShop 8 e 9.

La campanella riprende un riflesso che i tuoi visitatori hanno già sui social network: un pallino rosso cattura l'attenzione e invita al clic, senza pop-up invadenti né banner che ostacolano la navigazione.

## Compatibilità

- PrestaShop da 8.0 a 9.x
- Negozio singolo e multinegozio
- PHP da 7.2 a 8.x
- Tema Classic e temi personalizzati
- Interfaccia fornita in francese, inglese, spagnolo, tedesco e italiano
- Nessuna dipendenza (né Composer né framework)

## Installazione

1. Nel back-office, apri **Moduli > Gestore dei moduli**.
2. Clicca su **Carica un modulo** e seleziona il file `dfnotificationcenter.zip`.
3. Una volta installato, clicca su **Configura**.

All'installazione, il modulo crea le sue tre tabelle (notifiche, traduzioni, stato di lettura), registra i suoi hook (campanella nell'header, risorse front, salvataggio prodotto, creazione di regola del carrello) e aggiunge la scheda back-office **Notification Center** per gestire le notifiche.

## Impostazioni globali

Dalla pagina **Configura** del modulo definisci il comportamento generale:

- **Nuovi prodotti automatici**: crea una notifica a ogni salvataggio di un prodotto.
- **Solo prodotti attivi**: genera la notifica solo per i prodotti attivi e visibili.
- **Promo automatica su regola del carrello**: crea automaticamente una notifica promo non appena viene creata una regola del carrello con codice.
- **Durata delle notifiche prodotto (giorni)**: scadenza automatica dopo N giorni. `0` = mai.
- **Intervallo di aggiornamento (secondi)**: aggiornamento del badge in background. `0` = disattivato.
- **Numero massimo di elementi nel pannello**: numero di notifiche mostrate nella campanella.
- **Colore del badge** e **Colore della campanella** (vuoto = colore del tema).
- **Suono** e **Animazione** della campanella all'arrivo di una nuova notifica.

## Gestire le notifiche

La scheda **Notification Center** (accessibile anche tramite il pulsante «Apri il Notification Center» nella pagina di configurazione) elenca le tue notifiche con tipo, priorità, numero di visualizzazioni e clic e stato attivo. Clicca su **Aggiungi una notifica** per crearne una.

### Campi di una notifica

- **Tipo**: Nuovo prodotto, Codice promo, News o Informazione. Ogni tipo ha la sua icona e il suo colore lato cliente.
- **Titolo** (multilingua, obbligatorio) e **Messaggio** (multilingua, editor di testo).
- **Etichetta del pulsante** (multilingua) e **Link** (URL di destinazione).
- **ID prodotto**: per il tipo Nuovo prodotto. L'immagine e il link vengono allora risolti automaticamente.
- **Codice promo**: per il tipo Codice promo. Mostrato lato cliente con un pulsante **Copia**.
- **Immagine**: visual opzionale (ignorato per il tipo prodotto, che usa l'immagine di copertina).
- **Gruppo target**: «Tutti i clienti» o un gruppo specifico.
- **Priorità**: più alto è il valore, più in alto appare la notifica.
- **Data di inizio** e **Data di fine**: lasciale vuote per «visibile subito» e «non scade mai».
- **Attivo**: interruttore di attivazione.

Pianificazione e targeting si combinano: puoi, ad esempio, pianificare una notifica promo visibile solo al gruppo «Clienti fedeli», dal 1° al 15 del mese, con una priorità alta affinché appaia in cima.

## Nuovi prodotti automatici

Quando l'opzione è attiva, il modulo è in ascolto sul salvataggio dei prodotti (hook `actionProductSave`) e crea una notifica di tipo prodotto con il nome, l'immagine di copertina e il link della scheda. Lo stesso prodotto viene notificato una sola volta (deduplicazione per identificativo prodotto).

L'immagine e il link di una notifica prodotto vengono **ricalcolati alla visualizzazione**. Anche se modifichi il prodotto o cambi la sua foto in seguito, la notifica resta corretta. Se il prodotto diventa inattivo o viene eliminato, la notifica semplicemente smette di apparire.

## Codici promozionali

Crea una notifica di tipo **Codice promo**, inserisci il codice della tua regola del carrello e appare lato cliente in un chip con un pulsante **Copia**. Un clic, il codice è negli appunti, il cliente torna al carrello per applicarlo.

Se l'opzione **Promo automatica su regola del carrello** è attiva, una notifica promo viene creata automaticamente a ogni creazione di una regola del carrello con codice (hook `actionObjectCartRuleAddAfter`), riprendendone la data di fine validità.

## Lato cliente

La campanella appare nell'header tramite l'hook `displayNav2`, accanto al carrello e a «Il mio account». Un badge rosso indica il numero di notifiche non lette (oltre nove, mostra `9+`). Al clic, un pannello a tendina elenca le notifiche, le più prioritarie e recenti per prime.

- **Segna come letto**: un pulsante «Segna tutto come letto» e lettura automatica al clic su una notifica.
- **Pulsante Copia** sui codici promozionali.
- **Marca temporale relativa** («2 h fa», «ieri»…).
- **Responsive**: il pannello appare in basso nello schermo (bottom-sheet) su mobile.
- **Accessibilità**: attributi ARIA e chiusura da tastiera (tasto Esc).

### Stato letto / non letto

Per i **clienti che hanno effettuato l'accesso**, lo stato letto / non letto è salvato lato server e quindi condiviso tra i loro dispositivi. Per gli **ospiti**, viene memorizzato nel browser tramite `localStorage`.

## Statistiche (KPI)

Ogni notifica accumula un contatore di **visualizzazioni** e **clic**, visibili nell'elenco del back-office. Individui così a colpo d'occhio quali notifiche generano più interazione.

## Compatibilità con PrestaShop 9

Il modulo è progettato e testato da PrestaShop 8.0 a 9.x:

- il controller back-office usa `ModuleAdminController`, compatibile con 8 e 9;
- i controller evitano i metodi rimossi in PrestaShop 9;
- il controller AJAX del front restituisce JSON direttamente tramite metodi `ajaxProcess`, senza override di firma incompatibile;
- nessun override del core di PrestaShop.

## FAQ e risoluzione dei problemi

### La campanella non appare nell'header

La campanella è agganciata all'hook `displayNav2` del tema Classic, dove si trovano il carrello e l'account cliente. Su un tema personalizzato che non espone questa posizione, aggancia il modulo all'hook usato dal tuo header da **Moduli > Gestore dei moduli**, oppure contattaci.

### I nuovi prodotti non appaiono

Verifica che l'opzione **Nuovi prodotti automatici** sia attiva. Se **Solo prodotti attivi** è selezionato, il prodotto deve essere attivo e visibile. Un prodotto già notificato non viene notificato una seconda volta.

### Il badge non si aggiorna per un visitatore

Per gli ospiti, lo stato di lettura è conservato nel browser. Svuotare la cache o i dati del sito reimposta tale stato. Per un monitoraggio condiviso tra dispositivi, il cliente deve effettuare l'accesso.

### Il pulsante Copia non funziona

La copia usa l'API degli appunti del browser, disponibile in HTTPS. Assicurati che il tuo negozio sia servito in HTTPS; è prevista una copia di riserva, ma l'HTTPS garantisce il funzionamento migliore.

### Come tradurre le notifiche?

Titolo, messaggio ed etichetta del pulsante sono campi multilingua: seleziona ogni lingua nel modulo della notifica. Le etichette dell'interfaccia si traducono tramite **Parametri avanzati > Traduzioni > Traduzioni dei moduli installati**, scegliendo `dfnotificationcenter`.

### È compatibile con PrestaShop 9?

Sì. Il modulo è progettato e testato da PrestaShop 8.0 a 9.x, sia in negozio singolo sia in multinegozio.

## Disinstallazione

La disinstallazione rimuove la scheda back-office, le impostazioni e le tre tabelle del modulo (notifiche, traduzioni, stato di lettura). Per conservare le tue notifiche, disattiva il modulo senza disinstallarlo.
