DF Samples — Ordine di campioni prodotto (PrestaShop 8 e 9)

Presentazione

DF Samples aggiunge un pulsante «Ordina un campione» alle sue schede prodotto. Il campione può essere gratuito o costare qualche euro. Il modulo genera automaticamente un prodotto campione nascosto per ogni prodotto iscritto al programma, applica limiti per cliente, traccia la conversione campione → acquisto e ricontatta automaticamente i suoi clienti via email con un buono sconto opzionale.

Il modulo è compatibile con PrestaShop 8.0 fino a 9.x, multinegozio e multilingua, e non utilizza alcun override del core.

Installazione

1. Nel back-office, vada in Moduli > Gestore moduli.
2. Clicchi su Carica un modulo e trascini il file dfsamples.zip.
3. All’installazione, il modulo crea le sue due tabelle, le impostazioni predefinite, un token di sicurezza per l’attività cron e una scheda di amministrazione in Catalogo > Campioni (DF).

Il modulo si registra sugli hook displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder e actionObjectProductDeleteAfter.

Aggiungere un prodotto al programma di campioni

1. Apra Catalogo > Campioni (DF).
2. Clicchi su Aggiungi.
3. Cerchi un prodotto per nome o riferimento nel campo di completamento automatico, poi lo selezioni dall’elenco. I prodotti già iscritti al programma e i prodotti campione stessi vengono esclusi automaticamente dai risultati.
4. Inserisca il prezzo del campione IVA inclusa. Inserisca 0,00 per un campione gratuito.
5. Definisca il massimo per cliente per questo prodotto (0 = illimitato).
6. Salvi.

Cosa fa il modulo al salvataggio

Il modulo crea automaticamente un prodotto campione nascosto:

• Nome prefissato e tradotto nelle sue lingue: Échantillon, Sample, Muestra, Muster, Campione.
• Riferimento dedicato in formato SMPL seguito dall’identificativo del prodotto di origine.
• Prezzo al netto calcolato a partire dal prezzo IVA inclusa inserito e dall’aliquota IVA del prodotto di origine.
• Immagine di copertina del prodotto di origine copiata e ridimensionata in tutti i formati.
• Visibilità impostata su «da nessuna parte»: il prodotto non compare né nella navigazione né nella ricerca.
• Stock illimitato (ordini in esaurimento consentiti) per non bloccare mai una richiesta.
• Peso del campione preso dall’impostazione globale, utilizzato dai corrieri.

Se in seguito modifica il prezzo, il peso globale o lo stato attivo, il prodotto campione viene risincronizzato. Se il prodotto campione è stato eliminato manualmente dal catalogo, viene ricreato al salvataggio successivo.

Impostazioni

Le impostazioni si trovano in fondo alla pagina Catalogo > Campioni (DF), sotto l’elenco dei prodotti.

Impostazioni generali

• Posizione del pulsante — sotto il pulsante di aggiunta al carrello (displayProductActions) o nel blocco informazioni aggiuntive (displayProductAdditionalInfo). Cambi questa impostazione se il suo tema non renderizza il primo hook.
• Prezzo del campione predefinito IVA inclusa — valore precompilato alla creazione di un nuovo campione.
• Peso del campione — in chilogrammi, applicato a tutti i prodotti campione generati. Utilizzato per il calcolo delle spese di spedizione.
• Account cliente obbligatorio — consigliato e attivo per impostazione predefinita. I limiti per cliente possono essere applicati in modo affidabile solo su clienti identificati.
• Conversione conteggiata su — solo l’acquisto del prodotto campionato, oppure qualsiasi acquisto successivo.

Limiti

• Massimo di campioni per carrello — 0 per illimitato.
• Massimo di campioni per cliente e per finestra — tutti i prodotti campione insieme. 0 per illimitato.
• Finestra mobile — in giorni, 30 per impostazione predefinita. I contatori per cliente si applicano a questo periodo mobile.

Lo stesso campione non può mai essere aggiunto due volte allo stesso carrello, qualunque sia la configurazione.

Follow-up automatico

• Attivare le email di follow-up.
• Intervallo dopo l’ordine del campione — in giorni, 14 per impostazione predefinita.
• Includere un buono sconto — per ogni follow-up viene generato un buono nominativo, monouso.
• Importo del buono — in percentuale, 10 per impostazione predefinita.
• Validità del buono — in giorni, 30 per impostazione predefinita.

L’URL dell’attività cron, protetto da token, è visualizzato in questa sezione e nel pannello delle statistiche.

Configurare l’attività cron

I follow-up vengono inviati da un’attività cron. Pianifichi ogni ora l’URL mostrato nelle impostazioni. Esempio di crontab:

0 * * * * wget -q -O /dev/null "https://il-suo-negozio.com/module/dfsamples/cron?token=IL_SUO_TOKEN"

Ogni esecuzione elabora fino a cinquanta follow-up in attesa e restituisce un riepilogo JSON: numero di record elaborati, inviati, ignorati e in attesa.

Regole applicate dall’attività cron

• Vengono considerati solo i campioni non ancora convertiti e per i quali non è ancora stato inviato un follow-up.
• L’ordine del campione deve aver raggiunto uno stato pagato, spedito o consegnato.
• Gli ordini annullati o con errore di pagamento vengono ignorati definitivamente.
• Gli ordini in attesa di pagamento vengono rinviati all’esecuzione successiva.

Tracciamento delle conversioni

Alla convalida di ogni ordine, il modulo registra le righe di campione: cliente, email, prodotto di origine, lingua e negozio.

Quando lo stesso cliente effettua un ordine successivo, il modulo contrassegna come convertiti i campioni corrispondenti:

• In modalità prodotto (predefinita): solo se l’ordine contiene il prodotto di cui è stato ricevuto il campione.
• In modalità qualsiasi acquisto: non appena l’ordine contiene un prodotto reale, qualunque esso sia.

L’ordine corrente è escluso dal calcolo: ordinare un campione e il suo prodotto nello stesso carrello non conta come conversione.

Dashboard

Il pannello visualizzato sopra l’elenco dei prodotti presenta:

• Campioni ordinati — numero totale di righe di campione registrate.
• Conversioni — numero di campioni seguiti da un acquisto, e il relativo tasso di conversione.
• Fatturato delle conversioni — somma dell’importo IVA inclusa degli ordini di conversione.
• Follow-up in attesa — numero di campioni idonei a un follow-up non ancora inviato.

L’elenco dei prodotti mostra inoltre, per ogni prodotto, il numero di campioni ordinati e il numero di conversioni.

Email di follow-up

I modelli si trovano nella cartella mails del modulo, in cinque lingue: fr, en, es, de, it. Ogni lingua dispone di una versione HTML e di una versione testuale del modello dfsamples_followup.

Variabili disponibili: firstname, lastname, product_name, product_link, voucher_block e shop_name. Il blocco voucher_block contiene il buono sconto formattato, o una stringa vuota se il buono è disattivato.

Può personalizzare liberamente questi modelli. Conservi le variabili tra parentesi graffe affinché la sostituzione funzioni.

Buoni sconto

Quando l’opzione è attiva, ogni follow-up genera una regola carrello PrestaShop:

• Codice in formato SMPL seguito da otto caratteri casuali.
• Riservato al cliente destinatario.
• Utilizzabile una sola volta.
• Sconto in percentuale, sull’importo IVA inclusa.
• Periodo di validità configurabile.

I buoni generati sono visibili in Sconti > Regole carrello.

Disinstallazione

Alla disinstallazione, il modulo rimuove le sue due tabelle, le impostazioni e la scheda di amministrazione. I prodotti campione generati vengono disattivati, non eliminati, in modo che lo storico dei suoi ordini passati resti coerente. Può eliminarli manualmente dal catalogo se lo desidera.

Risoluzione dei problemi

Il pulsante non compare sulla scheda prodotto

Verifichi che il prodotto sia iscritto al programma e attivo in Catalogo > Campioni (DF). Se il prodotto è effettivamente attivo, cambi l’impostazione «Posizione del pulsante»: alcuni temi non renderizzano l’hook displayProductActions.

I follow-up non partono

Verifichi che l’attività cron sia pianificata e che l’URL contenga il token corretto. Richiami l’URL manualmente in un browser: il modulo restituisce un riepilogo JSON. Verifichi anche che l’opzione di follow-up sia attiva e che l’intervallo configurato sia effettivamente trascorso dagli ordini di campione.

Il prezzo del campione non è quello atteso

Il prezzo si inserisce IVA inclusa e viene convertito al netto secondo l’IVA del prodotto di origine. Se il prodotto di origine non ha una regola fiscale, il prezzo al netto è uguale al prezzo inserito.

Un cliente supera i suoi limiti

I limiti per cliente si applicano solo ai clienti identificati. Attivi l’impostazione «Account cliente obbligatorio» per renderli effettivi.