DataFirefly PWA — Guida completa

Panoramica

Il modulo DataFirefly PWA (dfpwa) trasforma il tuo negozio PrestaShop in una Progressive Web App: i clienti la installano sulla schermata Home, ricevono notifiche push web e continuano a navigare offline. Il modulo è del tutto autonomo: la cifratura delle notifiche gira in PHP nativo, senza Composer, senza servizi esterni e senza abbonamento.

Compatibilità e requisiti

• PrestaShop da 8.0 a 9.x, mono-negozio e multinegozio
• Modulo tradotto in 7 lingue: FR, EN, ES, DE, IT, NL, PL
• Nessuna dipendenza: né Composer, né framework, né servizi esterni
• HTTPS obbligatorio: le PWA e il push web non esistono in HTTP
• Estensione PHP openssl con la curva prime256v1, per la cifratura VAPID
• Attività cron per le campagne programmate, gli avvisi prodotto e il recupero dei carrelli

Installazione

1. Back office: Moduli > Gestore dei moduli.
2. Carica un modulo, quindi seleziona dfpwa.zip.
3. Fai clic su Configura.
4. Copia l’URL cron indicato nel cruscotto e aggiungilo al tuo scheduler, ogni 5-15 minuti.

Configurazione

Applicazione e installazione

• Nome e nome breve: mostrati sotto l’icona una volta installata.
• Colore del tema e colore di sfondo: barra di sistema e schermata di avvio.
• Modalità di visualizzazione: standalone consigliata. La modalità browser impedisce qualsiasi installazione.
• URL di avvio: pagina aperta all’avvio dell’applicazione.
• Icone 192 e 512 px: PNG o WebP quadrati. Un’icona troppo piccola o non quadrata viene rifiutata e resta quella predefinita del modulo, per non compromettere l’installabilità.
• Banner di installazione, ritardo di comparsa e aiuto iOS.

Diagnostica di installabilità

Il cruscotto verifica punto per punto ciò che Chrome richiede prima di proporre l’installazione: HTTPS, modalità di visualizzazione compatibile, icone 192 e 512 px valide, pagina di fallback offline disponibile e modulo attivo. Un collegamento apre il manifest generato.

Push web

• Oggetto VAPID: indirizzo di contatto inviato ai servizi push, in mailto: o https://.
• Chiedi automaticamente e messaggio di consenso: richiesta preliminare prima della finestra nativa del browser, conforme al GDPR.
• Campanella di iscrizione: sei posizioni, nascondibile su carrello e checkout. Una volta iscritto il visitatore, la campanella diventa una scorciatoia alle sue preferenze.
• Durata del messaggio: per quanto tempo un servizio push conserva una notifica non consegnata.
• Numero massimo di notifiche per dispositivo al giorno: 0 disattiva il limite. I messaggi transazionali non lo consumano mai.
• Ore di silenzio: le campagne in coda in quella fascia vengono inviate dopo dal cron. Due valori uguali disattivano la funzione.
• Messaggi per esecuzione del cron: riducilo se il tuo hosting impone un timeout PHP breve.

Modalità offline

• Strategia di cache: stale-while-revalidate (consigliata), rete prima o cache prima.
• Titolo e messaggio della pagina di fallback, ed elenco di URL in pre-cache.

Inviare una campagna

1. Apri PWA Push nel menu di amministrazione.
2. Inserisci un titolo (circa 50 caratteri) e un messaggio (circa 120 caratteri).
3. Aggiungi un’immagine banner caricandola (JPG, PNG o WebP, massimo 2 MB, rapporto ideale 2:1) oppure indicando un URL. Il file caricato ha la priorità.
4. Aggiungi fino a due pulsanti di azione, ciascuno con la propria etichetta e il proprio URL.
5. Segmenta per lingua, gruppo di clienti, dispositivo (iOS, Android, desktop) e pubblico (tutti, clienti registrati, ospiti).
6. Lascia vuoto Programma per il per inviare subito, oppure indica una data nel formato AAAA-MM-GG HH:MM.
7. Usa la modalità di test per inviarti la notifica prima di un invio di massa.

Coda di invio

Ogni invio viene messo in coda ed elaborato a lotti. Una parte parte subito, il resto lo distribuisce il cron. Una base di decine di migliaia di iscritti non provoca quindi alcun timeout né statistiche troncate. Il cruscotto mostra quante notifiche sono in attesa e permette di forzare un’elaborazione.

Cronologia e statistiche

La cronologia elenca le ultime trenta campagne con stato, destinatari, consegne, errori, clic e tasso di clic. Il clic è attribuito alla campagna che ha generato la notifica, e il contatore non può mai superare il numero di messaggi realmente consegnati. Gli iscritti si esportano in CSV.

Automazioni

Tracciamento dell’ordine

Seleziona gli stati che attivano una notifica. Per impostazione predefinita: pagamento accettato, spedito, consegnato. Nessuno stato selezionato significa notificare a ogni cambio.

Recupero dei carrelli abbandonati

Il cron individua i carrelli con articoli, collegati a un cliente iscritto e senza ordine, entro la finestra configurata (da 1 a 168 ore).

Avvisi di ritorno disponibilità e di ribasso

Sulla scheda prodotto compare un pulsante. Quello di ritorno disponibilità appare solo se il prodotto non è disponibile; quello di ribasso è sempre proposto. Il visitatore non ha bisogno di un account: l’avviso è legato all’iscrizione del suo dispositivo. Il prezzo al momento della richiesta viene memorizzato e tu imposti la percentuale minima di ribasso che attiva l’avviso.

Notifica di benvenuto

Inviata una sola volta, alla prima iscrizione di un dispositivo. Conferma l’iscrizione e non viene mai bloccata dalle preferenze del cliente.

Preferenze del cliente

Dal suo account il cliente apre Preferenze di notifica e attiva o disattiva quattro categorie:

• Aggiornamenti sugli ordini: spedizione e cambi di stato
• Avvisi sui prodotti: ritorno disponibilità e ribassi
• Promemoria del carrello: recupero del carrello abbandonato
• Offerte e novità: campagne di marketing

GDPR

• Consenso richiesto con un messaggio esplicito prima di qualsiasi iscrizione
• Il cliente gestisce le sue categorie dall’account e può disattivare tutto
• L’eliminazione di un account cliente cancella iscrizioni, avvisi prodotto e messaggi in coda, tramite l’hook GDPR di PrestaShop
• Nessun dato viene trasmesso a servizi esterni: la cifratura avviene sul tuo server

Personalizzazione dal tema

• data-dfpwa-bell su un elemento lo trasforma in pulsante di iscrizione e sostituisce la campanella flottante.
• data-dfpwa-share su un elemento lo trasforma in pulsante di condivisione nativo.
• La classe dfpwa-prefs-form è lasciata senza stile per le tue regole CSS.

FAQ e risoluzione dei problemi

Il banner di installazione non appare su Android

Chrome non mostra nulla finché il negozio non soddisfa i suoi criteri. Consulta la diagnostica del cruscotto, poi esegui dfpwaDiagnose() nella console del browser sul negozio: il verdetto indica cosa manca. Se hai già installato la PWA sul dispositivo, disinstallala e cancella i dati del sito prima di riprovare. Un rifiuto memorizzato dal visitatore scade dopo 30 giorni, o subito con dfpwaResetPrompts().

Su iPhone non si installa nulla

È il comportamento normale di Safari, che non ha una richiesta automatica. La guida «Aggiungi a Home» del modulo spiega i passaggi. Il push web funziona lì solo da iOS 16.4 in poi e soltanto con il negozio già installato.

Le notifiche non partono

Verifica che il push sia attivo, che le chiavi VAPID esistano e che ci siano clienti iscritti. La modalità di test convalida l’intera catena. Se i messaggi restano in coda, controlla che il cron venga effettivamente richiamato.

Una campagna resta in attesa

È programmata per una data futura, in coda durante le ore di silenzio, oppure in distribuzione a lotti. Il cruscotto permette di forzare l’elaborazione.

Un cliente dice di non ricevere più nulla

Controlla le sue preferenze di notifica: potrebbe aver disattivato una categoria. Verifica anche il limite giornaliero per dispositivo e le ore di silenzio.

Gli avvisi prodotto non si attivano

Dipendono dal cron. Verifica che venga eseguito, che il tipo di avviso sia attivo e, per i ribassi, che lo sconto raggiunga la percentuale minima configurata.