SW Shopware 6 Shopware Principiante

Popup Pro Newsletter — Guida completa

Installare, configurare e utilizzare Popup Pro Newsletter: popup di iscrizione alla newsletter che offre un codice sconto sul primo ordine, codici unici per iscritto tramite promozioni native, trigger a tempo/scroll e double opt-in GDPR, per Shopware 6.6 e 6.7.

Aggiornato Versione del modulo 1.0.0

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.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza