# 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… - Pagina: - Lingua: it - Aggiornato il: 2026-07-10 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfcustomizer/index.md), [en](https://www.datafirefly.com/en/documentation/dfcustomizer/index.md), [es](https://www.datafirefly.com/es/documentation/dfcustomizer/index.md), [de](https://www.datafirefly.com/de/documentation/dfcustomizer/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcustomizer/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcustomizer/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcustomizer/index.md) - Indice: ## 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. **Nota:** è possibile una sola personalizzazione per coppia _prodotto / combinazione_ e per 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. **Limitazione:** una personalizzazione per coppia prodotto/combinazione e per carrello. ## 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.