Documentation pour le shortcode HUSKY plugin woof_products_ids_prediction - référence technique avec exemples de code ---

woof_products_ids_prediction

Le shortcode [woof_products_ids_prediction] est un wrapper spécialisé autour de [woof_products] conçu pour prédire quels IDs de produit correspondront à l'état actuel du filtre. Il est utile pour les configurations basées sur AJAX où vous avez besoin de connaître l'ensemble des produits filtrés avant le rendu.

Fonctionnement

En interne, ce shortcode appelle la même méthode woof_products() avec le flag is_prediction défini sur true. La seule différence de comportement est que per_page est par défaut à 9999 en mode prédiction — ce qui signifie qu'il renvoie tous les produits correspondants par défaut, ce qui est utile pour obtenir l'ensemble complet des IDs de produit.

Attributs

Prend en charge tous les attributs de [woof_products] :

Attribut	Défaut	Description
columns	Défaut WooCommerce	Nombre de colonnes de produits
orderby	no	Champ de tri (no = utiliser les réglages WooCommerce, price, price-desc, date, title, etc.)
order	no	Ordre de tri (ASC, DESC, ou no pour le défaut)
page	1	Numéro de page pour la pagination
per_page	9999*	Produits par page. En mode prédiction, la valeur par défaut est 9999 (tous les produits). Utilisez un nombre spécifique si vous avez besoin de résultats paginés.
is_ajax	0	Activer le mode AJAX (1 ou 0)
taxonomies	''	Filtrer par taxonomies. Format : product_cat:9,12+locations:30,31 (le signe plus sépare les différentes taxonomies)
sid	''	ID de recherche pour identifier des instances de filtre spécifiques
behavior	''	Comportement spécial (par exemple, recent pour les produits récents)
custom_tpl	''	Chemin vers un fichier de template personnalisé (par exemple, wp-content/themes/my_theme/woo_tpl_1.php)
tpl_index	''	Index de toute extension de template
predict_ids_and_continue	false	Prédire les IDs et continuer avec la requête complète des produits
get_args_only	false	Lorsque true, renvoie uniquement les arguments WP_Query sans exécuter la requête
product_ids	''	Liste d'IDs de produits spécifiques séparés par des virgules à afficher
post__in	''	Liste d'IDs de posts séparés par des virgules à inclure
display_on_search	0	Définir à 1 pour afficher les produits uniquement lorsqu'une recherche/un filtre est actif

* En mode prédiction (woof_products_ids_prediction), per_page est par défaut à 9999. Dans le shortcode [woof_products] régulier, il est par défaut à 0 (utilise les réglages du plugin).

Utilisation de base

[woof_products_ids_prediction]

Renvoie tous les IDs de produit correspondant à l'état actuel du filtre.

Utilisation avec les Taxonomies

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

Renvoie les IDs des produits des catégories 15 et 17, triés par prix croissant.

Utilisation avec AJAX

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

Affiche les produits en mode AJAX, 12 par page, uniquement lorsqu'un filtre est actif. En mode prédiction, cela aide à précharger l'ensemble de résultats attendu.

Obtenir uniquement les arguments de requête

[woof_products_ids_prediction get_args_only="true"]

Renvoie uniquement les arguments WP_Query sous forme de tableau au lieu d'exécuter la requête — utile pour les intégrations personnalisées avancées où vous souhaitez inspecter ou modifier la requête avant de l'exécuter.

Intégration PHP / Hooks

Vous pouvez filtrer la requête des produits en utilisant les hooks standard de WooCommerce et HUSKY. Par exemple, pour modifier les arguments de la requête :

add_filter('woof_draw_products_get_args', function($args) {
    // Modifier les arguments de la requête avant l'exécution
    $args['post_type'] = array('product', 'product_variation');
    return $args;
});

Quand utiliser woof_products_ids_prediction vs [woof_products]

• Utilisez [woof_products] lorsque vous souhaitez afficher des produits avec filtrage.
• Utilisez [woof_products_ids_prediction] lorsque vous avez besoin de prédire quels produits correspondront — par exemple, pour précharger des données de produit, mettre à jour un compteur ou préparer des requêtes associées avant le rendu.
• Le mode prédiction récupère par défaut tous les produits correspondants (per_page=9999), ce qui le rend idéal pour obtenir l'ensemble complet des IDs de produit.