# Popup Pro Newsletter — Guida completa

> Popup Pro Newsletter mostra sul vostro negozio Shopware un popup di iscrizione alla newsletter che premia ogni nuovo iscritto con un codice sconto valido sul primo ordine. L'obiettivo è duplice:…

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

Popup Pro Newsletter mostra sul vostro negozio Shopware un popup di iscrizione alla newsletter che premia ogni nuovo iscritto con un codice sconto valido sul primo ordine. L'obiettivo è duplice: far crescere la vostra lista di distribuzione e generare una prima vendita. Il plugin si basa esclusivamente sul **sistema di promozioni nativo di Shopware** — non viene creata alcuna entità di database personalizzata — e offre due modalità di codice (unico per iscritto o fisso), uno sconto configurabile in percentuale o importo fisso, trigger a tempo e scroll, e l'iscrizione tramite la route ufficiale della newsletter con double opt-in opzionale conforme al GDPR. Questa guida copre installazione, configurazione, funzionamento dei codici sconto, personalizzazione e risoluzione dei problemi. Compatibile con Shopware 6.6 e 6.7.

Dalla 6.6, lo storefront di Shopware non compila più il JavaScript dei plugin al volo. Lo ZIP che installate **deve contenere la cartella dist/ del JS precompilato**. Lo ZIP distribuito da DataFirefly la include già; se ricostruite il plugin da soli, leggete attentamente la sezione Installazione.

## Come funziona il codice sconto

Alla primissima iscrizione di un visitatore, il plugin crea automaticamente una **promozione Shopware** denominata «Popup Newsletter — Welcome», assegnata al canale di vendita corrente, con lo sconto definito nella configurazione. Poi, a ogni iscrizione:

- in modalità **codice unico** (consigliata), un codice individuale viene generato al volo e collegato alla promozione tramite i _codici individuali di promozione_ nativi di Shopware, e restituito al visitatore: non condivisibile, tracciabile e limitabile a un solo utilizzo;
- in modalità **codice fisso**, la promozione porta un unico codice pubblico (tipo `WELCOME10`) mostrato a tutti gli iscritti.

La promozione resta interamente gestibile in **Marketing → Promozioni**: periodo di validità, condizioni, regole avanzate. Per riservare l'offerta al primo ordine, mantenete attiva l'opzione «un utilizzo per cliente»; per un controllo più rigoroso, aggiungete una regola Shopware (es. «numero di ordini del cliente = 0») direttamente sulla promozione.

## Installazione

1. Scaricate l'archivio `DataFireflyPopupProNewsletter-v1.0.0.zip` dal vostro account DataFirefly.
2. Installatelo tramite **Amministrazione → Estensioni → Le mie estensioni → Carica estensione**, oppure copiate la cartella decompressa in `custom/plugins/`.
3. Installate e attivate il plugin: ``` bin/console plugin:refresh bin/console plugin:install --activate DataFireflyPopupProNewsletter bin/console cache:clear ```
4. Compilate il tema per includere gli stili del popup: ``` bin/console theme:compile ```

`theme:compile` è puro PHP: funziona su hosting condiviso. La **compilazione del JavaScript** (`build-storefront.sh`), invece, richiede Node e molta memoria — non è pensata per l'hosting condiviso. Per questo il JS viene fornito precompilato nello ZIP: non dovete mai eseguire la build sul vostro server di produzione.

### Se ricostruite il plugin da soli

Su un'installazione Shopware di sviluppo completa, il JS si compila così:

```
bin/console plugin:refresh
bin/console plugin:install --activate DataFireflyPopupProNewsletter
bash bin/build-storefront.sh
```

Questo genera `src/Resources/app/storefront/dist/storefront/js/data-firefly-popup-pro-newsletter/data-firefly-popup-pro-newsletter.js`. Ricomprimete il plugin **con** questa cartella `dist/` prima di distribuirlo in produzione.

## Configurazione

Aprite **Estensioni → Le mie estensioni → Popup Pro Newsletter → ⋯ → Configura**. Le impostazioni sono organizzate in schede.

### Generale

- **Attiva il popup**: attiva o disattiva completamente la visualizzazione.

### Visualizzazione

- **Mostra dopo un ritardo (secondi)**: il popup appare dopo X secondi. `0` disattiva questo trigger.
- **Mostra dopo scroll (% della pagina)**: il popup appare al raggiungimento di quella percentuale di scroll. `0` disattiva questo trigger.
- **Non mostrare più per (giorni)**: frequenza di visualizzazione per visitatore, memorizzata lato browser.
- **Nascondi per i clienti connessi**: non mostra il popup ai clienti già connessi.

Entrambi i trigger (ritardo e scroll) sono cumulabili: il popup appare non appena viene soddisfatto il _primo_ dei due. Per un trigger solo a scroll, impostate il ritardo a `0`, e viceversa.

### Contenuto

Titolo, sottotitolo, segnaposto del campo email, testo del pulsante, messaggio di successo (usate il segnaposto `%code%` per inserire il codice), messaggio di conferma in sospeso (double opt-in), URL illustrazione opzionale e colore di accento. Tutti questi testi sono modificabili e traducibili.

### Codice sconto

- **Modalità codice**: `unico` (consigliata) o `fisso`.
- **Codice fisso / prefisso**: il codice pubblico in modalità fissa, o il prefisso dei codici individuali in modalità unica.
- **Tipo e valore dello sconto**: percentuale o importo fisso, valore libero.
- **Un utilizzo per cliente**: limita la promozione a un solo utilizzo per riservare l'offerta al primo ordine.
- **Double opt-in**: invia un'email di conferma prima di consegnare il codice.

## Double opt-in e GDPR

L'iscrizione passa dalla route ufficiale della newsletter di Shopware (`NewsletterSubscribeRoute`), il che garantisce la sincronizzazione con i vostri destinatari esistenti. Quando il double opt-in è attivo, il visitatore riceve il codice solo dopo aver confermato il proprio indirizzo via email; nel frattempo viene mostrato nel popup il messaggio di attesa personalizzabile. Non vengono usati cookie di terze parti: la memoria «non mostrare più» è memorizzata lato browser tramite `localStorage`.

Il double opt-in è consigliato per la conformità al GDPR: attesta il consenso esplicito dell'iscritto. Potete attivarlo o disattivarlo in qualsiasi momento nella configurazione.

## Personalizzare il popup

Il markup è isolato in `views/storefront/component/datafirefly/popup-newsletter.html.twig`, iniettato da `views/storefront/base.html.twig` nel blocco `base_body`. Per modificare la struttura del popup, sovrascrivete questo template nel vostro tema. Gli stili si trovano in `app/storefront/src/scss/base.scss` e il colore di accento è pilotato dalla variabile CSS `--df-popup-accent`, a sua volta alimentata dall'impostazione «colore di accento» della configurazione. Il comportamento (trigger, AJAX, copia del codice) è gestito dal plugin di storefront `PopupNewsletterPlugin`.

## FAQ e risoluzione dei problemi

**Il popup non appare affatto.** In quasi tutti i casi, manca il JavaScript precompilato: verificate che lo ZIP installato contenga la cartella `dist/`, poi eseguite `theme:compile` e svuotate la cache. Ispezionate la pagina: l'elemento `.df-popup-newsletter` deve essere presente nel DOM con l'attributo `hidden` — è il JS a renderlo visibile.

**L'ho chiuso una volta e non ricompare più.** È il comportamento previsto: il plugin memorizza la chiusura per il numero di giorni configurato, tramite la chiave `dfPopupNewsletterDismissedAt` del `localStorage`. Per riprovare, aprite una finestra di navigazione in incognito o svuotate la memoria locale del browser.

**Il popup appare ma senza stili.** Il tema non è stato ricompilato: eseguite `bin/console theme:compile`.

**Il codice non viene applicato al carrello.** Verificate in **Marketing → Promozioni** che la promozione «Popup Newsletter — Welcome» sia attiva, assegnata al canale di vendita corretto e nel suo periodo di validità. In modalità unica, controllate che il codice individuale non sia già stato usato.

**Cosa succede alla disinstallazione?** La promozione e i codici già distribuiti vengono volutamente conservati per non invalidare codici in circolazione tra i vostri clienti. Rimuoveteli manualmente da Marketing → Promozioni se necessario.

**Il plugin rallenta il mio negozio?** No: nessuna entità personalizzata, nessuna query aggiuntiva al caricamento delle pagine, un unico file JS leggero e l'SCSS compilato nel vostro tema.