[woof_products_ids_prediction]

O shortcode [woof_products_ids_prediction] é um wrapper especializado em torno de [woof_products] projetado para prever quais IDs de produtos corresponderão ao estado atual do filtro. É útil para configurações orientadas por AJAX onde você precisa saber o conjunto de produtos filtrados antes de renderizar.

Como Funciona

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

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`	Campo de ordenação (`no` = usar configurações do WooCommerce, `price`, `price-desc`, `date`, `title`, etc.)
`order`	`no`	Ordem de classificação (`ASC`, `DESC`, ou `no` para o 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`	Habilitar 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 (ex.: `recent` para produtos recentes)
`custom_tpl`	`''`	Caminho para um arquivo de modelo personalizado (ex.: `wp-content/themes/my_theme/woo_tpl_1.php`)
`tpl_index`	`''`	Índice de qualquer extensão de modelo
`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 do WP_Query sem executar a consulta
`product_ids`	`''`	Lista separada por vírgulas de IDs de produtos específicos para exibir
`post__in`	`''`	Lista separada por vírgulas de IDs de posts 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 padrão é 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 produtos que correspondem ao estado atual do filtro.

Uso com Taxonomias


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

Retorna IDs de 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 da Consulta


[woof_products_ids_prediction get_args_only="true"]

Retorna apenas os argumentos do 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 você deseja exibir produtos com filtragem.
Use [woof_products_ids_prediction] quando você precisa prever quais produtos corresponderão — por exemplo, para pré-carregar dados de produtos, atualizar um contador ou preparar consultas relacionadas antes de renderizar.
O modo de previsão padrão busca todos os produtos correspondentes (per_page=9999), tornando-o ideal para obter o conjunto completo de IDs de produtos.