1. Home
  2. iThink
  3. WordPress
  4. Prova virtuale dei capi su WooCommerce: il mio plugin AI
WordPress

Prova virtuale dei capi su WooCommerce: il mio plugin AI

Scheda prodotto di uno store demo: abito midi bordeaux a 89,00 euro con il riquadro Carica la tua foto tra le miniature
Immagine: Rocco Balzamà · immagine dimostrativa · Immagine del titolare

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.

Jeans da uomo indaco a gamba dritta, fotografati da soli su fondo grigio chiaro
Gli stessi jeans indaco indossati da un uomo in piedi con maglietta beige e scarpe bianche, su fondo grigio chiaro
Prima e dopo, jeans indaco. A sinistra il capo da catalogo, a destra lo stesso capo indossato. Immagine dimostrativa, non un output misurato del plugin.

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.

  1. 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.
  2. 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.
  3. 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.
  4. Router. Una sola funzione decide quale motore usare per quel prodotto.
  5. 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 .htaccess non 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.

Condividi LinkedIn Facebook X WhatsApp Telegram Email
Cybersecurity per PMI

Quanto è esposta la tua azienda?

Un hacker etico certificato trova le falle prima di chi attacca e ti dice come chiuderle, partendo dalla più pericolosa.

Marketing & Google Ads

Le tue campagne stanno bruciando budget?

Raccontami obiettivi e numeri attuali: ti dico dove intervenire per primo.

Coding & debugging

Codice scritto con l’AI? Funziona oggi. Reggerà domani?

Audit del debito tecnico e della sicurezza di app e siti, debugging e code review.

iLife · crescita personale

Riprogramma la tua vita con il metodo di un hacker etico

Percorsi one-to-one per capire dove sei, scegliere la direzione e arrivarci con metodo.

Digital Agency

Dove sta frenando il tuo business?

Una consulenza per capire cosa sistemare prima: sicurezza, tecnologia, marketing o persone.

Continua a leggere

Tutti gli articoli del blog

Rocco Balzamà
Parli direttamente con me

Il prossimo passo?
Parliamone.

Raccontami cosa vuoi proteggere, costruire o far crescere. Ti aiuto a capire da dove partire.

Di cosa mi occupo

Da oltre trent'anni faccio tre cose. Cerco le falle della tua azienda prima che le trovi chi vuole entrare. Imposto il marketing perché i risultati si possano misurare. E aiuto persone e aziende a capire chi sono, prima ancora di decidere cosa vendere.

Da remoto e in presenzaLavoro da remoto tramite call e videocall. Quando il progetto lo richiede, intervengo anche in presenza.
Seguimi sui social
Certified Ethical HackerSicurezza informatica dal 1993
Gli strumenti con cui lavoro
  • Google Ads
  • Meta
  • WordPress
  • WooCommerce
  • Shopify
  • TikTok
Strumenti gratuiti