🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir os Glossaries do JetEngine que não populam campos select no WordPress

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Campo Select do glossário do JetEngine fica vazio EN: JetEngine glossary Select field returns no options
Severidade Atenção
Descrição No JetEngine, Glossaries que alimentam um campo Select ficam vazios quando a opção Get options from the glossary está desligada, quando nenhum glossário foi selecionado como fonte ou quando o glossário não tem valores no formato Title + Value, deixando o Select sem opções no editor e no frontend.

O que é Glossary do JetEngine que não popula o campo Select?

No JetEngine, Glossaries são listas no formato Title + Value que alimentam um campo Select, Radio ou Checkbox usado como fonte das opções; criadas manualmente ou importadas de arquivo, elas evitam digitar opção por opção em cada meta field. Você monta o glossário uma vez e reaproveita a mesma lista em vários campos, segundo a documentação do Crocoblock. O campo é configurado em JetEngine, na aba Meta Fields do Post Type, do Custom Content Type, do meta box ou da Options Page.

O problema aparece quando esse campo Select deixa de mostrar as opções: ele renderiza vazio no editor do post e no frontend, ou exibe só o item placeholder sem nenhum valor selecionável. A causa raiz quase sempre está na ligação entre o campo e o glossário, e não em um bug do plugin. A documentação oficial do JetEngine deixa claro que o Select só busca os itens do glossário quando o controle Get options from the glossary está ativado e um glossário válido é escolhido na lista; sem isso, o campo não tem de onde puxar as opções.

Como identificar

  • O campo Select abre vazio no editor do post, sem nenhuma opção além do item placeholder, mesmo com o glossário já criado em JetEngine.
  • No formulário do JetFormBuilder ou no meta field, o Select aparece, mas a lista de valores fica em branco para quem preenche.
  • A opção ‘Get options from the glossary’ não está marcada na configuração do meta field, e o campo mostra apenas o que foi digitado manualmente (nada, quando nada foi digitado).
  • O glossário existe em JetEngine mas está sem linhas no formato Title + Value, então o Select não tem itens para listar.
  • Depois de importar um arquivo de glossário, o Select continua vazio porque o campo ainda aponta para outro glossário ou para nenhum.
Antes de começar: Antes de reimportar glossários, trocar o Field type de meta fields existentes ou editar Post Types em produção, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, pois mudar o tipo de um campo já em uso pode afetar os valores salvos nos posts.

Como prevenir

  • Crie e preencha o glossário com os pares Title + Value antes de ligar a opção Get options from the glossary em qualquer campo Select.
  • Padronize um glossário central por conjunto de opções e reaproveite a mesma fonte nos vários meta fields, evitando listas manuais duplicadas que ficam desatualizadas.
  • Nunca exclua ou renomeie um glossário sem antes verificar quais meta fields o usam como fonte, para não quebrar a referência do Select.
  • Após importar um glossário de arquivo, confira no painel se as linhas Title + Value foram realmente gravadas antes de apontar um campo para ele.

Causa

  • A opção 'Get options from the glossary' do meta field está desligada: sem esse toggle ativo, o campo Select ignora o glossário e usa apenas a lista manual de opções, que está vazia.
  • O toggle 'Get options from the glossary' está ativo, mas nenhum glossário foi escolhido no seletor de fonte do campo, então não há lista de Title + Value para o Select carregar.
  • O glossário selecionado existe mas não tem nenhuma linha preenchida no formato Title + Value, ou foi salvo sem valores após uma importação de arquivo malsucedida, deixando o Select sem itens.
  • O meta field foi criado com Object type ou Field type diferente de Select, Radio ou Checkbox, que são os únicos tipos que aceitam glossário como fonte de dados segundo a doc do JetEngine.
  • O campo aponta para um glossário que foi renomeado ou excluído depois de configurado, quebrando a referência entre o Select e a fonte de opções.

Como resolver

  1. Confirme que o glossário tem valores no formato Title + Value: Em JetEngine, abra a área de Glossaries e confirme que o glossário usado pelo campo tem pelo menos uma linha com Title e Value preenchidos. Um glossário vazio faz o Select renderizar sem opções, então adicione os pares ou reimporte o arquivo antes de seguir.
    Painel WP -> JetEngine -> Glossaries
    Abra o glossário e confirme as linhas no formato Title + Value
    Adicione manualmente ou reimporte o arquivo se a lista estiver vazia
  2. Ative a opção Get options from the glossary no meta field: Abra o meta field do tipo Select e ative o controle Get options from the glossary. Com o toggle desligado o campo usa apenas a lista manual de opções e ignora o glossário, o que deixa o Select vazio quando não há opções digitadas.
    Painel WP -> JetEngine -> Post Types (ou CCT/Meta Box/Options Page)
    Abra o item e vá até a aba Meta Fields, edite o campo Select
    Ligue o toggle 'Get options from the glossary'
  3. Selecione o glossário correto como fonte do campo: Com o toggle ativo, surge o seletor de glossário. Escolha nele o glossário que contém os valores desejados. Se nenhum glossário for selecionado, o Select continua sem itens mesmo com o toggle ligado.
    No campo Select, abra o seletor de glossário exibido sob 'Get options from the glossary'
    Escolha o glossário com os valores Title + Value
    Salve o Post Type ou o Custom Content Type
  4. Confirme o tipo de campo aceito pelo glossário: Verifique se o Field type do meta field é Select, Radio ou Checkbox, os únicos que aceitam glossário como fonte segundo a documentação do JetEngine. Se estiver em outro tipo, troque o Field type e configure a fonte novamente.
    Painel WP -> JetEngine -> Post Types -> aba Meta Fields
    Confirme o Field type como Select, Radio ou Checkbox
    Reaplique 'Get options from the glossary' após trocar o tipo
  5. Salve, limpe o cache e recarregue o editor: Depois de salvar a configuração, limpe qualquer cache de objeto ou de página e recarregue o editor do post. O Select deve listar os valores do glossário tanto no editor quanto no frontend após a atualização.
    Salve o Post Type / CCT / Options Page no JetEngine
    Limpe o cache de objeto e de página do site
    Recarregue o editor do post e confira o campo Select
PHP
<?php
/**
 * Garante que o glossario do JetEngine usado por um campo Select
 * tenha valores antes de o campo tentar renderizar as opcoes.
 * Use quando os pares Title + Value sao montados dinamicamente.
 */
add_filter( 'jet-engine/glossaries/data/fields', 'full_jetengine_fill_glossary', 10, 2 );
function full_jetengine_fill_glossary( $options, $glossary_id ) {
    // Aplica somente ao glossario alvo (ajuste o ID conforme o seu).
    if ( 'estados-br' !== $glossary_id ) {
        return $options;
    }
    // Se o glossario veio vazio, injeta pares Title => Value dinamicos.
    if ( empty( $options ) ) {
        $options = array(
            'SP' => 'São Paulo',
            'RJ' => 'Rio de Janeiro',
            'MG' => 'Minas Gerais',
        );
    }
    return $options;
}

Perguntas frequentes

Por que meu campo Select do JetEngine fica vazio mesmo com o glossário criado
Na maioria dos casos a opção Get options from the glossary está desligada no meta field ou nenhum glossário foi escolhido como fonte. Ative o toggle no campo Select e selecione o glossário que contém os valores no formato Title + Value para o campo listar as opções.
Quais tipos de campo do JetEngine aceitam glossário como fonte de opções
Segundo a documentação do JetEngine, os tipos Select, Radio e Checkbox podem usar um glossário como fonte de dados. Outros tipos de campo não exibem a opção de puxar valores do glossário, então o Select precisa estar em um desses três tipos.
Onde fica a opção Get options from the glossary no JetEngine
Ela aparece na configuração do meta field, dentro da aba Meta Fields do Post Type, do Custom Content Type, do meta box ou da Options Page. Edite o campo Select e ative o toggle Get options from the glossary para liberar o seletor do glossário.
Importei um glossário por arquivo e o Select continua sem opções
Verifique se as linhas Title + Value foram realmente gravadas no glossário e se o campo Select aponta para esse glossário, e não para outro. Uma importação parcial deixa o glossário sem valores, e o Select não tem itens para mostrar.
O que é o formato Title + Value de um glossário do JetEngine
O glossário do JetEngine é uma lista no formato Title + Value, em que o Title é o texto exibido na opção e o Value é o dado salvo no banco. Você cria essas linhas manualmente ou importa de um arquivo, e os campos Select as usam como opções.
Posso reaproveitar o mesmo glossário em vários campos Select
Sim. O glossário foi pensado para ser criado uma vez e reutilizado como fonte de opções em vários meta fields do tipo Select, Radio ou Checkbox. Basta ativar Get options from the glossary em cada campo e apontar para o mesmo glossário.
Preciso de código para popular um Select com um glossário do JetEngine
Não para o uso padrão: a ligação é feita pela interface do JetEngine ativando Get options from the glossary e escolhendo o glossário. Código só é necessário para popular valores via filtro quando você precisa montar a lista por PHP de forma dinâmica.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes