[woof_products_ids_prediction]
Il shortcode [woof_products_ids_prediction] è un wrapper specializzato attorno a [woof_products] progettato per prevedere quali ID di prodotto corrisponderanno allo stato corrente del filtro. È utile per configurazioni basate su AJAX dove è necessario conoscere l'insieme dei 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 è impostato automaticamente a 9999 in modalità di previsione — il che significa che restituisce tutti i prodotti corrispondenti per impostazione predefinita, utile per ottenere l'insieme completo di ID prodotto.
Attributi
Supporta tutti gli attributi di [woof_products]:
| Attributo | Predefinito | Descrizione |
|---|---|---|
columns | WooCommerce default | Numero di colonne di prodotto |
orderby | no | Campo di ordinamento (no = usa le impostazioni di WooCommerce, price, price-desc, date, title, ecc.) |
order | no | Ordine di ordinamento (ASC, DESC, o no per l'impostazione predefinita) |
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 diverse tassonomie) |
sid | '' | ID di ricerca per identificare istanze specifiche del filtro |
behavior | '' | Comportamento speciale (ad es., recent per prodotti recenti) |
custom_tpl | '' | Percorso per un file modello personalizzato (ad es., wp-content/themes/my_theme/woo_tpl_1.php) |
tpl_index | '' | Indice di qualsiasi estensione del modello |
predict_ids_and_continue | false | Prevedi ID e prosegui 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 separato da virgole di ID prodotto specifici da mostrare |
post__in | '' | Elenco separato da virgole di ID post da includere |
display_on_search | 0 | Imposta a 1 per mostrare i prodotti solo quando una ricerca/filtro è attivo |
* In modalità di previsione (woof_products_ids_prediction), per_page è impostato automaticamente a 9999. Nel shortcode normale [woof_products], il valore predefinito è 0 (utilizza le impostazioni del plugin).
Utilizzo Base
[woof_products_ids_prediction]
Restituisce tutti gli ID prodotto corrispondenti allo stato corrente 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 dove si desidera ispezionare o modificare la query prima di eseguirla.
Integrazione PHP / Hook
Puoi filtrare la query dei prodotti utilizzando gli hook standard 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 desideri mostrare i prodotti con filtro. - Usa
[woof_products_ids_prediction]quando è necessario 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 è impostata automaticamente per recuperare tutti i prodotti corrispondenti (per_page=9999), rendendola ideale per ottenere l'insieme completo di ID prodotto.