Visão Geral do widget Dynamic Field

Configurações da seção de conteúdo de campo dinâmico

Arraste e solte o widget Campo dinâmico na página e vejamos as configurações de conteúdo.

• Fonte . No menu suspenso, você pode ver uma lista de fontes disponíveis de onde os dados serão extraídos:
  • Dados pós-prazo/usuário/objeto . O conteúdo será extraído dos metacampos padrão da postagem, termo, usuário ou objeto. O campo pode ser especificado na seleção Campo do objeto ;
  • Metadados . Esta opção pegará o conteúdo de um dos metacampos criados por você usando a funcionalidade do plugin JetEngine. Você pode selecionar um campo concreto no menu suspenso Meta Campo ou defini-lo digitando a tecla Meta campo/repetidora personalizada ;
  • Variável de consulta . Ele pode ser usado para exibir dados na página Resultados da pesquisa. Para isso especifique o Nome da Variável – “s”; 
  • Opções . Esta variante permite que você escolha metacampos criados para a página de opções ;
  • Hierarquia de Relação . Os dados serão retirados dos campos dos posts relacionados ao atual. Você pode escolher que tipo de postagem obter e selecionar o tipo na lista suspensa Do tipo de postagem ;
  • Metadados de relação . Esta opção pega os dados dos metacampos criados para relações . Também temos um tutorial dedicado sobre a saída dinâmica das relações .

• Ícone de campo . Se quiser adicionar um ícone ao campo, aqui você pode escolhê-lo na biblioteca ou baixá-lo como um arquivo SVG;

• Etiqueta HTML . Este menu suspenso permite escolher as tags HTML nas quais o campo será agrupado. DIV é uma tag usada para definir contêineres, H1-H6 transforma o campo em um título, P define o campo como um parágrafo e SPAN o marca como uma parte embutida do documento;

• Ocultar se o valor estiver vazio . Ative esta opção se quiser ocultar o campo caso ele não esteja preenchido;
• Cair pra trás . Se você não quiser ocultar o campo se ele estiver vazio, nesta área de texto você pode definir qual texto mostrar ao usuário;

• Filtre a saída do campo . Este precisa de atenção extra, por isso iremos descrevê-lo mais adiante;
• Personalize a saída do campo . Ative esta opção para adicionar o texto antes e depois do valor extraído do metacampo; %s representa o valor extraído; basta adicionar algum conteúdo antes e depois para adicionar algum texto antes e depois do valor;

• Contexto . Este campo ajuda a especificar a origem do campo e colabora com a opção Fonte . De acordo com suas configurações, pode haver as seguintes opções:
  • Objeto padrão . Mostra dados da página atual ou modelo de listagem ;
  • Usuário Atual (global) . Mostra dados de acordo com o usuário para quem a página foi criada;
  • Usuário Atual (para escopo atual) . Mostra dados de acordo com o usuário que está processando no momento. Por exemplo, existe uma listagem de usuários que mostra as postagens escritas pelo usuário após clicar nelas. Nesse caso, se você escolher o contexto Usuário Atual (para escopo atual) , ele exibirá o valor do metacampo do usuário em que você acabou de clicar, não do usuário logado;
  • Usuário consultado . Mostra dados do usuário conectado no momento ou do usuário mencionado na URL (o ID do usuário está na URL);
  • Autor da postagem atual . Ele mostrará o valor do metacampo do usuário que é o autor da postagem aberta no momento;
  • Objeto padrão do WordPress (para a página atual) . Sempre mostra os dados de um objeto global atual para a página atual definida pelo WordPress. Por exemplo, em uma única página/post, será sempre o post atual, mesmo que você vá para a listagem adicionada a esta página;
  • Autor atual do item CCT . Mostra os dados no metacampo do usuário que é o autor do item CCT atualmente aberto. Pode ser usado no Listing Template para CCT para mostrar as informações sobre o autor do item CCT. Para saber mais sobre CCT, vá para o tutorial Como criar um tipo de conteúdo personalizado ;
  • Itens Relacionados de… Mostra os dados da relação criada. Para saber mais, navegue até o tutorial Saída Dinâmica de Relações .

” alt=”contexto de campo dinâmico” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/dynamic-field-context-2.png” />

Visão geral da saída do campo de filtro

Este recurso precisa de uma descrição detalhada. Habilitar a opção Filtrar saída do campo permite exibir diferentes tipos de dados. O widget Campo dinâmico pode ser usado para mostrar os dados, por exemplo, do metacampo Сheckbox. Para exibi-lo corretamente, você precisa usar este filtro.

” alt=”saída do campo de filtro” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/filter-field-output-2.png” />

Mostrar valor dos metacampos Data, Hora e Datahora como preferido

• Use o retorno de chamada Formatar data para mostrar a data extraída do banco de dados usando os metacampos Date , Time ou Datetime . No campo Formato você pode definir o formato da data;
• O formato data (localizada) é igual ao anterior mas mostra a data que já está localizada para o idioma do site;

” alt=”formato de retorno de chamada de data” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/format-date-callback-2.png” />

• Diferença de tempo legível por humanos . Este retorno de chamada funciona com os metacampos Data e Datahora . Mostra a diferença entre a data que você colocou no metacampo e a data atual. A diferença é exibida em dias. No campo Meta-chave adicional , você pode inserir outro nome de meta-campo, e esse retorno de chamada mostrará a diferença entre as datas nesses dois meta-campos. Por exemplo, você pode exibir a diferença entre a data de início e de término.

” alt=”diferença de tempo legível por humanos” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/human-redable-time-difference-2.png” />

Exibir títulos, links e URLs de postagens e termos

• Obtenha o título da postagem/página . Se você selecionar a opção “Post ID” em Object Field , esse retorno de chamada exibirá o título da postagem ou página;

” alt=”obter o título da postagem/página” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/get-post-or-page-title-2.png” />

• Obtenha o URL da postagem/página. Se você escolher uma das opções de ID no menu suspenso Campo do objeto , esse retorno de chamada exibirá o URL da postagem;

” alt=”obter URL da postagem/página” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/get-post-or-page-url-2.png” />

• Obtenha o link da postagem/página. Este retorno de chamada também mostrará o URL da postagem, mas na forma de um título com um link;

” alt=”obter link de postagem/página” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/get-post-or-page-link-2.png” />

• Obtenha a miniatura da postagem/página.   Se você selecionar a opção “Post ID” em Object Field , este retorno de chamada exibirá a imagem em destaque da postagem ou página. Você também pode definir o tamanho da imagem (completa, miniatura, média, etc.). Se você ativar a opção Adicionar link permanente , poderá prosseguir para a postagem ou página clicando na imagem;

• Obtenha o nome do termo.  Se você selecionar a opção “Term ID” em Object Field , este callback exibirá o título do termo;

• Obtenha o URL do termo. Se você selecionar a opção “Term ID” no Object Field, este callback exibirá o termo URL;

• Obtenha o link do termo . Esta opção só poderá ser usada se você selecionar o termo ou ID da taxonomia no menu suspenso Campo do objeto . Neste caso, será exibido o nome do termo com o link;

• Adicionar esquema de URL . Se você precisar usar um esquema de URL, por exemplo, para envio de e-mail, você pode usar este retorno de chamada e selecionar esquema de URL ;

” alt=”adicionar esquema de URL” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/add-url-scheme-2.png” />

• Incorporar URL . Use este retorno de chamada se você tiver um metacampo contendo um URL e quiser incorporá-lo na página. Por exemplo, funcionará se você quiser incorporar um vídeo do YouTube. Se quiser definir diferentes alturas de contêiner para o vídeo exibido, você pode mostrar o vídeo usando o código HTML ;

” alt=”incorporar URL” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/embed-url-2.png” />

• Torne clicável . Se você tiver um campo com URL, normalmente ele será mostrado como texto simples. E esse retorno de chamada tornará um link clicável.

” alt=”tornar clicável” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/make-clickable-callback-2.png” />

Formate os dados do metacampo Número

• Número do formato . Se quiser exibir os dados do metacampo Número , você pode definir seu formato usando este retorno de chamada. Você pode escolher a aparência da vírgula decimal e do separador de milhares e definir quantos números serão mostrados após a vírgula;

” alt=”formato de retorno de chamada de número” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/format-number-callback-2.png” />

• Zeroise (adicione zeros à esquerda) . Quando esse retorno de chamada está habilitado, ele adiciona zeros antes do valor do metacampo Número . No campo Limite , você pode inserir o número do dígito que não deve ter zeros adicionados. Por exemplo, eu defino o Limite “5” , então se o número tiver dois dígitos, três zeros serão adicionados a ele, e se o número tiver quatro dígitos, apenas um zero será adicionado;

” alt=”retorno de chamada zerado” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/zeroise-callback-2.png” />

• Proporcional . Este retorno de chamada funciona com o tipo de campo Número e calcula a proporção do valor do campo. No campo Divisor você pode inserir o número pelo qual o valor do campo será dividido; no Multiplicador , insira o número pelo qual o valor do campo será multiplicado e o retorno de chamada mostrará o resultado final. Você também pode identificar no campo Precisão do resultado quantas casas decimais podem ser mostradas no resultado após o separador. Se você clicar no botão “ Tags Dinâmicas” próximo aos campos Divisor ou Multiplicador , você pode selecionar o Campo Personalizado JetEngine com o valor numérico e usá-lo para o cálculo proporcional;

• Campo calculado. Execute operações aritméticas com o valor do campo atual. Para obter esse retorno de chamada, vá para a página do Free DevTools Kit , baixe o complemento de retorno de chamada calculado e carregue-o como um plugin para o seu site WordPress. Para saber mais sobre esse retorno de chamada, acesse o tutorial do complemento Calculado Callback ;

• Formato do número de telefone. Permite formatar números de telefone e cartão de crédito do metacampo Number , Text ou Textarea aplicando uma máscara a um widget de Campo Dinâmico. Para obter esse retorno de chamada, vá para a página do Free DevTools Kit , baixe o complemento Phone Number Format e carregue-o como um plugin para o seu site WordPress.

Ajustar a saída de valores dos metacampos Select, Radio e Checkbox

• Vários valores de campo de seleção . Este é usado para o tipo de campo Selecionar e permite mostrar várias opções selecionadas. Não se esqueça de especificar o Delimitador posteriormente. Para poder selecionar várias opções no metacampo Selecionar , vá para JetEngine > Post Types , clique para editar a opção necessária e habilite a alternância Múltipla para o campo Selecionar ;

” alt=”vários valores de campo de seleção” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/multiple-select-field-values-2.png” />

• Obtenha o elemento filho de object/array . Este retorno de chamada funciona com os metacampos Checkbox e Select . Mostra o valor da opção escolhida na caixa de seleção do select. Por exemplo, se você marcar a opção “2” da caixa de seleção e tiver escolhido a opção “2” para o retorno de chamada – será exibido o valor “verdadeiro”;

” alt=”obter elemento filho do objeto/matriz” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/01/get-child-element-from-object-or-array-2.png” />

• Obtenha rótulos por dados do glossário . Permite exibir os rótulos da lista de itens do glossário . Esse retorno de chamada funciona com os metacampos Radio , Select e Checkbox ;

• Valores dos campos da caixa de seleção . Se você deseja exibir os valores escolhidos em um campo do tipo Checkbox , este callback irá ajudá-lo a exibi-los em uma linha, separados por Delimiter ;

• Lista de valores verificados . Este retorno de chamada também é usado com o tipo de metacampo Checkbox , mas mostra os dados como uma lista. Você pode definir o glossário se usar um para o metacampo Checkbox e escolher o número das colunas . Você também pode ativar a alternância Adicionar divisor entre itens e definir a cor do divisor ;

• Valores do campo da caixa de seleção ACF . Este permite exibir os valores dos metacampos Checkbox criados pela funcionalidade do plugin ACF .

Ajustar a saída de valores do metacampo Switcher

• Valores do campo do alternador . Com a ajuda desse retorno de chamada, você pode exibir os valores do tipo de metacampo Switcher .

Defina a exibição no metacampo Mídia

• Obtenha imagem por ID . Esta opção de retorno de chamada exibe a imagem do banco de dados em vez de seu valor numérico ao usar o metacampo Media . Você também pode definir o tamanho da imagem ;

• Obtenha o link do arquivo anexo por ID . Esta opção aparece na lista depois que você ativa o link do arquivo anexo por alternância de ID na guia JetEngine > Painel JetEngine > Módulos > Módulos Externos . Permite exibir links de download para .pdf, .zip e outros formatos de arquivo do metacampo Mídia usando o widget Campo Dinâmico e usá-lo para gerar esses links para o arquivo e modelos de página única. Na seleção do nome de exibição , você pode escolher as seguintes opções:
  • “Nome do arquivo” – mostra o nome do arquivo,
  • “Título da postagem do anexo” – se o arquivo contiver um link para a postagem ou modelo de página, esta opção mostra o título,
  • “Título da postagem atual” – mostra o título da postagem em qual campo de mídia o arquivo está anexado,
  • “Título da postagem pai” – mostra o título do pai da postagem atual. Para poder definir o Parent , vá para JetEngine > Post Types , clique para editar o tipo de postagem necessário e ative a alternância Hierárquica na guia Configurações avançadas . Em seguida, prossiga para a guia de tipo de postagem no painel do WordPress, clique no botão “ Edição rápida ” abaixo da postagem necessária e defina o Pai ).
  • “Personalizado” – permite definir o rótulo Personalizado .

Defina a exibição no metacampo da Galeria

• A opção de retorno de chamada de grade da galeria de imagens permite exibir uma galeria adicionada usando o metacampo Galeria . Esta opção aparece na lista depois que você ativa a alternância do widget Grid Gallery for Dynamic Field na guia JetEngine > JetEngine Dashboard > Modules > Default Modules . Para este retorno de chamada, você pode definir o número de colunas , tamanhos de imagem e ativar a opção Usar lightbox que exibe imagens em tamanho real preenchendo a tela. Para saber mais, prossiga para o tutorial JetEngine Grid Gallery e Slider Gallery Options do Dynamic Field Widget ;

• Controle deslizante da galeria de imagens . Este é usado sempre que você precisa exibir as imagens adicionadas usando o metacampo da Galeria em um controle deslizante. Esta opção aparece na lista depois que você ativa a alternância do widget Galeria deslizante para campo dinâmico na guia JetEngine > Painel JetEngine > Módulos padrão . Para este retorno de chamada, você pode definir o número de colunas , tamanhos de imagem e ativar a opção Usar lightbox que exibe imagens em tamanho real preenchendo a tela. Para saber mais, prossiga para o tutorial JetEngine Grid Gallery e Slider Gallery Options do Dynamic Field Widget .

Defina a exibição do metacampo Iconpicker

• Incorporar ícone do Iconpicker . Este retorno de chamada é para o campo do tipo Iconpicker e permite mostrar o ícone, não seu ID.

Mostrar o texto dos metacampos Text e Textarea

• Adicione guias de parágrafo (wpautop) . Se você escolheu o metacampo Textarea na seleção do Meta Field , esse retorno de chamada adicionará parágrafos ao texto;

• Corte a string por gráficos ou palavras . Esta opção aparece na lista depois que você ativa a alternância de retorno de chamada de string Trim na guia JetEngine > Painel JetEngine > Módulos > Módulos Externos . Ele exibe os pedaços de texto dos metacampos, opções, etc., cortados pelo valor de comprimento da String escolhido .

Exibir os valores do metacampo Postagens

• Obtenha títulos de postagens de IDs . Ele pode ser usado com o metacampo Postagens . Quando habilitado, esse callback exibe os títulos dos posts que você escolheu no campo;

• Lista de postagens relacionadas . Esse retorno de chamada também funciona com o metacampo Postagens , mas exibe os títulos das postagens em uma lista em vez de em uma linha. A opção de valor único habilitada mostra apenas a primeira postagem relacionada. Você também pode adicionar links para postagens relacionadas e definir a tag HTML da lista relacionada : “UL” – mostra postagens na lista com marcadores, “OL” – mostra postagens na lista numérica ordenada e “DIV” – mostra postagens na linha. Se desejar, defina o Delimeter ;

• Contagem de valores de campo . Outro retorno de chamada para o metacampo Postagens . Mostra o número de postagens que você escolheu no campo.

Exibir os dados da relação

• Lista de itens relacionados . Este retorno de chamada exibe a lista de itens relacionados (postagens, termos, CCTs ou usuários). Para este retorno de chamada, você precisa escolher a fonte “Post/Term/User/Object Data” e selecionar uma das opções no campo Object na coluna Related items for current object . A opção de valor único habilitada mostra apenas o primeiro item relacionado. Você também pode adicionar links para postagens relacionadas e definir a tag HTML da lista relacionada : “UL” – mostra os itens na lista com marcadores, “OL” – mostra os itens na lista numérica ordenada e “DIV” – mostra os itens na linha. Se desejar, defina o Delimeter ;

Habilitar formato de saída de tipos de campos específicos

• Faça códigos de acesso . Se você adicionasse um shortcode em alguns dos campos, normalmente ele seria exibido como texto simples. E quando esse callback estiver habilitado, o shortcode do campo será processado e mostrado corretamente. Por exemplo, existem dois widgets de campo dinâmico na captura de tela. Ambos possuem o metacampo Text com o shortcode como Source , mas o retorno de chamada “Do shortcodes” é aplicado apenas ao primeiro. Para aprender como gerar códigos de acesso com o plugin JetEngine , prossiga para Visão geral das configurações do painel JetEngine ;

• Contador de listagem . Possibilita enumerar itens do Listagem. Para obter esse retorno de chamada, vá para a página do Free DevTools Kit , baixe o complemento Listing counter e carregue-o como um plugin para o seu site WordPress. Para fazer esse retorno de chamada funcionar, você precisa criar uma consulta com o recurso JetEngine Query Builder . Esteja ciente de que você também precisa aplicar a Consulta Personalizada ao widget Grade de Listagem para fazer o recurso Contador de Listagem funcionar corretamente. Habilite a opção Contador pai se você tiver um item de listagem em outro item de listagem para criar uma lista aninhada. Vá para este link para encontrar exemplos de uso deste retorno de chamada;

• Código QR . Esta opção aparece na lista depois que você ativa a alternância do widget QR Code for Dynamic Field na guia JetEngine > JetEngine Dashboard > Default Modules . Ele permite que você exiba quaisquer dados colocados no metacampo como um código QR. Você também pode identificar o tamanho do código QR . Assista ao tutorial em vídeo Como exibir códigos QR com o widget Dynamic Field para saber mais.

Isso é tudo. Agora você é um profissional quando se trata do widget Dynamic Field . Esteja ciente de que você pode obter alguns recursos gratuitos para JetEngine e outros plug-ins na página Free DevTools Kit .