Il filtro WooCommerce per taglia mostra varianti esaurite: come risolvere
Un cliente seleziona la taglia M e il filtro WooCommerce per taglia mostra una maglietta la cui variante M è esaurita. Nella pagina del prodotto compare che la taglia è terminata e il cliente se ne va. Il filtro non è rotto: per impostazione predefinita giudica un prodotto variabile in base al prodotto padre, esattamente come fa WooCommerce, e il padre resta disponibile finché lo è una qualsiasi delle sue varianti. Qui trovi perché il filtro mostra varianti esaurite, l'impostazione di HUSKY che gli fa controllare la disponibilità della taglia selezionata, le regole che questo controllo segue e che cosa correggere quando risultati o conteggi sono ancora sbagliati.
Perché il filtro per taglia mostra varianti esaurite
In WooCommerce un prodotto variabile è composto da due tipi di record. Il prodotto padre è ciò che le pagine del negozio e delle categorie elencano. La sua scheda Attributi (Attributes) contiene i valori (Taglia: S, M, L; Colore: nero, rosso), e questi valori sono associati al padre come termini di attributo. Ogni variante, come M / nero, è un record separato con un proprio prezzo e una propria disponibilità.
Un filtro per attributo cerca i prodotti padre che hanno il termine selezionato. Se la maglietta elenca M nella scheda Attributi (Attributes), corrisponde alla taglia M, qualunque sia la disponibilità della variante M. Nemmeno lo stato di disponibilità del padre aiuta: WooCommerce lo mantiene su Disponibile (In stock) finché almeno una variante è disponibile (o su Disponibile su ordinazione (On backorder) se una è in ordine arretrato) e lo porta su Esaurito (Out of stock) solo quando tutte le varianti sono esaurite. Per lo stesso motivo non risolve il problema nemmeno l'opzione di WooCommerce Nascondi gli articoli esauriti dal catalogo (Hide out of stock items from the catalog) (WooCommerce → Impostazioni → Prodotti → Inventario): nasconde la maglietta solo quando tutte le sue taglie sono finite. La domanda "la taglia M è disponibile?" va rivolta alle varianti, e il filtro la pone solo quando glielo dici.
Fai controllare a HUSKY la disponibilità della taglia selezionata
Il controllo delle varianti appartiene all'elemento In stock. In HUSKY 3.4.6 è un'estensione integrata sempre attiva, quindi non c'è nulla da attivare nella scheda Estensioni (Extensions).
- Apri WooCommerce → Impostazioni → Products Filter, scheda Struttura (Structure), e trova la riga Disponibile (In stock). Impostala su Sì (Yes) se i clienti devono vedere la casella di controllo.
- Fai clic sul pulsante a forma di ingranaggio accanto (opzioni aggiuntive (additional options)). Nella finestra che si apre, imposta la prima impostazione, Cerca nei prodotti variabili (Search in variable produts), su Cerca nei prodotti e nelle loro varianti (Search in products and their variations). Il valore predefinito, Solo prodotti semplici (Simple products only), considera soltanto lo stato di disponibilità proprio di ciascun prodotto, che per un prodotto variabile è quello del padre.
- Lascia Usa il nuovo DB (Use new DB.) su Sì (Yes) e scegli Casella di controllo (Checkbox) o Interruttore (Switcher) in Visualizzazione (View).
- Salva, svuota la cache delle pagine e prova: scegli una taglia che sai essere esaurita in un prodotto, seleziona Disponibile (In stock) e quel prodotto dovrebbe sparire dai risultati.
Il controllo viene eseguito solo mentre Disponibile (In stock) fa parte della ricerca ed è selezionato almeno un attributo del prodotto (una tassonomia pa_ come Taglia o Colore). Senza Disponibile (In stock), il filtraggio per attributo resta basato sul padre. L'impostazione comporta un lavoro aggiuntivo per il database, ed è per questo che è disattivata per impostazione predefinita; vedi la sezione sulla velocità più sotto.
Applicare Disponibile senza una casella di controllo
Se le taglie esaurite non devono mai corrispondere, non serve affidarsi al fatto che i clienti spuntino la casella. Il filtro woof_get_request_data può aggiungere la condizione di disponibilità a ogni ricerca eseguita dal plugin:
/*
* HUSKY: always search in-stock products only.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
$data['stock'] = 'instock';
return $data;
});
Questo rimuove anche i prodotti semplici esauriti e i prodotti variabili completamente esauriti da ogni elenco di prodotti controllato dal filtro, come descritto nella FAQ su come mostrare solo i prodotti disponibili. Imposta la riga Disponibile (In stock) su No, così i clienti non vedono una casella sempre selezionata.
Se i prodotti esauriti devono restare visibili mentre i clienti sfogliano il negozio e sparire solo quando filtrano per un attributo, aggiungi la condizione soltanto quando nella ricerca c'è un attributo:
/*
* HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
foreach (array_keys($data) as $key) {
if (strpos($key, 'pa_') === 0) {
$data['stock'] = 'instock';
break;
}
}
return $data;
});
Come decide il controllo delle varianti
Con Usa il nuovo DB (Use new DB.) impostato su Sì (Yes), HUSKY legge la tabella di lookup degli attributi dei prodotti di WooCommerce, in cui ogni variante ha una riga per ciascuno dei suoi valori di attributo insieme a un indicatore di disponibilità. Per ogni prodotto variabile raccoglie le varianti che hanno uno qualsiasi dei valori selezionati e rimuove il prodotto quando tali varianti esistono e nessuna di esse è disponibile. Questa regola spiega i risultati che a prima vista sembrano strani:
| Prodotto | Ricerca | Risultato |
|---|---|---|
| S disponibile, M esaurita | Taglia M + Disponibile | Nascosto |
| S disponibile, M esaurita | Taglia S o M + Disponibile | Mostrato: S è disponibile |
| M elencata nella scheda Attributi (Attributes), ma non esiste alcuna variante M | Taglia M + Disponibile | Mostrato: nessuna variante M può essere esaurita |
| Una variante impostata su Qualsiasi taglia (Any Size), disponibile | Taglia L + Disponibile | Mostrato: una variante Qualsiasi taglia (Any Size) vale per ogni taglia elencata nel prodotto |
| M / nero esaurita, M / rosso e S / nero disponibili | Taglia M + Colore nero + Disponibile | Mostrato: ogni valore selezionato ha una variante disponibile |
| Variante M Disponibile su ordinazione (On backorder) | Taglia M + Disponibile | Mostrato: l'ordine arretrato conta come disponibile |
La terza riga è un problema di dati, non del filtro. Un valore che resta nella scheda Attributi (Attributes) del padre dopo che ne hai eliminato la variante, o che non è mai stato usato per una variante, continua a corrispondere e a essere conteggiato. Mantieni solo i valori che hanno varianti, oppure crea la variante e contrassegnala come Esaurito (Out of stock).
Le ultime due righe sono i limiti del controllo. I valori di attributi diversi vengono verificati uno per uno, non come l'esatta combinazione scelta dal cliente, quindi un prodotto può comparire anche quando quella specifica combinazione è esaurita. Le varianti in ordine arretrato sono acquistabili, quindi Disponibile (In stock) le mantiene; se non devono corrispondere nemmeno loro, aggiungi l'elemento Exclude products on backorder, che ha la stessa impostazione Cerca nei prodotti e nelle loro varianti (Search in products and their variations). Controlla anche che cosa ha effettivamente scritto un'importazione: una variante salvata come Disponibile su ordinazione (On backorder) invece che Esaurito (Out of stock) resta nei risultati.
Risultati ancora sbagliati: aggiorna la tabella di lookup di WooCommerce
La tabella di lookup (wc_product_attributes_lookup) appartiene a WooCommerce. Viene aggiornata quando un prodotto o una variante viene salvato tramite WooCommerce, per impostazione predefinita con un breve ritardo: WooCommerce pianifica l'aggiornamento come azione in background. La tabella resta indietro quando:
- la disponibilità viene modificata da un'importazione o da uno strumento di sincronizzazione che scrive direttamente nel database invece di salvare i prodotti tramite WooCommerce;
- le azioni in background non vengono eseguite, per esempio perché WP-Cron è disattivato senza un cron del server che lo sostituisca. Le azioni in sospeso con l'hook
woocommerce_run_product_attribute_lookup_update_callbacksi accumulano allora in WooCommerce → Stato → Azioni pianificate; - una rigenerazione completa della tabella è stata interrotta.
Il filtro lavora quindi con dati di disponibilità vecchi e i risultati sembrano casuali. Per ricostruire la tabella, apri WooCommerce → Stato → Strumenti e fai clic su Rigenera (Regenerate) accanto a Rigenera la tabella di lookup degli attributi dei prodotti (Regenerate the product attributes lookup table). Viene eseguita in background a blocchi; finché non ha finito, il pulsante mostra Compilazione in corso (Filling in progress) con un contatore. La FAQ sui filtri per prezzo e disponibilità che non funzionano tratta gli stessi strumenti. Se la disponibilità cambia spesso, valuta WooCommerce → Impostazioni → Prodotti → Avanzate → Tabella di lookup degli attributi dei prodotti (Product attributes lookup table) → Aggiornamenti diretti (Direct updates), che aggiorna la tabella nel momento in cui un prodotto viene salvato.
Come prova, o quando non è possibile mantenere aggiornata la tabella, imposta Usa il nuovo DB (Use new DB.) su No. HUSKY legge allora le varianti stesse (i loro valori _stock_status e attribute_pa_…). È più lento con molte varianti e segue una regola più rigida: un prodotto viene rimosso quando una qualsiasi variante con un valore selezionato è esaurita, quindi "Taglia S o M" nasconde la maglietta della tabella precedente. Per ottenere la stessa regola della tabella di lookup, aggiungi:
/*
* HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
* one variation with a selected value is in stock.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_exclude_existing_variations', '__return_true');
Conteggi che includono varianti esaurite
I numeri accanto alle taglie provengono dalle stesse query dei risultati, quindi seguono le stesse regole.
- Senza Disponibile (In stock) nella ricerca, il conteggio per M include ogni prodotto che ha M nel padre, esaurito o no. Con Disponibile (In stock) attivo (selezionato, o forzato con lo snippet qui sopra) e la ricerca nelle varianti attiva, ogni taglia viene conteggiata con il controllo delle varianti per quella taglia.
- Aggiungi Riconteggio dinamico (Dynamic recount) e Nascondi i termini vuoti (Hide empty terms) (scheda Opzioni (Options)) e una taglia il cui conteggio scende a zero scompare dal filtro, così le taglie esaurite non vengono più proposte.
- Se WooCommerce nasconde gli articoli esauriti, mantieni Considera la visibilità nel catalogo (Listen catalog visibility) (Avanzate → Opzioni) su Sì (Yes). Con No, i contatori includono anche i prodotti che WooCommerce nasconde, e un termine può mostrare un conteggio mentre i suoi risultati sono vuoti.
- Con Memorizza nella cache il numero del riconteggio dinamico per ogni elemento del filtro (Cache dynamic recount number for each item in filter) (Avanzate → Opzioni), i conteggi vengono salvati e non seguono le variazioni di disponibilità finché la cache non viene pulita automaticamente o con il pulsante cancella cache (clear cache). Anche una cache delle pagine può servire numeri vecchi.
Velocità: il prezzo del controllo delle varianti
Ogni ricerca che combina un attributo con Disponibile (In stock) esegue query aggiuntive: due sulla tabella di lookup con Usa il nuovo DB (Use new DB.) su Sì (Yes), oppure una su tutte le varianti corrispondenti con No. Con il Riconteggio dinamico (Dynamic recount) il controllo viene eseguito anche per ogni valore che riceve un conteggio, quindi un filtro con 40 taglie e colori lo ripete 40 volte per pagina. Con decine di migliaia di varianti la differenza si nota.
- Mantieni Usa il nuovo DB (Use new DB.) su Sì (Yes) e la tabella di lookup aggiornata; è il metodo più veloce.
- Attiva Memorizza nella cache il numero del riconteggio dinamico per ogni elemento del filtro (Cache dynamic recount number for each item in filter) e scegli un intervallo di pulizia automatica adatto alla rapidità con cui cambia la tua disponibilità.
- Altre opzioni sono in come velocizzare il filtraggio dei prodotti nei cataloghi di grandi dimensioni.
La modalità Turbo non è una scorciatoia in questo caso. Filtra nel browser del visitatore a partire da un file precostruito e il suo controllo Disponibile (In stock) considera solo lo stato di disponibilità proprio di ciascun prodotto: l'impostazione delle varianti non ha alcun effetto e le variazioni di disponibilità compaiono solo dopo la ricostruzione del file. Se le taglie esaurite non devono corrispondere, tieni disattivata la modalità Turbo; gli altri suoi limiti sono elencati in risoluzione dei problemi della modalità Turbo.
Checklist
- Disponibile (In stock) → ingranaggio → Cerca nei prodotti e nelle loro varianti (Search in products and their variations) selezionato e salvato.
- Disponibile (In stock) fa parte della ricerca: selezionato dal cliente o forzato con
woof_get_request_data. - I prodotti variabili elencano solo i valori di attributo che hanno varianti.
- Le varianti esaurite hanno lo stato Esaurito (Out of stock), non Disponibile su ordinazione (On backorder).
- La tabella di lookup è stata rigenerata dopo le importazioni e nelle Azioni pianificate non ci sono aggiornamenti del lookup bloccati.
- Cache del riconteggio e cache delle pagine svuotate dopo le variazioni di disponibilità; modalità Turbo disattivata.
Se il filtro restituisce ancora un prodotto la cui taglia selezionata è esaurita, apri una discussione sul forum di supporto di HUSKY con il link del filtro, il prodotto e lo stato di disponibilità delle sue varianti.