Come funziona Prism Conditional Product Options
Un cliente vuole una scatola in tre colori, un nome da incidere e un logo da caricare.
Le varianti di WooCommerce possono gestire tutto questo? Da sole no.
Le varianti combinano attributi come taglia e colore. Per un campo di testo, un file allegato o un campo che compare solo a certe condizioni serve un plugin opzioni prodotto WooCommerce, cioè un’estensione che aggiunge campi alla pagina prodotto e porta le scelte del cliente fino all’ordine.
Quello che ho scritto io si chiama Prism Conditional Product Options, lo trovi su WordPress.org e qui ti spiego come funziona davvero, pezzo per pezzo.
Varianti e opzioni prodotto sono due strumenti diversi
Una variante di WooCommerce è una combinazione di attributi, per esempio taglia M e colore blu, con prezzo, SKU e magazzino propri. Una opzione prodotto è una scelta in più che non crea un prodotto diverso: il testo da incidere, il file con il logo, la confezione regalo con la sua maggiorazione.
Se vendi magliette in cinque taglie, le varianti native bastano e non devi installare niente. Il problema nasce quando la scelta del cliente non è un prodotto ma un’istruzione per chi prepara l’ordine.
Prism affianca le varianti native, non le sostituisce. Su un prodotto variabile i campi compaiono dopo che il cliente ha scelto la variante. Il nome “libreria varianti” nel menu può confondere: dentro ci sono gruppi di opzioni da riutilizzare.
Cosa fa Prism, voce per voce
- Tipi di campo: menu a tendina, scelta singola, scelta multipla, testo breve, testo lungo, data e caricamento file.
- Swatch: immagini o colori cliccabili. Per le opzioni senza immagine basta un colore esadecimale, e puoi decidere quanti elementi mostrare per riga, fino a 12 su desktop e 8 su mobile. Il nome sotto l’immagine si può nascondere.
- Maggiorazioni e sconti per ogni opzione, con un totale stimato nella pagina prodotto che si aggiorna mentre il cliente sceglie e segue la variante selezionata. Le maggiorazioni si sommano anche ai prezzi calcolati da altri plugin.
- Disponibilità impostabile per singola opzione.
- Campi condizionali: un campo appare solo se è selezionata un’altra opzione.
- Quantità minima e multipli per prodotto. La quantità minima è sempre un multiplo dello step.
- Limiti di caratteri sui campi di testo. Dove non li imposti, i testi si fermano a 5.000 caratteri.
- Upload di file con controllo del contenuto sul server.
Dove si creano le opzioni: libreria o singolo prodotto
Hai due strade, e la scelta dipende da quante volte ti serve lo stesso gruppo.
Libreria varianti: definisci un gruppo una volta e lo riutilizzi su più prodotti, con la disponibilità inclusa. È la strada giusta quando cinquanta prodotti condividono gli stessi colori o la stessa personalizzazione, perché una modifica si fa in un posto solo.
Box “Custom product options” nella scheda prodotto: per le opzioni che valgono per un prodotto soltanto. Qui aggiungi i campi, li riordini trascinandoli e imposti quantità minima e multipli.
Ogni gruppo ha un codice che puoi personalizzare. Il codice resta stabile anche se rinomini il gruppo, ed è quello che userai negli shortcode.
Nel pannello Product Options trovi anche la scheda Panoramica, con l’avvio rapido e l’elenco degli shortcode.
Come funzionano i campi condizionali
La regola è una sola: un campo compare solo se il cliente ha selezionato un’altra opzione.
Un esempio. Il gruppo ha una scelta singola con “Standard” e “Personalizzato”. Il campo per caricare il logo è collegato a “Personalizzato”: chi sceglie “Standard” non lo vede, chi sceglie “Personalizzato” lo trova e lo compila. Il modulo resta corto per chi non ha bisogno di niente in più e completo per chi sì.
Il cliente vede solo i campi che lo riguardano, e tu non devi mettere in ogni scheda prodotto un campo “solo se ti serve”.
Posizionare i campi dove vuoi: shortcode ed Elementor
Di default i campi compaiono sopra la quantità. Sui prodotti variabili compaiono dopo la scelta della variante. Se il tuo template ha un layout diverso, attivi l’interruttore “I place the fields with shortcodes” nella libreria varianti e li inserisci a mano:
[wcpo_group codice="..."]mostra un gruppo tramite il suo codice[wcpo_group nome="..."]mostra un gruppo per nome, ed è il metodo più vecchio[wcpo_campi]mostra tutti i gruppi del prodotto[wcpo_totale]mostra solo il totale stimato[wcpo_varianti]mostra la scelta delle varianti (taglia, colore e simili) in un punto a tua scelta
Fuori dal template del prodotto aggiungi id="..." con l’ID del prodotto. Sui prodotti variabili puoi usare posizione="varianti". Se lo stesso gruppo compare due volte nella stessa pagina, viene mostrato una volta sola.
Per chi costruisce le pagine con Elementor c’è un dettaglio utile. Sui prodotti senza opzioni la pagina riceve la classe wcpo-no-options, mentre la classe wcpo-solo-opzioni nasconde gli elementi che devono comparire solo sui prodotti con opzioni, per esempio un blocco di istruzioni sulla personalizzazione.
Cosa succede dopo “Aggiungi al carrello”
Le scelte del cliente non si perdono per strada. Scelte, maggiorazioni e file caricati seguono il prodotto nel carrello, al checkout, nell’ordine e nelle email, dove i titoli delle opzioni sono in grassetto.
Con “Ordina di nuovo” il plugin ripristina scelte e file dell’ordine precedente. È comodo per chi riordina lo stesso prodotto personalizzato.
Il plugin dichiara la compatibilità con HPOS, l’archiviazione ordini ad alte prestazioni di WooCommerce, e si integra con gli strumenti di esportazione e cancellazione dei dati personali di WordPress.
Dove finiscono i file caricati dai clienti
Qui arriva la parte che spesso viene data per scontata. Un campo di upload mette sul tuo server file che arrivano da sconosciuti, e il rischio è doppio: file pericolosi in ingresso, file privati raggiungibili da chiunque abbia il link.
Prism lavora così:
- i file finiscono in
wp-content/uploads/wcpo-private/, con nomi casuali; - si scaricano solo dal carrello del cliente, con la chiave dell’ordine o da chi gestisce gli ordini;
- il contenuto del file viene controllato sul server;
- sono accettati anche AI, EPS e PSD, mentre gli SVG non sono ammessi;
- ogni indirizzo IP può caricare 30 file all’ora (filtro
wcpo_upload_limit) e la cartella ha un tetto di 2.048 MB (filtrowcpo_upload_quota_mb); - i file dei carrelli abbandonati vengono eliminati dopo 14 giorni.
I file di un ordine restano fino alla cancellazione definitiva dell’ordine o a una richiesta di cancellazione dei dati. Puoi attivare la cancellazione automatica dopo un numero di giorni dal completamento dell’ordine, ma è disattivata di default e un file eliminato non si recupera. Il nome del file resta visibile.
Niente panico per la parte server, ma va controllata. Su Apache la protezione della cartella passa da un file .htaccess e funziona nella maggior parte dei casi. Su nginx, o su Apache con AllowOverride impostato su None, la protezione manca. Il plugin ti segnala quando la cartella privata risulta raggiungibile dall’esterno. Su nginx la regola da aggiungere al server block è questa:
location ^~ /wp-content/uploads/wcpo-private/ { deny all; }
Se non hai accesso alla configurazione del server, questa è una cosa da far fare a chi lo gestisce. Se ti serve una mano, rientra nell’assistenza WordPress.
Se il tuo sito è dietro un proxy o un CDN, il filtro wcpo_upload_client_ip permette al plugin di leggere l’IP reale del cliente, così il limite orario non scatta sull’IP del proxy.
Requisiti, compatibilità e limiti attuali
- WordPress 6.2 o superiore, testato fino alla 7.1.4 (versione 4.0 del plugin)
- PHP 7.4 o superiore
- WooCommerce installato e attivo prima del plugin
- interfaccia in inglese e in italiano
- codice open source consultabile su Trac e SVN, supporto sul forum di WordPress.org
Poi la parte meno brillante: il plugin ha meno di dieci installazioni attive e nessuna recensione. Il progetto è giovane, e preferisco dirtelo io prima che lo scopra tu. Provalo su un sito di test prima di metterlo in produzione, come faresti con qualsiasi plugin che tocca il checkout.
Quando Prism non ti serve
Se i tuoi prodotti hanno solo taglia e colore, le varianti di WooCommerce fanno già tutto. Un plugin in più è un componente da aggiornare e da tenere d’occhio.
Prism comincia a servire quando la scelta del cliente cambia il modo in cui prepari l’ordine: un testo, un file, un’opzione che compare solo se ne scegli un’altra, una quantità minima che non vuoi ricordare a voce. Se stai impostando un negozio da zero, queste decisioni vanno prese prima di costruire le schede prodotto, e il momento giusto è la fase di progetto del sito e-commerce.
Puoi scaricarlo e leggere le note di versione sulla pagina del plugin su WordPress.org.
Conclusione
Le varianti dicono a WooCommerce cosa vendi. Le opzioni dicono a te cosa devi fare con quell’ordine, e il lavoro di un buon plugin sta tutto lì: far arrivare quell’istruzione dal cliente a chi prepara l’ordine senza che nessuno debba scrivere una mail per chiederla.