Se vendi abbigliamento online conosci la scena: il cliente guarda la foto di un abito su una modella, prova a immaginarlo addosso a sé, ordina due taglie e ne rimanda indietro una. A volte le rimanda tutte e due. La prova virtuale dei capi prova a chiudere quella distanza: il cliente carica una sua foto e vede il capo del negozio indossato sulla propria immagine. Ho scritto un plugin per WooCommerce che fa questo, WooAvatar AI, ancora in sviluppo. Ti racconto come l'ho costruito e cosa ho imparato correggendolo.
Perché la prova virtuale dei capi mi interessa
In negozio il camerino risolve il dubbio in due minuti. Online il dubbio resta aperto fino a quando arriva il pacco, e se la risposta è «no» il costo lo paghi tu: spedizione di ritorno, controllo del capo, rimessa in magazzino.
Non ho numeri miei su quanto un'anteprima riduca i resi e non te ne propongo di presi a caso: lo misurerò nel collaudo. Qui ti parlo della parte tecnica, dove questi strumenti di solito si rompono: la foto di una persona è un dato delicato e le chiamate ai servizi di intelligenza artificiale costano.
Ecco il risultato a cui punta, con un paio di jeans da uomo. Trascina la linea, o usa il cursore sotto la foto con le frecce della tastiera.


Come l'ho costruita, passo per passo
Il plugin aggiunge alla scheda prodotto un riquadro «Carica la tua foto». Da lì il percorso è sempre lo stesso.
- Upload. La foto arriva a un endpoint REST, viene controllata, ridimensionata a 2048 pixel al massimo e ricodificata. Sono ammessi JPG, PNG e WebP fino a 5 MB, valore che il negozio può portare fra 1 e 20.
- Consenso. Il cliente spunta una casella che elenca i fornitori a cui andrà la sua foto, con il link all'informativa. Il server ricontrolla: senza consenso la richiesta si ferma con un errore 403.
- Coda. La generazione non avviene mentre il cliente aspetta dentro la richiesta. Entra in una coda gestita da WP-Cron che gira ogni 60 secondi e prende tre richieste per volta.
- Router. Una sola funzione decide quale motore usare per quel prodotto.
- Risultato. L'immagine generata viene salvata, la foto di partenza cancellata, e l'anteprima segue il prodotto nel carrello e poi nell'ordine.
Il punto 4 è il cuore del progetto. I motori sono due. Per i capi indossabili uso il try-on di FASHN, il modello tryon-v1.6 (documentazione dell'API): riceve la tua foto e l'immagine del capo e lavora sulla zona del capo, quindi la persona e il viso restano quelli della foto. Per tutti gli altri prodotti resta il motore con cui il plugin era nato, che genera un avatar con OpenAI o Stability AI.
Ti dico subito la differenza vera fra i due. Con l'avatar e DALL-E 3, il modello predefinito, l'immagine nasce da un testo: il tuo viso non c'è. Gemini e Claude, se li scegli, servono solo a migliorare quel testo. Se vuoi vedere il capo addosso a te, serve il try-on.
Decidi tu prodotto per prodotto: try-on, avatar o automatico, che manda al try-on le categorie indossabili. Se manca la chiave di FASHN il cliente riceve un errore chiaro, senza ripieghi silenziosi sull'altro motore.
Tutti i dettagli tecnici, con il diagramma del flusso, le classi e i limiti, li trovi nella pagina del progetto WooAvatar AI.
Cosa ho imparato correggendola
Rileggendo riga per riga la 1.2.0, quella che aveva introdotto il try-on, ho trovato problemi che l'avrebbero fermata al primo uso. La 1.2.1 li chiude, e tre lezioni valgono per qualunque plugin tu stia valutando.
La foto del cliente non è un'immagine qualsiasi
Prima la foto finiva nella libreria media, con un indirizzo pubblico. Ora sta in una cartella privata con un nome casuale, il browser non riceve mai il suo indirizzo e il file viene cancellato dopo la generazione, anche quando la generazione fallisce del tutto. Una pulizia giornaliera toglie gli upload abbandonati da più di un giorno. Le anteprime generate restano 30 giorni e il registro 7, valori che puoi cambiare. Con gli strumenti privacy di WordPress esporti o cancelli i dati di un cliente partendo dalla sua email.
C'era anche un difetto più grave, un IDOR: conoscendo il numero di un'anteprima si leggeva quella di un altro. Ora ogni accesso, fino al carrello e all'ordine, verifica il proprietario.
Il consenso deve dire la verità
Il testo del consenso della 1.2.0 nominava solo FASHN, ma la foto poteva finire anche al fornitore dell'avatar. Un consenso che non dice a chi va la foto non serve a molto. Adesso il testo elenca i fornitori reali per quel prodotto. Una cosa però il plugin non la può fare al posto tuo: gli accordi sul trattamento dei dati con ciascun fornitore e l'informativa del sito restano a carico del negozio. Non ti dirò che installando un plugin sei in regola.
La coda deve sapere chi sta lavorando
Se due processi prendono la stessa richiesta, paghi due chiamate per un'immagine sola. Ho aggiunto un lock e la presa atomica di ogni elemento, con tre tentativi a cinque minuti di distanza. Ho messo anche dei tetti per ogni cliente: 20 upload all'ora, 10 generazioni all'ora e 50 al giorno. Chi non ha un account viene contato per indirizzo IP, così non aggira il limite cancellando un cookie. Un limite per tutto il negozio c'è, ma è spento di base: il budget delle chiamate si decide insieme al negozio.
Il resto erano errori bloccanti, come sintassi di PHP 8 in un plugin per PHP 7.4 e un controllo che scartava quasi tutte le foto. Li verifica un banco di prova in PHP che simula WordPress: 61 controlli, tutti superati, che non sostituiscono un sito vero.
Consigli pratici ed errori da evitare prima di attivare la prova virtuale
Prima di attivare questo plugin o uno simile, ti consiglio questi controlli:
- Chiedi dove finisce la foto. In quale cartella, per quanto tempo, e se il suo indirizzo è pubblico.
- Leggi il testo del consenso. Deve nominare i fornitori a cui la foto viene inviata, e il server deve rifiutare la richiesta senza consenso.
- Decidi il budget delle chiamate. Ogni generazione è una chiamata a pagamento: servono limiti per cliente e, se vuoi, un tetto giornaliero per tutto il negozio.
- Controlla il tuo hosting. Su Nginx la protezione di una cartella con
.htaccessnon funziona; dietro un proxy tutti gli ospiti possono avere lo stesso IP; su un sito con poche visite WP-Cron parte in ritardo e conviene un cron di sistema. - Prova come ospite. Fai tutto il percorso, dalla foto all'ordine, senza essere registrato.
Sono gli stessi controlli che applico quando sviluppo plugin WordPress su misura, e in parte gli stessi che ho descritto parlando di AI dentro WordPress con i permessi giusti.
Domande frequenti
Il cliente deve registrarsi per provare un capo?
No. Chi non ha un account viene riconosciuto da un cookie del plugin e ha gli stessi limiti di chi è registrato, contati per indirizzo IP.
La foto del cliente resta sul mio sito?
La foto di partenza sta in una cartella privata con un nome casuale e viene cancellata dopo la generazione, anche se la generazione fallisce. Le anteprime generate restano 30 giorni, un valore che puoi cambiare.
Funziona con tutti i prodotti?
Il try-on con FASHN è pensato per i capi indossabili e decidi tu prodotto per prodotto. Per gli altri prodotti il plugin genera un avatar, che però nasce da un testo e non mostra il viso del cliente.
Quanto costa ogni prova?
Dipende dal fornitore e dal piano che scegli con lui: ogni generazione è una chiamata a pagamento. Il plugin ti aiuta a tenerla sotto controllo con i limiti per cliente e, se vuoi, con un tetto giornaliero per tutto il negozio.
A che punto è il progetto
Il codice della 1.2.1 è corretto e testato in isolamento, ma non l'ho ancora collaudato su un WordPress reale. Restano da verificare il percorso completo di un cliente senza account, il checkout a blocchi, i parametri attuali dell'API di FASHN, la protezione della cartella privata su Nginx, l'IP dietro proxy, WP-Cron sui siti con poco traffico e il file delle traduzioni da rigenerare. Finché non sono chiusi non è pronto per la produzione, e non ti so dire quanto impiega una generazione: dipende dal fornitore.
Nella pagina del progetto oltre ai jeans trovi anche il confronto con un abito da donna. Sono immagini dimostrative che mostrano il risultato atteso, non output misurati del plugin. I primi test reali li pubblicherò lì.
Hai un e-commerce di moda?
Cerco negozi con cui fare il primo collaudo vero. Se vendi abbigliamento su WooCommerce e vuoi provare la prova virtuale sul tuo catalogo, scrivimi: raccontami che cosa vendi e su quale hosting gira il sito. Ti dico cosa serve, quali verifiche facciamo prima di accendere qualcosa e cosa devi sistemare su informativa e fornitori.






