Modulo Negozio Animali per PrestaShop: documentazione del modulo

Questo modulo aggiunge a PrestaShop 8 e 9 i profili degli animali nell’account del cliente, un calcolo della razione e una raccomandazione di formato nelle schede delle crocchette, e piani di riordino che inviano un promemoria prima che il sacco finisca, calcolato sul consumo reale del cliente. Nome tecnico: dfpetcare.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e trascina il file ZIP.
2. Il modulo crea le sue tabelle e tre specie con le loro razze: cane (32 razze), gatto (12 razze) e coniglio (2 razze).
3. Compare un menu Vendi > Animali con quattro pagine: Razioni degli alimenti, Piani di riordino, Profili animali e Specie e razze. Nella pagina Il mio account del cliente viene aggiunto un link I miei animali.
4. Pianifica l’URL cron mostrato nella pagina di configurazione del modulo (vedi sotto).

Impostare gli alimenti

Solo i prodotti dichiarati in Animali > Razioni degli alimenti mostrano il blocco della razione. Clicca su Aggiungi, cerca il prodotto per nome, riferimento o ID, poi indica:

• Per: le specie interessate. Nella scheda prodotto vengono proposti solo gli animali di queste specie. Lascia vuoto per tutte le specie.
• La fase di vita dell’alimento (tutte le età, crescita, adulto, senior): compare un avviso se l’animale del cliente non è in quella fase.
• Calcolo: tramite l’energia o tramite la tabella di razionamento (vedi sotto).
• Conservazione dopo l’apertura in giorni: i sacchi che resterebbero aperti più a lungo non sono consigliati. 0 = nessun limite.
• Peso netto: per un prodotto con combinazioni, il peso di ogni combinazione in grammi. Il pulsante Compila dai nomi delle combinazioni riprende i pesi letti nei nomi (12 kg, 400 g, 12 x 85 g). Lascia vuota una combinazione che non è alimento. Per un prodotto semplice, inserisci il peso netto totale.

Calcolo tramite l’energia

Inserisci l’energia metabolizzabile dell’alimento in kcal/kg (crocchette: di solito da 3400 a 4200, umido: da 700 a 1200). Per un cane o un gatto, il modulo calcola il fabbisogno energetico a riposo (70 × peso^0,75), lo moltiplica per un coefficiente secondo fase di vita, sterilizzazione e attività e lo converte in grammi. Questo metodo non si applica alle specie impostate su «Altro».

Calcolo tramite la tabella di razionamento

Riporta la tabella stampata sul sacco: una riga per peso dell’animale con i grammi al giorno e la fase di vita della riga. Tra due righe la razione viene interpolata. Fuori tabella segue il peso metabolico. L’opzione Adatta all’animale corregge la razione secondo sterilizzazione e attività per adulti e senior. È l’unico metodo possibile per conigli, roditori e uccelli.

Specie e razze

In Animali > Specie e razze, ogni specie ha un nome per lingua e un modello nutrizionale: cane, gatto o altro (solo tabella di razionamento). Le razze hanno un nome per lingua e una taglia da toy a gigante: per un cucciolo la taglia fissa l’età adulta (12 mesi per le razze piccole, 18 mesi per le grandi, 24 mesi per le giganti). Senza razza, la taglia si deduce dal peso. Una specie usata da animali non può essere eliminata: disattivala. Eliminare una razza lascia gli animali interessati senza razza.

Cosa vede il cliente

I miei animali

Da Il mio account il cliente crea fino a 20 profili: nome, specie, razza, sesso, data di nascita, peso attuale, peso obiettivo, sterilizzazione e livello di attività. Ogni scheda mostra l’età e la fase di vita (cucciolo, gattino, adulto, senior).

Scheda prodotto

Sotto il prezzo, il blocco Razione giornaliera e formato propone gli animali del cliente compatibili con l’alimento. Per gli animali selezionati mostra la razione in grammi al giorno, il numero di pasti consigliato, il totale quando sono più di uno e una tabella dei formati con durata e prezzo al chilo. Il formato consigliato ha un badge e un pulsante Scegli il sacco. Una guida alla transizione di 7 giorni indica i grammi del nuovo alimento giorno per giorno, con il nome dell’alimento attuale quando è noto.

Il formato consigliato è il più economico al chilo tra quelli disponibili che durano almeno la durata minima impostata, senza superare la conservazione dopo l’apertura.

La casella Avvisami via e-mail qualche giorno prima che il sacco finisca attiva i promemoria per questo alimento. La scelta degli animali e la casella vengono memorizzate per il prossimo ordine.

Visitatori

Con il calcolatore di razione per i visitatori, un visitatore o un cliente senza animali indica specie, peso, età, attività e sterilizzazione e ottiene la stessa raccomandazione. Un cliente connesso può salvare questo profilo dandogli un nome.

Pagina di conferma dell’ordine

Dopo un ordine di crocchette, un blocco propone di attivare i promemoria e, se il cliente ha più animali, di scegliere quelli che mangiano questo alimento. Questo blocco non disattiva mai promemoria già attivi: può solo attivarli e indicare gli animali.

Piani di riordino

Ogni cliente ha un piano per alimento. Un ordine viene registrato alla convalida e aggiunto al piano quando il suo stato risulta pagato. La scorta parte dalla data dell’ordine più il tempo medio di consegna e diminuisce ogni giorno secondo il consumo:

• il consumo teorico è la somma delle razioni degli animali collegati al piano;
• a ogni risposta del cliente su quanto gli resta (almeno 5 giorni dopo la precedente), il modulo calcola il consumo osservato, lo limita tra 0,4 e 2,5 volte quello teorico per scartare gli errori di digitazione e lo combina con la stima precedente;
• se il cliente modifica il profilo di un animale, il consumo segue la stessa proporzione.

Ne deriva la data di fine del sacco, e il promemoria è pianificato con l’anticipo del promemoria impostato. Un piano il cui sacco è vuoto da 90 giorni senza nuovi ordini viene chiuso.

Area cliente

In I miei animali, ogni alimento seguito mostra un indicatore di scorta, i giorni rimanenti, la data di fine stimata, la data del prossimo promemoria e il consumo utilizzato. Il cliente può indicare quanto resta (vuoto, un quarto, metà, tre quarti, un sacco, un sacco e mezzo, due sacchi), scegliere quali animali mangiano l’alimento, attivare o disattivare i promemoria, riordinare o smettere di seguire l’alimento.

Promemoria e riordino

Solo i piani il cui cliente ha attivato i promemoria ricevono e-mail:

• il primo promemoria parte il giorno previsto;
• il secondo promemoria parte il numero di giorni impostato più tardi se il cliente non ha riordinato né risposto (0 lo disattiva).

L’e-mail contiene un pulsante Riordina, tre link di risposta (restano circa 2 settimane, circa 1 settimana, il sacco è vuoto) e un link per sospendere i promemoria. I link di risposta aprono una pagina di conferma: nulla viene registrato finché il cliente non clicca, il che protegge dagli scanner di posta che aprono i link.

Il pulsante Riordina chiede l’accesso all’account, riempie il carrello con lo stesso formato e la stessa quantità e rimanda al checkout. Se quel formato è esaurito, il modulo propone il formato disponibile più vicino in quantità. Se lo sconto di riordino è superiore a 0 e il cliente mantiene i promemoria attivi, viene applicato un buono monouso, limitato a quell’alimento e valido per il numero di giorni impostato (codice PET seguito da 8 caratteri).

Configurazione del modulo

• Anticipo del promemoria (7 giorni): quanti giorni prima della fine stimata parte il promemoria. Includi il tuo tempo di consegna.
• Secondo promemoria (5 giorni, 0 = disattivato).
• Tempo medio di consegna (3 giorni): inizio del consumo di un nuovo sacco.
• Sconto di riordino (5 %, 0 = nessun buono) e validità del buono (14 giorni).
• Durata minima del sacco consigliato (14 giorni) e conservazione dopo l’apertura predefinita (42 giorni), precompilata sui nuovi alimenti.
• Calcolatore di razione per i visitatori, esecuzione delle attività con il traffico del back office e promemoria per esecuzione (50).

I valori fuori intervallo vengono riportati automaticamente entro i limiti consentiti.

Attività cron

La pagina di configurazione mostra un URL protetto da token. Richiamalo ogni ora, ad esempio:

0 * * * * curl -s "https://il-tuo-negozio.it/module/dfpetcare/cron?token=..." > /dev/null

Ogni esecuzione integra gli ordini pagati, invia i promemoria dovuti e chiude i piani inattivi. Senza cron, lascia attiva l’esecuzione con il traffico del back office: le attività girano al massimo ogni 3 ore quando un dipendente usa il back office. Il pulsante Esegui ora le attività le avvia su richiesta.

Back office

• Piani di riordino: elenco dei piani filtrabile per cliente, e-mail, alimento, stato, promemoria e data di fine, esportabile in CSV, con gli indicatori del mese (promemoria inviati, riordini dopo un promemoria, rilevazioni di scorta). La scheda di un piano mostra gli animali e la loro razione, il consumo teorico e quello utilizzato, la scorta stimata e la cronologia completa, e permette di registrare la scorta indicata dal cliente o di reinviare il promemoria.
• Profili animali: elenco filtrabile ed esportabile per i tuoi segmenti marketing (specie, razza, età, peso, sterilizzazione, cliente).
• Scheda cliente: un blocco mostra i suoi animali e i suoi piani con un link a ciascun piano.

E-mail e traduzioni

Il modello dfpetcare_reorder è fornito in 8 lingue (francese, inglese, spagnolo, tedesco, italiano, olandese, polacco, portoghese), in HTML e testo, con oggetto e introduzione dedicati per il secondo promemoria. Per ogni altra lingua installata viene copiato il modello inglese. L’interfaccia del modulo è tradotta nelle stesse lingue.

GDPR

Il modulo risponde alle richieste di esportazione e cancellazione dei dati personali: profili degli animali, piani, ordini seguiti e scelte memorizzate. L’eliminazione di un cliente cancella anche i suoi dati nel modulo.

Aggiornamento dalla 1.0.0

Installa lo ZIP 1.1.0 sopra la versione esistente. Lo script di aggiornamento aggiunge la data dell’ultimo promemoria, attiva il secondo promemoria a 5 giorni, aggancia gli hook della pagina di conferma ordine e della scheda cliente e conserva animali, alimenti e piani.

Domande frequenti

Il blocco della razione non compare nella scheda prodotto

Verifica che il prodotto sia dichiarato e attivo in Razioni degli alimenti, che sia inserita un’energia o una tabella e che il cliente abbia un animale di una specie compatibile. Senza animali, il calcolatore compare solo se è attivo.

La durata dei sacchi non viene mostrata

Manca il peso netto della combinazione. Inseriscilo in Razioni degli alimenti.

Non viene inviato nessun promemoria

Verifica che il cliente abbia attivato i promemoria per questo alimento, che il cron giri (data dell’ultima esecuzione nella pagina di configurazione) e che le e-mail del negozio funzionino. Il pulsante Invia ora il promemoria nella scheda di un piano mostra un errore se l’invio fallisce.

Cosa succede alla disinstallazione?

Le tabelle del modulo vengono eliminate: animali, alimenti, piani e cronologie. I buoni già creati restano nelle regole carrello.