Personalizzazione Prodotto (incisione, testo, immagine) — Guida completa

Presentazione

Il modulo Personalizzazione Prodotto consente ai tuoi clienti di personalizzare un articolo direttamente dalla scheda prodotto: inserimento di un testo / incisione (con font e colore) o caricamento di un’immagine. La personalizzazione appare come anteprima live sulla foto del prodotto — posizionamento tramite trascinamento, dimensione e rotazione regolabili — e ogni opzione può applicare un sovrapprezzo (importo fisso o percentuale) aggiunto automaticamente al carrello.

Il modulo è compatibile con PrestaShop 8.x e 9.x. Crea le proprie tabelle e non sovrascrive le schede prodotto esistenti: la personalizzazione è gestita tramite opzioni che crei, assegnate per categoria e affinabili prodotto per prodotto.

Installazione

1. Comprimi la cartella dfcustomizer (o usa direttamente l’archivio dfcustomizer.zip fornito).
2. Nel back-office, apri Moduli > Gestore dei moduli.
3. Clicca su Carica un modulo e rilascia l’archivio ZIP.
4. Una volta installato, clicca su Configura per creare le tue opzioni.

Durante l’installazione, il modulo crea le tabelle necessarie (dfc_option e le relative tabelle, dfc_product_override, dfc_customization) e registra gli hook di visualizzazione sulla scheda prodotto, sul carrello e sull’ordine.

Configurazione: creare un’opzione

Vai su Moduli > dfcustomizer > Configura per creare e gestire le tue opzioni di personalizzazione. Ogni opzione definisce un tipo di personalizzazione, il suo impatto sul prezzo e il suo ambito di applicazione.

Tipo di personalizzazione

• Testo / incisione: il cliente inserisce un testo. Puoi offrire una scelta di font e colore (entrambi opzionali).
• Caricamento immagine: il cliente carica un file in formato JPG, PNG o WEBP.

Impatto sul prezzo

Ogni opzione può aggiungere un sovrapprezzo al prezzo del prodotto:

• un importo fisso (IVA esclusa), oppure
• una percentuale del prezzo del prodotto.

Il sovrapprezzo viene mostrato in tempo reale sul lato cliente e riportato nel carrello (vedi la sezione Carrello e prezzo).

Assegnazione per categoria

Spunta le categorie a cui deve applicarsi l’opzione: l’opzione apparirà solo sui prodotti di quelle categorie. Se nessuna categoria è spuntata, l’opzione si applica a tutto il catalogo.

Override per prodotto

Nella scheda prodotto (scheda Moduli), ogni prodotto dispone di un’impostazione di override. Può:

• ereditare le opzioni definite dalle categorie (comportamento predefinito);
• scegliere le proprie opzioni specificamente per quel prodotto;
• disattivare completamente la personalizzazione per quel prodotto.

Lato cliente (front-office)

Nella scheda prodotto, il cliente inserisce il suo testo (font, colore) o carica la sua immagine. La personalizzazione appare immediatamente come anteprima live sulla foto del prodotto:

• posizionamento tramite trascinamento sull’immagine;
• cursori di dimensione e rotazione per regolare il risultato.

Il sovrapprezzo legato alle opzioni scelte viene mostrato live. All’aggiunta al carrello, la personalizzazione e un’anteprima appiattita in formato PNG vengono salvate per essere recuperate con l’ordine.

Carrello e prezzo

Il sovrapprezzo viene aggiunto al prezzo dell’articolo nel carrello tramite una regola di prezzo legata al carrello (SpecificPrice associata all’id_cart). Viene ricalcolato a ogni salvataggio del carrello e rimosso automaticamente se il prodotto viene tolto dal carrello.

Lato ordine

Back-office

Nella pagina di un ordine, un pannello «Personalizzazioni prodotto» riepiloga ogni personalizzazione: il testo inserito, il file del cliente scaricabile e l’anteprima generata. Hai tutto il necessario per la produzione (incisione, stampa, ecc.).

Front-office

Il cliente ritrova un promemoria delle sue personalizzazioni nel dettaglio del suo ordine.

Note tecniche

• Tabelle create: dfc_option (+ dfc_option_lang e dfc_option_category), dfc_product_override, dfc_customization.
• Sovrapprezzo: applicato tramite SpecificPrice legato al carrello (id_cart), ricalcolato a ogni salvataggio del carrello e rimosso se il prodotto viene tolto.
• File dei clienti: archiviati in modules/dfcustomizer/uploads/, cartella in cui l’esecuzione di PHP è bloccata da un file .htaccess per sicurezza.

Risoluzione dei problemi

L’opzione di personalizzazione non appare sulla scheda prodotto

Verifica che l’opzione sia attiva e che le sue categorie includano la categoria del prodotto (o che nessuna categoria sia spuntata per puntare a tutto il catalogo). Poi controlla l’override per prodotto (scheda Moduli della pagina): la personalizzazione non deve essere disattivata per quel prodotto. Infine, svuota la cache di PrestaShop.

Il sovrapprezzo non appare nel carrello

Il sovrapprezzo viene ricalcolato al salvataggio del carrello. Verifica che l’opzione abbia un impatto sul prezzo (importo fisso o percentuale) e ricarica il carrello. Se il prodotto è stato tolto e riaggiunto, la personalizzazione va rifatta.

Il caricamento dell’immagine viene rifiutato

Sono accettati solo i formati JPG, PNG e WEBP. Verifica il formato del file e la dimensione massima di caricamento consentita dal tuo hosting (upload_max_filesize / post_max_size di PHP).

Disinstallazione

La disinstallazione rimuove gli hook e la configurazione del modulo. Esegui prima un backup dei file dei clienti in modules/dfcustomizer/uploads/ e dei dati di personalizzazione degli ordini se desideri conservarli.

FAQ

Il modulo è compatibile con PrestaShop 9?

Sì, il modulo è compatibile con PrestaShop 8.x e 9.x.

Posso far pagare la personalizzazione?

Sì. Ogni opzione può applicare un sovrapprezzo, come importo fisso (IVA esclusa) o percentuale del prezzo del prodotto, aggiunto automaticamente al carrello.

Posso limitare un’opzione a certi prodotti?

Sì, in due modi: tramite l’assegnazione per categoria dell’opzione e tramite l’override per prodotto che consente a ogni scheda di ereditare, scegliere le proprie opzioni o disattivare la personalizzazione.

Il cliente può aggiungere più personalizzazioni allo stesso articolo?

Viene salvata una sola personalizzazione per coppia prodotto/combinazione e per carrello.