# DataFirefly Custom Textile Printing: personalizzazione tessile per PrestaShop

> Presentazione Il modulo aggiunge un blocco di personalizzazione sotto il pulsante di aggiunta al carrello dei prodotti che scegli. Il cliente inserisce le quantità per taglia, spunta le posizioni, sceglie…

- Pagina: <https://www.datafirefly.com/it/documentation/dftextileprint/>
- Lingua: it
- Aggiornato il: 2026-09-24
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dftextileprint/index.md), [en](https://www.datafirefly.com/en/documentation/dftextileprint/index.md), [es](https://www.datafirefly.com/es/documentation/dftextileprint/index.md), [de](https://www.datafirefly.com/de/documentation/dftextileprint/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftextileprint/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftextileprint/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftextileprint/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Presentazione

Il modulo aggiunge un blocco di personalizzazione sotto il pulsante di aggiunta al carrello dei prodotti che scegli. Il cliente inserisce le quantità per taglia, spunta le posizioni, sceglie una tecnica e un numero di colori, invia il file e vede il prezzo calcolato in tempo reale. Il dettaglio segue l'ordine fino alla fattura grazie alla personalizzazione nativa di PrestaShop. Dopo l'ordine, un flusso a stati gestisce l'invio dei file, la bozza e la produzione.

## Installazione

1. In **Moduli > Gestione moduli**, clicca su **Carica un modulo** e invia lo ZIP `dftextileprint`.
2. Il modulo crea le sue tabelle, un prodotto nascosto `DF-TEXTILE-SETUP` che porta i costi di avviamento e un menu **Catalogo > Personalizzazione tessile**.
3. Vengono creati dati dimostrativi: serigrafia, ricamo e vinile con le loro tabelle, e sei posizioni (cuore, fronte, retro, collo posteriore, due maniche). Puoi modificarli o eliminarli.

Non eliminare il prodotto `DF-TEXTILE-SETUP`. Se sparisce, il modulo lo ricrea al salvataggio delle impostazioni.

## Impostazioni

Nella scheda **Impostazioni** del modulo:

- **Costi di avviamento nel carrello**: riga separata (una per personalizzazione) o ripartiti nel prezzo al pezzo. Vale per le nuove personalizzazioni.
- **Regola fiscale dei costi**: imposta del prodotto dei costi.
- **Gruppo di attributi delle taglie**: lascia il rilevamento automatico se il gruppo si chiama Taglia, Size, Taille, Größe, ecc.
- **Dimensione massima del file** e **tipi accettati**. Il limite effettivo è vincolato dalla configurazione PHP del server (upload_max_filesize, post_max_size); compare un avviso se il tuo valore è superiore.
- **File obbligatorio**: senza questa opzione il cliente può ordinare e inviare il file più tardi.
- **Personalizzazione con testo**: caratteri proposti e colori del testo (uno per riga, formato Nome=#hex).
- **Dopo l'ordine**: flusso bozze nell'account cliente, termine dei promemoria automatici, stati d'ordine automatici, email di notifica del laboratorio.

## Tecniche e tabelle prezzi

Ogni tecnica ha:

- una **tabella dei prezzi al pezzo IVA esclusa**: una riga per fascia di quantità («da 10», «da 25»...) e una colonna per numero di colori;
- una **quantità minima** (per esempio 10 pezzi in serigrafia);
- una **modalità dei costi di avviamento**: per colore (telai), per grafica (programmazione del ricamo, file di taglio) o nessuno;
- una **tabella dei costi** a scalare in base alla quantità.

La quantità considerata è il totale di tutte le taglie e i colori del prodotto nella personalizzazione. I prezzi si inseriscono IVA esclusa nella valuta predefinita e vengono convertiti automaticamente.

## Posizioni di stampa

Una posizione ha un nome, un lato (fronte o retro), una collocazione nell'anteprima, una dimensione massima di stampa in millimetri, un supplemento facoltativo al pezzo e l'elenco delle tecniche consentite (nessuna spuntata significa tutte). Posizionala con il mouse nell'editor: trascina il rettangolo, e il suo angolo per ridimensionarlo.

L'opzione **Personalizzazione con testo** permette al cliente di scrivere lo stesso testo per tutti i pezzi o una riga per pezzo (nomi e numeri), al posto di un file o in aggiunta.

## Prodotti e categorie

La personalizzazione si attiva tramite regole, per prodotto o per categoria. Una regola prodotto prevale sulle regole categoria, e una regola prodotto inattiva disattiva la personalizzazione per quel prodotto. Per ogni regola:

- **Forma del capo**: t-shirt, felpa con cappuccio, shopper o cappellino;
- **Personalizzazione obbligatoria**: nasconde il pulsante nativo del carrello, il cliente passa sempre dal blocco di personalizzazione;
- **Posizioni e tecniche offerte**: restringi l'elenco se serve;
- **Anteprima**: sagoma nel colore della combinazione oppure foto del prodotto.

### Anteprima con foto e calibrazione delle zone

In modalità foto, indica la posizione della foto frontale e di quella del retro nell'ordine delle immagini del prodotto (0 mantiene la sagoma per il retro). Le immagini associate a una combinazione hanno la precedenza, quindi ogni colore mostra la sua foto. Poi posiziona ogni zona sulla foto nell'editor; per una regola categoria scegli un prodotto di esempio fotografato come gli altri.

## Il percorso del cliente

1. Inserisce le quantità per taglia. Gli altri colori già inseriti restano elencati in «Anche in questo ordine».
2. Spunta una o più posizioni, sceglie tecnica e numero di colori e consulta i prezzi per fascia.
3. Invia il file con il pulsante o trascinandolo, poi sposta e ridimensiona il logo sull'anteprima. Un indicatore di risoluzione segnala un file troppo debole per la dimensione di stampa.
4. Il riepilogo mostra capi, personalizzazione, costi e totale, con l'invito alla fascia successiva. Può **scaricare un preventivo** o **aggiungere al carrello**.

Vengono considerati gli sconti quantità nativi del prodotto e i pezzi già nel carrello. Se lo stesso file è già nel carrello su un altro prodotto, nella stessa posizione con la stessa tecnica e lo stesso numero di colori, la fascia si calcola sul totale e i costi di avviamento si addebitano una sola volta.

## Carrello, ordine e fattura

Ogni riga di taglia e colore riporta il prezzo della personalizzazione al pezzo e il suo riepilogo. La riga dei costi di avviamento è bloccata a un'unità e non si può rimuovere da sola; sparisce con la personalizzazione. Se al prodotto si applica una promozione percentuale, il modulo compensa perché la stampa resti al prezzo della tua tabella.

## Dopo l'ordine: file, bozze e stati

Ogni personalizzazione ordinata segue uno stato: file in attesa, file ricevuto, bozza da approvare, modifiche richieste, bozza approvata, in produzione, completato.

- **Lato cliente**: dal dettaglio dell'ordine o dal link sicuro ricevuto via email (valido anche per gli ospiti), invia un file mancante, apre la bozza, la approva o chiede modifiche con un commento, e può riordinare la stessa personalizzazione con un clic.
- **Lato negozio**: il pannello **Personalizzazione tessile** della pagina ordine mostra anteprima, ripartizione per taglia, file, indicazioni e cronologia. Da lì invii la bozza (immagine o PDF) e cambi lo stato, con email facoltativa al cliente.
- **Promemoria**: un'email di promemoria parte una volta quando una bozza o un file è in attesa da oltre il termine scelto. Girano sul traffico del negozio; puoi anche richiamare l'URL cron indicato nelle Impostazioni.
- **Stato dell'ordine**: scegli lo stato PrestaShop da applicare quando tutte le personalizzazioni sono in produzione e poi completate.

## Scheda Produzione e scheda di laboratorio

La scheda **Produzione** elenca tutte le personalizzazioni ordinate, per urgenza, con filtri per stato e ricerca per ordine, cliente o prodotto. Seleziona più righe per cambiarne lo stato in una volta o stamparne le schede. La **scheda di laboratorio** riporta anteprima, ripartizione per taglia con caselle, posizioni, miniatura del file, indicazioni ed elenco dei nomi. Gli elenchi di nomi si esportano anche in CSV dall'ordine.

## Risoluzione dei problemi

- **Il blocco non compare**: verifica che una regola attiva copra il prodotto e che sia offerta almeno una posizione e una tecnica attive.
- **Le taglie non vengono rilevate**: scegli il gruppo di attributi delle taglie nelle Impostazioni.
- **L'invio di un file fallisce**: confronta la dimensione del file con il limite indicato; se serve, aumenta upload_max_filesize e post_max_size presso il tuo hosting.
- **Le modifiche ai template non compaiono dopo un aggiornamento**: svuota la cache in **Parametri avanzati > Prestazioni**.
- **Un impiegato non può inviare una bozza**: servono i permessi di modifica sugli ordini o sul modulo.
