JetEngine erro taxonomia: corrigir no editor do WordPress

Tipo Page Builders

Nome do erro Erro de taxonomia no JetEngine EN: JetEngine taxonomy not working

Severidade Atenção

Descrição O erro de taxonomia no JetEngine acontece quando a taxonomia registrada na aba Taxonomies não aparece no menu, não fica disponível no post type vinculado ou retorna 404, geralmente por opções de visibilidade desligadas, slug invalido ou regras de reescrita não atualizadas.

O que é erro de taxonomia no JetEngine?

A taxonomia no JetEngine e criada na aba JetEngine > Taxonomies do painel, onde você define o Taxonomy Name, o Taxonomy Slug e o Post Type ao qual ela será anexada. Diferente de registrar a taxonomia por código, o JetEngine grava a configuração no banco e a registra no WordPress a cada carregamento; quando alguma opção crítica esta desligada, a taxonomia existe internamente mas não aparece para o editor.

O erro se manifesta de três formas principais: a taxonomia não surge no menu do painel, ela não aparece na tela de edição do post type vinculado, ou as URLs de arquivo de termo retornam 404. Segundo a documentação oficial do Crocoblock, as opções Show Admin UI e Show in Admin Menu controlam justamente a exibicao da taxonomia no painel, e o Taxonomy Slug so aceita letras latinas, números e os caracteres – ou _. Quando uma dessas condicoes e violada, a integração quebra mesmo com a taxonomia salva.

Como identificar

A taxonomia criada na aba JetEngine > Taxonomies não aparece no menu lateral do painel do WordPress.
Ao editar um post do tipo vinculado, a caixa da taxonomia (lateral ou abaixo do editor) não aparece para adicionar termos.
Ao acessar a URL de arquivo de um termo, o WordPress retorna ‘Page not found’ (erro 404).
Os termos adicionados não salvam ou somem após recarregar a tela de edição do post.
A taxonomia não aparece como filtro no Query Builder, no JetSmartFilters ou no Listing Grid mesmo após ser criada.

Antes de começar: Antes de renomear slugs de taxonomia ou alterar registros em producao, faça backup do site (arquivos e banco de dados) ou teste em um ambiente de staging. Mudar um slug já indexado pode quebrar URLs publicas e exigir redirecionamentos.

Como prevenir

Ao criar a taxonomia no JetEngine, já ative Show Admin UI, Show in Admin Menu e Show in REST API para garantir que ela apareça no painel e no editor de blocos.
Defina o Taxonomy Slug usando apenas letras latinas minusculas, números e – ou _, evitando espacos, acentos e maiusculas que quebram o registro.
Sempre que criar ou alterar uma taxonomia, atualize os Links Permanentes para regravar as regras de reescrita e evitar 404 nas URLs de termo.
Padronize uma convencao de slugs e mantenha uma lista das taxonomias ativas para evitar que dois plugins registrem o mesmo slug e gerem conflito.

Causa

As opções Show Admin UI e Show in Admin Menu da taxonomia estão desligadas na aba JetEngine > Taxonomies, entao a taxonomia e registrada mas não aparece no menu nem na tela de edição do post.
O campo Post Type da taxonomia não foi marcado, ou foi vinculado a um post type diferente do que você esta editando, deixando a caixa de termos fora da tela do editor.
O Taxonomy Slug contem caracteres invalidos (espacos, acentos ou maiusculas): a doc do JetEngine permite apenas letras latinas, números e os caracteres - ou _, e um slug fora dessa regra impede o registro correto.
As regras de reescrita (permalinks) não foram atualizadas depois de criar a taxonomia, fazendo a URL de arquivo de termo retornar 404 até o flush das rewrite rules.
A opção Show in REST API esta desligada, entao a taxonomia não aparece no editor de blocos Gutenberg, no Query Builder ou em integracoes que dependem do REST.
Outro plugin ou um registro manual via código declara uma taxonomia com o mesmo slug, gerando conflito de registro e sobrescrevendo a configuração do JetEngine.

Como resolver

Ative a visibilidade da taxonomia no painel: Abra a taxonomia que não aparece e ligue as opções de exibicao. Sem Show Admin UI a taxonomia não surge na tela de edição, e sem Show in Admin Menu ela não aparece no menu lateral do painel.
```
Painel WP -> JetEngine -> Taxonomies -> abra a taxonomia com erro
Ative a opção Show Admin UI
Ative a opção Show in Admin Menu
Clique em Add/Update Taxonomy para salvar
```
Confirme o Post Type vinculado: Na mesma tela da taxonomia, verifique o campo Post Type. A taxonomia precisa estar marcada para o tipo de post que você esta editando, senao a caixa de termos não aparece no editor daquele conteúdo.
```
Painel WP -> JetEngine -> Taxonomies -> abra a taxonomia
No campo Post Type, marque o tipo de post correto (ex.: Post, Página ou um CPT do JetEngine)
Clique em Add/Update Taxonomy
```
Corrija o Taxonomy Slug: Verifique o Taxonomy Slug: a documentação do JetEngine so aceita letras latinas, números e os caracteres - ou _. Remova espacos, acentos e maiusculas para garantir o registro correto da taxonomia.
```
Painel WP -> JetEngine -> Taxonomies -> abra a taxonomia
Ajuste o Taxonomy Slug para letras minusculas, números e - ou _ (ex.: 'categoria-imovel')
Clique em Add/Update Taxonomy
```
Atualize as regras de permalink: Se as URLs de arquivo de termo retornam 404, atualize as regras de reescrita. Apenas abrir a tela de Links Permanentes e salvar já faz o WordPress regravar as rewrite rules e reconhecer as novas URLs da taxonomia.
```
Painel WP -> Configurações -> Links Permanentes
Sem alterar nada, clique em Salvar alterações para forçar o flush das rewrite rules
```
Habilite o REST e teste isolando conflitos: Ative Show in REST API para a taxonomia funcionar no editor de blocos e no Query Builder. Se ainda falhar, procure outra taxonomia com o mesmo slug registrada por plugin ou código e renomeie uma delas para eliminar o conflito.
```
Painel WP -> JetEngine -> Taxonomies -> abra a taxonomia -> ative Show in REST API
Clique em Add/Update Taxonomy
Procure registros duplicados do mesmo slug em outros plugins ou no functions.php e renomeie um deles
```

PHP

<?php
// Forca o flush das rewrite rules uma unica vez apos criar/editar
// uma taxonomia do JetEngine, corrigindo URLs de termo que retornam 404.
add_action( 'init', 'full_flush_jetengine_taxonomy_rules', 99 );
function full_flush_jetengine_taxonomy_rules() {
    if ( get_option( 'full_jetengine_tax_flushed' ) ) {
        return;
    }
    flush_rewrite_rules( false );
    update_option( 'full_jetengine_tax_flushed', 1 );
}

Perguntas frequentes

Por que a taxonomia do JetEngine não aparece no menu do painel

Quase sempre as opções Show Admin UI e Show in Admin Menu estão desligadas. Abra a taxonomia em JetEngine > Taxonomies, ative as duas e salve com Add/Update Taxonomy para ela voltar ao menu e a tela de edição.

Por que a taxonomia não aparece ao editar o post

O campo Post Type da taxonomia provavelmente não esta marcado para o tipo de post que você edita. Abra a taxonomia, selecione o post type correto e salve. A caixa de termos so surge no editor do tipo vinculado.

Quais caracteres o Taxonomy Slug do JetEngine aceita

Segundo a documentação do Crocoblock, o Taxonomy Slug aceita apenas letras latinas, números e os caracteres - ou _. Espacos, acentos e maiusculas quebram o registro, entao use sempre minusculas sem acento.

Por que a URL do termo da taxonomia retorna 404

As regras de reescrita não foram atualizadas após criar a taxonomia. Va em Configurações > Links Permanentes e clique em Salvar alterações sem mudar nada: isso regrava as rewrite rules e a URL do termo passa a funcionar.

A taxonomia precisa de Show in REST API ligado

Sim, se você usa o editor de blocos Gutenberg, o Query Builder ou o JetSmartFilters. Com Show in REST API desligado a taxonomia não aparece nessas integracoes mesmo estando registrada e visivel no painel classico.

Posso ter duas taxonomias com o mesmo slug

Não. Dois registros com o mesmo slug, um pelo JetEngine e outro por plugin ou código, geram conflito e um sobrescreve o outro. Renomeie uma das taxonomias para que cada slug seja único no site.

Preciso registrar a taxonomia por código se uso o JetEngine

Não. O JetEngine registra a taxonomia a partir da configuração salva na aba Taxonomies. Código so e necessário para casos avancados, como forçar o flush das rewrite rules ou ajustar argumentos que a interface não expõe.

Atenção

Como corrigir o conflito de Meta Boxes entre ACF PRO e JetEngine no WordPress

O conflito de meta boxes entre ACF PRO e JetEngine acontece quando os dois plugins registram grupos de campos para o mesmo tipo de post e gravam na mesma meta key, gerando caixas duplicadas no editor, valores sobrescritos e campos que parecem não salvar.

Informativo

Como corrigir os estilos do WPForms que não aplicam com o Astra Pro no WordPress

Quando o estilo do WPForms não aplica com o Astra Pro, o formulário aparece sem CSS porque a opção Include Form Styling esta em No styling, o CSS do tema vence por especificidade, ou o cache combinou e removeu a folha de estilo do WPForms.

Atenção

Como corrigir custom fields do JetEngine que não exibem em cursos do Tutor LMS no WordPress

O custom field do JetEngine não exibe em cursos do Tutor LMS quando a Meta Box não esta atribuida ao post type courses ou quando o Dynamic Field aponta para um object context diferente do curso, deixando o meta field vazio na página renderizada pelo Tutor.

Grave

Como corrigir o editor do Elementor que não carrega

Quando o editor do Elementor não carrega, ele trava na barra de carregamento ou abre em branco. A causa quase sempre é limite de memória/PHP baixo demais para o site ou um conflito com outro plugin (cache ou minificação de JavaScript).

Grave

Como corrigir widgets do Happy Addons que não carregam no editor Elementor

Quando os widgets do Happy Addons não carregam no editor Elementor, o painel de elementos abre sem a seção Happy, em geral porque o recurso foi desligado no Feature Controller, porque o Elementor esta abaixo da versão 3.7.0 exigida, ou porque um erro de JavaScript no editor interrompe o registro dos widgets.

Atenção

Como corrigir o JetCompareWishlist que não adiciona produtos no WordPress

O JetCompareWishlist não adiciona produto quando o botão Comparar ou Lista de Desejos é colocado fora de um loop de produtos, quando as páginas de comparação e de lista não estão definidas nas configurações, ou quando o cache, um conflito de JavaScript ou cookies bloqueados impedem a requisição AJAX que salva o item.

Setores

Extensões

Integrações

Como corrigir o erro de taxonomia no JetEngine

O que é erro de taxonomia no JetEngine?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o conflito de Meta Boxes entre ACF PRO e JetEngine no WordPress

Como corrigir os estilos do WPForms que não aplicam com o Astra Pro no WordPress

Como corrigir custom fields do JetEngine que não exibem em cursos do Tutor LMS no WordPress

Como corrigir o editor do Elementor que não carrega

Como corrigir widgets do Happy Addons que não carregam no editor Elementor

Como corrigir o JetCompareWishlist que não adiciona produtos no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos