Modulo Ottica PrestaShop: installazione e configurazione
Installare il modulo, configurare lenti, trattamenti e montature, capire le regole di fattibilità e gestire gli ordini di occhiali da vista.
Presentazione
Il modulo dfopticlens permette di vendere occhiali da vista su PrestaShop 8 e 9. Nella pagina di una montatura il cliente sceglie un tipo di lente, inserisce la prescrizione, sceglie una lente tra gli indici proposti, aggiunge i trattamenti e conferma un riepilogo. Il server controlla ogni valore, calcola il prezzo e verifica che la correzione sia realizzabile sulla montatura. Il prezzo delle lenti si aggiunge alla riga della montatura tramite la personalizzazione nativa di PrestaShop, e la prescrizione segue l’ordine fino alla fattura.
Installazione
- In Moduli > Gestione moduli, clicca su Carica un modulo e invia
dfopticlens-1.1.0.zip. - L’installazione crea il menu Vendi > Ottica con quattro pagine: Prescrizioni, Montature, Lenti e indici, Trattamenti.
- Vengono create cinque lenti (1.50, 1.59 policarbonato, 1.60, 1.67, 1.74) e sette trattamenti con prezzi di esempio. Adattali prima della messa online.
- Viene creata la cartella
upload/dfopticlens/, protetta da un file.htaccess: i file delle prescrizioni non sono mai raggiungibili dal web.
Aggiornamento dalla 1.0.0: carica lo ZIP 1.1.0 sopra. Lo script di aggiornamento aggiunge le nuove impostazioni e gli hook senza perdita di dati.
Configurazione del modulo
La pagina di configurazione (pulsante Configura del modulo) raggruppa le impostazioni in tre blocchi.
Inserimento della prescrizione
- Convenzione del cilindro inviata al laboratorio: cilindro negativo, positivo o mantenuto come scritto. Il cliente inserisce sempre i valori della sua prescrizione, la trasposizione avviene al salvataggio.
- Invio del file della prescrizione: disattivato, facoltativo o obbligatorio, con dimensione massima in MB. Formati accettati: PDF, JPG, PNG, verificati in base al contenuto.
- Avvisa quando la prescrizione ha più di X anni (0 disattiva).
- Elimina le prescrizioni dei carrelli abbandonati dopo X giorni.
- Invio del file dall’account dopo l’ordine: aggiunge la pagina Le mie prescrizioni all’account cliente.
- Opzione Non conosco la mia distanza interpupillare e distanza interpupillare media usata (63 mm di default). L’ordine viene allora segnalato da verificare.
Regole di fattibilità
- Blocca le lenti che non possono essere realizzate: attivo di default. Se disattivato, l’ordine viene accettato con un avviso.
- Margine di molatura e margine del diametro effettivo quando l’ED della montatura non è noto (ED stimato = A + margine).
- Altezza minima per le progressive (28 mm) e corridoio corto sotto (32 mm).
- Soglie di avviso: differenza tra gli occhi, decentramento per occhio, potere positivo su montature a nylor.
- Spessore obiettivo della lente consigliata, spessore al centro delle lenti negative e al bordo delle positive (forate o no).
Prezzi
- Prezzi inseriti IVA inclusa o esclusa. Alle lenti si applica la regola fiscale del prodotto montatura.
- Supplementi per potere elevato e cilindro elevato: soglia in diottrie e importo (0 disattiva).
Lenti e indici
In Vendi > Ottica > Lenti e indici, ogni lente ha:
- un nome e una breve descrizione mostrati al cliente, in ogni lingua;
- l’indice di rifrazione, usato per la stima dello spessore, e il materiale per la scheda di laboratorio;
- i tipi di lente per cui è proposta e un prezzo al paio per ciascuno: monofocale, progressiva, senza correzione;
- sfera minima e massima e cilindro massimo (valore assoluto, letti in forma a cilindro negativo come le gamme dei produttori);
- il diametro massimo del grezzo disponibile (0 disattiva il controllo) e se può essere forata per le montature a giorno.
Trattamenti
In Trattamenti, ogni trattamento ha un prezzo al paio (0 lo mostra come incluso). Il gruppo esclusivo impedisce di combinare due trattamenti: quelli con lo stesso codice, ad esempio tint per fotocromatico, colorazione solare e polarizzato, si escludono a vicenda. Puoi anche limitare un trattamento ad alcune lenti, ad esempio il polarizzato agli indici 1.50 e 1.60.
Montature
Una montatura collega un prodotto, o una delle sue combinazioni, alle sue misure. Il blocco lenti compare solo sui prodotti con una montatura attiva.
Creare una montatura
- In Montature, clicca su Aggiungi una montatura, oppure dalla pagina prodotto, scheda Moduli, su Aggiungi le misure della montatura.
- Cerca il prodotto per nome, riferimento o ID, poi scegli Tutte le combinazioni o una combinazione precisa. Una montatura definita per una combinazione ha la priorità.
- Indica il tipo (cerchiata, nylor, a giorno), la larghezza della lente A, il ponte DBL e l’altezza della lente B, obbligatori. Sono i numeri stampati sull’asta: 52□18 dà A = 52 e DBL = 18.
- Facoltativo: il diametro effettivo ED (altrimenti stimato) e il potere massimo accettato dalla montatura.
- Seleziona i tipi di lente proposti e, se serve, Vendi solo con lenti.
Con Vendi solo con lenti, il pulsante nativo del carrello apre la scelta delle lenti. Se una chiamata diretta al carrello aggiunge comunque la montatura da sola, il modulo la toglie dal carrello.
Importazione ed esportazione CSV
Il pulsante Esporta CSV fornisce un file nel formato corretto. L’importazione accetta punto e virgola o virgola e queste colonne:
product;combination;frame_type;lens_width;lens_height;bridge;ed;max_power;vision_types;lens_required;active
product: ID o riferimento del prodotto;combination: ID o riferimento della combinazione, vuoto o 0 per tutte.frame_type: full, semi o rimless;vision_types: single|progressive|plano.- Una montatura esistente (stesso prodotto e combinazione) viene aggiornata. Le righe rifiutate vengono elencate con il loro numero.
Il pulsante Risincronizza i prodotti ricostruisce i campi di personalizzazione dei prodotti, utile se un dipendente senza permessi sul modulo ha modificato dei prodotti.
Percorso del cliente
- Tipo: monofocale, progressiva o senza correzione, secondo ciò che la montatura propone. Senza correzione, il passaggio della prescrizione viene saltato.
- Prescrizione: griglia OD / OS, distanza interpupillare in uno o due valori, data, file e nota per l’ottico. Un cliente connesso può riprendere la prescrizione di un ordine precedente.
- Lente: schede con prezzo al paio, sezione in scala, spessore stimato e lente consigliata. Le lenti non realizzabili sono in grigio con il motivo.
- Trattamenti: quelli non disponibili per la lente scelta sono in grigio.
- Riepilogo: stato di fattibilità, note, dettaglio del prezzo e totale montatura e lenti.
I dati inseriti restano se il cliente ricarica la pagina e vengono cancellati dopo l’aggiunta al carrello.
Regole di fattibilità
| Controllo | Effetto |
|---|---|
| Sfera o cilindro fuori dall’intervallo della lente | Lente non disponibile |
| Diametro del grezzo necessario (ED + 2 × decentramento + margine) superiore al grezzo della lente | Lente non disponibile se il blocco è attivo |
| Montatura a giorno e materiale non forabile | Lente non disponibile se il blocco è attivo |
| Altezza B inferiore al minimo per una progressiva | Bloccante (o avviso) |
| Altezza B sotto la soglia del corridoio corto | Informazione |
| Potere superiore al massimo della montatura | Bloccante (o avviso) |
| Differenza tra gli occhi, forte decentramento, potere positivo elevato su nylor, prescrizione datata, distanza interpupillare sconosciuta | Avviso, ordine segnalato da verificare |
I calcoli usano la forma a cilindro negativo. Lo spessore è stimato con la formula della saetta: serve a confrontare gli indici, non è il calcolo del laboratorio.
Prezzi, sconti e fattura
Il prezzo delle lenti è salvato IVA esclusa nella personalizzazione della riga del carrello. PrestaShop lo aggiunge al prezzo della montatura e applica l’IVA del prodotto. Se la montatura ha uno sconto in percentuale (prezzo specifico o gruppo clienti), PrestaShop lo applica anche alle lenti: il pannello mostra il prezzo barrato e una riga Promozione della montatura applicata anche alle lenti, perché il totale indicato corrisponda al carrello.
Ordini e scheda di laboratorio
- La pagina ordine del back office mostra un blocco per prescrizione: valori trasposti, lente, trattamenti, misure della montatura, decentramento e grezzo minimo per occhio, note di fattibilità e dettaglio del prezzo.
- Stampa scheda di laboratorio apre una pagina A4 pronta da stampare.
- Scarica il file della prescrizione recupera la scansione inviata dal cliente.
- Vendi > Ottica > Prescrizioni elenca tutte le prescrizioni con il loro stato: OK, da verificare, non realizzabile.
Account cliente: Le mie prescrizioni
Un cliente che ha ordinato lenti vede il link Le mie prescrizioni nel suo account. La pagina mostra ogni prescrizione con l’ordine collegato. Se l’invio del file è facoltativo e il cliente non l’ha allegato, può inviarlo da questa pagina; l’ottico lo ritrova poi nell’ordine.
Dati sanitari e GDPR
- I file delle prescrizioni sono salvati fuori dalla cartella pubblica e si scaricano solo dal back office.
- Le prescrizioni dei carrelli mai ordinati vengono eliminate dopo il termine impostato, insieme alla riga di carrello corrispondente.
- Con il modulo ufficiale psgdpr, esportazione e cancellazione dei dati di un cliente includono le sue prescrizioni.
Risoluzione dei problemi
Il blocco lenti non compare nella pagina prodotto
Verifica che il prodotto abbia una montatura attiva e che il tema mostri l’hook displayProductAdditionalInfo. Svuota la cache di PrestaShop.
Il pulsante nativo del carrello non apre il pannello su una montatura solo con lenti
Il modulo intercetta i pulsanti con data-button-action="add-to-cart". Se il tuo tema usa un altro attributo, il blocco lato server resta attivo: la montatura da sola viene tolta dal carrello.
Il totale del pannello è diverso dal carrello
Uno sconto a importo fisso si applica solo alla montatura e una regola carrello (buono) si applica all’intero carrello: non compaiono nel pannello delle lenti.