# Como corrigir o widget Woo Product Grid no Essential Addons

O erro do Woo Product Grid no Essential Addons acontece quando o widget fica vazio, mostra a mensagem de nenhum produto encontrado ou quebra no Elementor porque o WooCommerce esta inativo, não ha produtos publicados que casem com a consulta, ou o elemento WooCommerce do Essential Addons não esta habilitado.

## O que é erro do Woo Product Grid no Essential Addons?

O Woo Product Grid e um widget WooCommerce do Essential Addons for Elementor que exibe produtos da loja em formato de grade, filtrando por categoria, tag ou atributo, com controles de colunas, paginação e ordenacao. Ele depende diretamente do WooCommerce ativo e de uma consulta (query) que retorne produtos publicados, porque renderiza a grade a partir do resultado dessa consulta.

O erro aparece quando essa cadeia se quebra: o widget some do painel do Elementor, exibe a mensagem de nenhum produto encontrado, fica em branco no editor ou no frontend, ou interrompe a edição da página. Segundo a documentação oficial do Essential Addons, se os produtos não aparecem, e preciso confirmar que o WooCommerce esta ativo e que existem produtos publicados com a categoria ou tag que casa com as configurações do widget.

## Como identificar

- O widget exibe a mensagem 'No products found' ou 'Nenhum produto encontrado' no lugar da grade de produtos.
- A área do Woo Product Grid fica totalmente em branco no editor do Elementor e também no frontend.
- O widget 'Woo Product Grid' não aparece no painel de widgets do Elementor ao buscar pelo nome.
- A página mostra 'This block has encountered an error' ou um aviso de elemento que não pode ser carregado onde deveria estar a grade.
- Os produtos aparecem no editor mas somem no frontend, ou a grade carrega so parte dos produtos esperados.

**Antes de começar:** Antes de regenerar arquivos do Elementor, mexer em plugins ou adicionar código no functions.php em producao, faca um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso a página quebre.

## Como prevenir

- Antes de publicar uma página com o Woo Product Grid, confirme que o WooCommerce esta ativo e que ha produtos publicados na categoria ou tag usada pelo widget.
- Padronize um produto de teste publicado em cada categoria filtrada, para a grade nunca renderizar vazia por falta de itens que casem com a consulta.
- Mantenha o Essential Addons, o Elementor e o WooCommerce atualizados juntos em staging antes de subir para producao, para acompanhar mudancas na renderizacao dos widgets WooCommerce.
- Sempre limpe o cache do Elementor e do plugin de cache após editar páginas com widgets dinâmicos, para o frontend não servir uma versão antiga da grade.

Erros relacionados

- [Como corrigir Elementor com widgets que não aparecem](https://full.services/wp-fixer/corrigir-elementor-widgets-nao-aparecem/)
- [Como corrigir CSS do Elementor que não aplica no frontend](https://full.services/wp-fixer/corrigir-elementor-css-nao-aplica/)
- [Como corrigir o editor do Elementor que não carrega](https://full.services/wp-fixer/corrigir-elementor-nao-carrega/)

## Causa

- O WooCommerce esta desativado ou não instalado: o Woo Product Grid e um widget de elementos WooCommerce e não tem produtos para consultar sem o plugin ativo, ficando vazio ou indisponivel.
- Não existem produtos publicados que casem com a consulta do widget: o filtro por categoria, tag ou atributo aponta para um termo sem produtos publicados, entao a query retorna zero itens e a grade fica vazia (verificacao indicada na doc oficial do Essential Addons).
- O elemento WooCommerce do Essential Addons esta desligado em Elementor -> Essential Addons -> Elements, o que impede o widget Woo Product Grid de aparecer no inserter do Elementor.
- O parametro de quantidade de produtos a exibir esta em zero ou a regra de ordenacao e paginação remove todos os itens da página atual, deixando a grade sem nada para renderizar.
- Um conflito de cache ou de JavaScript de outro plugin interrompe a renderizacao do widget no frontend, servindo HTML antigo ou travando o script do Elementor antes da grade montar.

## Como resolver

1. Confirme que o WooCommerce esta instalado e ativo: O Woo Product Grid consulta produtos do WooCommerce; sem o plugin ativo a grade fica vazia. Em Plugins, garanta que o WooCommerce esteja instalado e ativado antes de tudo.

```
Painel WP -> Plugins -> Plugins Instalados
Localize 'WooCommerce' e clique em Ativar caso esteja inativo
```

2. Garanta produtos publicados que casem com a consulta: A doc oficial do Essential Addons pede confirmar que existem produtos publicados com a categoria ou tag usada no widget. Crie ou publique produtos e revise a categoria ou tag filtrada no Woo Product Grid.

```
Painel WP -> Produtos -> confirme itens com status Publicado
Edite o widget Woo Product Grid -> aba Query -> ajuste Categoria/Tag para um termo que tenha produtos
```

3. Habilite o elemento WooCommerce no Essential Addons: Se o widget nem aparece no Elementor, o elemento WooCommerce do Essential Addons pode estar desligado. Ative o elemento na tela de Elements do plugin para o Woo Product Grid voltar ao inserter.

```
Painel WP -> Elementor -> Essential Addons -> aba Elements
Localize o grupo WooCommerce e ative o toggle do 'Woo Product Grid'
```

4. Revise quantidade, ordenacao e paginação do widget: Um número de produtos em zero ou uma página de paginação além dos itens disponiveis deixa a grade vazia. Ajuste a quantidade a exibir e volte a paginação para a primeira página.

```
Edite o widget -> aba Query -> defina 'Products Count' para um número maior que zero
Revise os controles de Order/OrderBy e a paginação para não filtrar todos os itens
```

5. Limpe cache e isole conflito de plugin: Se a grade aparece no editor mas falha no frontend, limpe o cache do Elementor e do plugin de cache e teste desativando outros plugins para achar o conflito de JavaScript que trava a renderizacao.

```
Painel WP -> Elementor -> Ferramentas -> Regenerar CSS e Dados
Limpe o cache do plugin de cache (ex.: WP Rocket -> Limpar cache)
Desative os demais plugins um a um e recarregue a página a cada teste
```


## Código

```php
<?php
// Garante que o Woo Product Grid so seja usado quando o WooCommerce estiver ativo.
// Cole no functions.php do tema-filho. Avisa no admin em vez de renderizar grade vazia.
add_action( 'admin_notices', 'full_check_woo_for_eael_grid' );
function full_check_woo_for_eael_grid() {
    if ( class_exists( 'WooCommerce' ) ) {
        return; // WooCommerce ativo: nada a fazer.
    }
    echo '<div class="notice notice-warning"><p>';
    echo 'O widget Woo Product Grid (Essential Addons) precisa do WooCommerce ativo para exibir produtos.';
    echo '</p></div>';
}
```

## Perguntas frequentes

### Por que o Woo Product Grid do Essential Addons aparece vazio

Na maioria dos casos o WooCommerce esta inativo ou não ha produtos publicados que casem com a categoria ou tag filtrada no widget. Ative o WooCommerce, publique produtos e ajuste a consulta do widget para um termo que tenha itens, como indica a doc oficial do Essential Addons.

### O Woo Product Grid funciona sem o WooCommerce instalado

Não. O Woo Product Grid e um widget de elementos WooCommerce e consulta produtos da loja; sem o WooCommerce ativo não ha o que renderizar e a grade fica vazia ou indisponivel no Elementor.

### Por que o widget Woo Product Grid não aparece no Elementor

O elemento WooCommerce do Essential Addons provavelmente esta desligado. Va em Elementor -> Essential Addons -> Elements, localize o grupo WooCommerce e ative o toggle do Woo Product Grid para ele voltar ao inserter de widgets.

### A grade mostra produtos no editor mas some no frontend, o que fazer

Quase sempre e cache. Regenere o CSS e dados do Elementor em Ferramentas e limpe o cache do plugin de cache. Se persistir, desative os demais plugins um a um para achar o conflito de JavaScript que trava a renderizacao.

### Por que aparece 'No products found' no Woo Product Grid

Essa mensagem indica que a consulta do widget retornou zero produtos. Revise o filtro de categoria, tag ou atributo e a quantidade a exibir, e confirme que existem produtos publicados que casam com essas regras.

### Posso filtrar os produtos do Woo Product Grid por categoria

Sim. O Woo Product Grid permite filtrar a exibicao por categoria, tag e atributo na aba de consulta do widget, além de definir colunas, ordenacao e quantidade de produtos, segundo a documentação oficial do Essential Addons.

### Como saber se o problema e do Essential Addons ou de outro plugin

Limpe o cache e depois desative os demais plugins um a um, recarregando a página a cada teste. Se a grade voltar ao normal, reative os plugins até identificar o que entra em conflito com a renderizacao do widget.

**Fonte:** [Essential Addons for Elementor — Woo Product Grid (documentacao oficial)](https://essential-addons.com/elementor/woo-product-grid/)