Documentação para o shortcode woof_products_ids_prediction do plugin HUSKY - referência técnica com exemplos de código ---

woof_products_ids_prediction

O shortcode [woof_products_ids_prediction] é um invólucro especializado em torno de [woof_products], projetado para prever quais IDs de produto corresponderão ao estado atual do filtro. É útil para configurações baseadas em AJAX onde você precisa saber o conjunto de produtos filtrados antes da renderização.

Como Funciona

Internamente, este shortcode chama o mesmo método woof_products() com o sinalizador is_prediction definido como true. A única diferença de comportamento é que per_page assume o valor padrão de 9999 no modo de previsão — o que significa que ele retorna todos os produtos correspondentes por padrão, útil para obter o conjunto completo de IDs de produto.

Atributos

Suporta todos os atributos de [woof_products]:

Atributo	Padrão	Descrição
columns	Padrão do WooCommerce	Número de colunas de produtos
orderby	no	Ordenar por campo (no = usar configurações do WooCommerce, price, price-desc, date, title, etc.)
order	no	Ordem de classificação (ASC, DESC, ou no para padrão)
page	1	Número da página para paginação
per_page	9999*	Produtos por página. No modo de previsão, o padrão é 9999 (todos os produtos). Use um número específico se precisar de resultados paginados.
is_ajax	0	Ativar modo AJAX (1 ou 0)
taxonomies	''	Filtrar por taxonomias. Formato: product_cat:9,12+locations:30,31 (o sinal de mais separa diferentes taxonomias)
sid	''	ID de busca para identificar instâncias de filtro específicas
behavior	''	Comportamento especial (por exemplo, recent para produtos recentes)
custom_tpl	''	Caminho para um arquivo de template personalizado (por exemplo, wp-content/themes/my_theme/woo_tpl_1.php)
tpl_index	''	Índice de qualquer extensão de template
predict_ids_and_continue	false	Prever IDs e continuar com a consulta completa de produtos
get_args_only	false	Quando true, retorna apenas os argumentos da WP_Query sem executar a consulta
product_ids	''	Lista de IDs de produtos específicos separados por vírgula para exibir
post__in	''	Lista de IDs de posts separados por vírgula para incluir
display_on_search	0	Defina como 1 para mostrar produtos apenas quando uma busca/filtro estiver ativo

* No modo de previsão (woof_products_ids_prediction), per_page assume o valor padrão de 9999. No shortcode regular [woof_products], o padrão é 0 (usa as configurações do plugin).

Uso Básico

[woof_products_ids_prediction]

Retorna todos os IDs de produto que correspondem ao estado atual do filtro.

Uso com Taxonomias

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

Retorna os IDs dos produtos nas categorias 15 e 17, ordenados por preço crescente.

Uso com AJAX

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

Mostra produtos no modo AJAX, 12 por página, apenas quando um filtro está ativo. No modo de previsão, isso ajuda a pré-carregar o conjunto de resultados esperado.

Obtendo Apenas Argumentos de Consulta

[woof_products_ids_prediction get_args_only="true"]

Retorna apenas os argumentos da WP_Query como um array em vez de executar a consulta — útil para integrações personalizadas avançadas onde você deseja inspecionar ou modificar a consulta antes de executá-la.

Integração PHP / Hooks

Você pode filtrar a consulta de produtos usando os hooks padrão do WooCommerce e HUSKY. Por exemplo, para modificar os argumentos da consulta:

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

Quando Usar woof_products_ids_prediction vs [woof_products]

• Use [woof_products] quando quiser exibir produtos com filtragem.
• Use [woof_products_ids_prediction] quando precisar prever quais produtos corresponderão — por exemplo, para pré-carregar dados de produtos, atualizar um contador ou preparar consultas relacionadas antes da renderização.
• O modo de previsão assume o padrão de buscar todos os produtos correspondentes (per_page=9999), tornando-o ideal para obter o conjunto completo de IDs de produto.