Ricerche Salvate e Avvisi Nuovi Prodotti — Documentazione

Panoramica

Il modulo Ricerche Salvate e Avvisi (dfsavedsearch) consente ai tuoi clienti di salvare una combinazione di criteri di ricerca — parole chiave, categoria, produttore, fascia di prezzo, disponibilità — e di ricevere un’email automatica non appena un nuovo prodotto corrispondente viene pubblicato nel tuo negozio.

Ogni ricerca salvata diventa un canale di riattivazione: il cliente torna da solo il giorno in cui pubblichi un prodotto che gli interessa. Un registro anti-duplicati garantisce che venga avvisato solo dei prodotti pubblicati dopo il salvataggio della sua ricerca, e mai due volte per lo stesso prodotto.

Installazione

1. Nel tuo back-office, apri Moduli > Gestore moduli e clicca su Carica un modulo.
2. Seleziona l’archivio dfsavedsearch.zip e conferma.
3. All’installazione, il modulo crea le sue due tabelle SQL, la sua scheda di amministrazione e la sua configurazione predefinita. Un token cron di 32 caratteri viene generato automaticamente.
4. Il modulo è attivo immediatamente. Non è richiesta alcuna dipendenza esterna (né Composer né framework).

Configurazione (back-office)

Vai alla pagina di configurazione del modulo (Moduli > Gestore moduli > dfsavedsearch > Configura). Le impostazioni disponibili sono:

• Attiva il modulo — attiva o sospende la visualizzazione del pulsante e l’invio degli avvisi.
• Prodotti per riepilogo — numero massimo di prodotti elencati in una stessa email di avviso (12 per impostazione predefinita).
• Ricerche per cliente — numero massimo di ricerche che un cliente può salvare (20 per impostazione predefinita).
• Frequenza predefinita — giornaliera o settimanale, applicata alle nuove ricerche.
• Token cron — mostrato in chiaro, con un pulsante di rigenerazione. L’URL completo del cron e la data dell’ultimo passaggio sono richiamati in un pannello dedicato.

I valori sono memorizzati nelle variabili di configurazione DFSAVEDSEARCH_ENABLED, DFSAVEDSEARCH_MAX_PRODUCTS, DFSAVEDSEARCH_MAX_PER_CUST, DFSAVEDSEARCH_DEFAULT_FREQ, DFSAVEDSEARCH_CRON_TOKEN e DFSAVEDSEARCH_LAST_CRON.

Utilizzo lato cliente

Nella pagina dei risultati di ricerca, viene inserito automaticamente un pulsante « Salva questa ricerca ». Cliccandolo, il cliente apre una finestra in cui può:

• assegnare un nome alla sua ricerca;
• precisare o regolare i suoi criteri: parole chiave, categoria (sottocategorie incluse), produttore, prezzo minimo e massimo, solo prodotti disponibili;
• attivare, se lo desidera, l’avviso via email e scegliere la sua frequenza.

L’avviso via email si basa su una casella di consenso esplicito, deselezionata per impostazione predefinita, accompagnata da un testo di consenso chiaro. A un visitatore non connesso viene chiesto di accedere prima di salvare una ricerca.

L’area « Le mie ricerche »

Una voce « Le mie ricerche » viene aggiunta all’account cliente. Lì il cliente ritrova tutte le sue ricerche salvate e può, per ciascuna:

• attivare o disattivare l’avviso via email;
• cambiare la frequenza (giornaliera / settimanale);
• eliminare la ricerca.

I criteri di ogni ricerca sono riassunti sotto forma di badge leggibili (categoria, produttore, fascia di prezzo, ecc.).

Pianificazione del cron (invio degli avvisi)

L’invio delle email è gestito da un’attività cron protetta da token. Configura lo scheduler del tuo server (o un servizio di cron) per richiamare il seguente URL:

https://il-tuo-negozio.com/index.php?fc=module&module=dfsavedsearch&controller=cron&token=IL_TUO_TOKEN

Sostituisci IL_TUO_TOKEN con il token mostrato nella configurazione del modulo.

L’elaborazione avviene a lotti (200 ricerche per passaggio) per restare leggera. L’output del cron indica il numero di ricerche elaborate, email inviate ed eventuali errori, registrati nei log di PrestaShop.

Conformità GDPR

• Consenso esplicito: l’avviso via email non viene mai attivato senza un’azione volontaria del cliente (casella deselezionata per impostazione predefinita).
• Disiscrizione con un clic: ogni email contiene un link di disiscrizione firmato che disattiva l’avviso senza accedere.
• Esportazione ed eliminazione: il modulo si integra con gli hook GDPR di PrestaShop (psgdpr) per l’esportazione e l’eliminazione dei dati personali.
• Pulizia automatica: all’eliminazione di un account cliente, tutte le sue ricerche salvate vengono rimosse.

Compatibilità e convenzioni tecniche

• PrestaShop 8.0 a 9.x, multi-negozio, 5 lingue.
• Hook utilizzati: displayCustomerAccount, actionFrontControllerSetMedia, displayFooter, actionObjectCustomerDeleteAfter, actionDeleteGDPRCustomer, actionExportGDPRData.
• Scheda di amministrazione AdminDfSavedSearch sotto il menu Clienti.
• Senza dipendenze: autoloader PSR-4 manuale, JS vanilla, nessun servizio esterno.

Risoluzione dei problemi

• Non viene inviata alcuna email — verifica che il cron venga effettivamente richiamato (data dell’ultimo passaggio nella configurazione), che il modulo sia attivato e che la configurazione email di PrestaShop funzioni.
• Il pulsante non compare — viene mostrato solo nella pagina dei risultati di ricerca; assicurati che il modulo sia attivato e svuota la cache di PrestaShop.
• Un cliente non riceve avvisi — assicurati che l’avviso sia attivo per quella ricerca e che nuovi prodotti corrispondenti siano stati effettivamente pubblicati dopo il salvataggio.