Documentation for HUSKY plugin shortcode woof_products_ids_prediction - technical reference with code examples ---

woof_products_ids_prediction

Lo shortcode [woof_products_ids_prediction] è un wrapper specializzato attorno a [woof_products], progettato per prevedere quali ID di prodotto corrisponderanno allo stato attuale del filtro. È utile per configurazioni basate su AJAX in cui è necessario conoscere il set di prodotti filtrati prima del rendering.

Come Funziona

Internamente, questo shortcode chiama lo stesso metodo woof_products() con il flag is_prediction impostato su true. L'unica differenza comportamentale è che per_page di default è 9999 in modalità di previsione — il che significa che restituisce tutti i prodotti corrispondenti per impostazione predefinita, utile per ottenere il set completo di ID di prodotto.

Attributi

Supporta tutti gli attributi di [woof_products]:

Attributo	Predefinito	Descrizione
columns	Predefinito WooCommerce	Numero di colonne di prodotto
orderby	no	Ordina per campo (no = usa le impostazioni di WooCommerce, price, price-desc, date, title, ecc.)
order	no	Ordine di smistamento (ASC, DESC, o no per predefinito)
page	1	Numero di pagina per la paginazione
per_page	9999*	Prodotti per pagina. In modalità di previsione il valore predefinito è 9999 (tutti i prodotti). Usa un numero specifico se hai bisogno di risultati paginati.
is_ajax	0	Abilita la modalità AJAX (1 o 0)
taxonomies	''	Filtra per tassonomie. Formato: product_cat:9,12+locations:30,31 (il segno più separa tassonomie diverse)
sid	''	ID di ricerca per identificare istanze di filtro specifiche
behavior	''	Comportamento speciale (es. recent per prodotti recenti)
custom_tpl	''	Percorso di un file di template personalizzato (es. wp-content/themes/my_theme/woo_tpl_1.php)
tpl_index	''	Indice di qualsiasi estensione di template
predict_ids_and_continue	false	Prevedi gli ID e continua con la query completa dei prodotti
get_args_only	false	Quando true, restituisce solo gli argomenti di WP_Query senza eseguire la query
product_ids	''	Elenco di ID di prodotto specifici separati da virgole da visualizzare
post__in	''	Elenco di ID di post separati da virgole da includere
display_on_search	0	Imposta su 1 per mostrare i prodotti solo quando una ricerca/filtro è attiva

* In modalità di previsione (woof_products_ids_prediction), per_page di default è 9999. Nello shortcode regolare [woof_products], di default è 0 (usa le impostazioni del plugin).

Utilizzo Base

[woof_products_ids_prediction]

Restituisce tutti gli ID di prodotto che corrispondono allo stato attuale del filtro.

Utilizzo con le Tassonomie

[woof_products_ids_prediction taxonomies="product_cat:15,17" orderby="price" order="ASC"]

Restituisce gli ID dei prodotti nelle categorie 15 e 17, ordinati per prezzo crescente.

Utilizzo con AJAX

[woof_products_ids_prediction is_ajax="1" per_page="12" display_on_search="1"]

Mostra i prodotti in modalità AJAX, 12 per pagina, solo quando un filtro è attivo. In modalità di previsione, questo aiuta a precaricare il set di risultati atteso.

Ottenere Solo gli Argomenti della Query

[woof_products_ids_prediction get_args_only="true"]

Restituisce solo gli argomenti di WP_Query come array invece di eseguire la query — utile per integrazioni personalizzate avanzate in cui si desidera ispezionare o modificare la query prima di eseguirla.

Integrazione PHP / Hooks

È possibile filtrare la query dei prodotti utilizzando gli standard hooks di WooCommerce e HUSKY. Ad esempio, per modificare gli argomenti della query:

add_filter('woof_draw_products_get_args', function($args) {
    // Modify query arguments before execution
    $args['post_type'] = array('product', 'product_variation');
    return $args;
});

Quando Usare woof_products_ids_prediction vs [woof_products]

• Usa [woof_products] quando vuoi visualizzare i prodotti con il filtraggio.
• Usa [woof_products_ids_prediction] quando hai bisogno di prevedere quali prodotti corrisponderanno — ad esempio, per precaricare i dati dei prodotti, aggiornare un contatore o preparare query correlate prima del rendering.
• La modalità di previsione di default recupera tutti i prodotti corrispondenti (per_page=9999), rendendola ideale per ottenere il set completo di ID di prodotto.