Guia de macros

%current_categories% ( “Categorias atuais”) — esta macro retorna as categorias de postagem atuais. Para mostrar postagens relacionadas por categorias, utilize esta macro no campo Termos da aba Consulta Fiscal das configurações da Consulta de Postagens .

%current_tags% (“Tags atuais”) — retorna tags de postagem atuais. Para mostrar postagens relacionadas por tags, utilize esta macro no campo Termos da aba Consulta Fiscal das configurações da Consulta de Postagens .

%current_terms% ( “Termos atuais” ) — retorna os termos atuais da postagem; você pode especificar uma taxonomia para retornar termos de – %current_terms|taxonomy_slug%. 

Se alguém tiver uma taxonomia customizada, esta macro ajuda a consultar os termos atuais para exibir as postagens relacionadas aos termos na página da postagem única. Consulte o guia “Macros para Query Builder” para saber como exibir postagens relacionadas por termos na página de postagem única .

%queried_term% ( “Termo consultado” ) — retorna o ID do termo em sua página de arquivo ou em um item de listagem de termos.

Verifique o guia “Macros para Query Builder” para aprender como exibir postagens relacionadas na página de arquivo de taxonomia usando esta macro.

%current_id% (“ Current ID” ) – retorna o ID da postagem atual. Use esta macro em uma Consulta de Postagens para incluir ou excluir a postagem atual dos resultados da consulta .

%title% ( “Title” ) – digite esta macro no campo Label do widget Dynamic Link para obter o nome da postagem atual e torná-la clicável.

%object_id% (“ Object ID” ) — obtenha o ID do objeto atual colando a macro no campo Label do widget Dynamic Link .

%field_value% ( “Valor do campo” ) — escolha o campo necessário na lista suspensa Fonte e adicione esta macro ao campo Etiqueta no widget Link Dinâmico para obter o valor do campo, definido como a Fonte do Link Dinâmico . Por exemplo, se você usar um metacampo com URL como origem do link, %field value% retornará esse link. 

%jet_engine_field_name|meta-field|field_name% — cole esta macro no campo Label do widget Dynamic Link para obter o nome da chave do metacampo JetEngine . Use o nome real do campo em vez do valor ‘meta-campo’.

%jet_engine_field_name|meta-field|field_value% — a macro semelhante à anterior que também deve ser colada no campo Label . Porém, esta macro retorna o valor do metacampo e não seu nome. Não se esqueça de alterar o valor do ‘metacampo’ para a chave do metacampo real.

%current_meta|field-name% ( “Current meta value” ) — retorna o valor do meta campo da postagem atual. Por exemplo, use esta macro no campo Rótulo do widget Dynamic Link se desejar exibir o valor do campo específico.

Lembre-se de que a macro deve ficar assim: %current_meta|field-name%, onde ‘field-name’ é o nome do campo do qual você deseja extrair os dados. 

Além disso, há uma oportunidade de exibir postagens que tenham o mesmo valor meta da postagem atual .

%current_meta_string|field-name% ( “Current meta value as string” ) — com esta macro, você pode obter valores separados por vírgula dos meta campos da postagem atual que contêm matrizes. Você pode usá-lo com as opções de seleção múltipla ou tipo de caixa de seleção com a opção Salvar como array habilitada. Além disso, é possível usar esta macro para exibir postagens do metacampo Postagens usando esta macro.

%today% ( “Today” ) — retorna a data de hoje como um carimbo de data/hora.

%str_to_time|datetime-string% ( “String to timestamp” ) — transforma o valor em timestamp. Cole a opção necessária em vez da ”string de data e hora”. Por exemplo, você pode colar %str_to_time|10 September 2000% para retornar o carimbo de data/hora desta data, ou %str_to_time|+ 1 day% para obter a data de amanhã como um carimbo de data/hora.

%current_date|format% (“ Data Atual ”) — retorna o dia atual no formato especificado. Para utilizar esta macro corretamente, é necessário passar o parâmetro ‘format’, que aceita estes valores:

• dia — retorna o dia atual do mês. Por exemplo, em 16 de maio, a macro %data_atual|dia% retornará ’16’;
• day_of_week — retorna a representação textual do dia da semana atual. Por exemplo, na terça-feira, a macro %current_date|day_of_week% retornará terça-feira;
• mês — retorna o nome do mês atual. Por exemplo, em maio, a macro %data_atual|mês% retornará ‘maio’;
• ano — retorna o ano atual no formato de 4 dígitos. Por exemplo, no ano 2023, a macro %data_atual|ano% retornará ‘2023’;
• custom — retorna o dia e a hora atuais no formato definido manualmente. Verifique os formatos de data permitidos no tutorial Personalizar formato de data e hora do WordPress. Por exemplo, a macro %current_date|custom|F j, H:i% retornará ’16 de maio, 13:11′.

%option_value|name_of_option::meta_field_name% ( “Option value” ) — retorna o valor do metacampo das opções.

%query_var|field-name% ( “Query Variable” ) — use esta macro para recuperar parâmetros de URL (por exemplo, para recuperar o valor “books” do parâmetro de URL “?s=books”, você precisaria de %query_var|s % macro). 

Se você lidar com Adicionar argumentos de consulta ao URL de redirecionamento na ação pós-envio “Redirecionar para página” do formulário e marcar alguns campos lá, você pode precisar desta macro para exibir os valores dos campos de formulário selecionados na página estática. 

Vá para a página estática escolhida no campo Selecionar página e adicione um widget de link dinâmico a ela. Deixe as configurações padrão e cole a macro mencionada no campo Rótulo . Lembre-se de alterar o ‘nome do campo’ para o nome real do campo que você marcou em Adicionar argumentos de consulta ao URL de redirecionamento .

Como alternativa, use o widget/bloco de campo dinâmico com a origem da variável de consulta em vez do widget/bloco de link dinâmico . 

Assim que o usuário enviar o formulário, ele o redirecionará para a página onde serão exibidas as informações inseridas no campo utilizado.

%query_results|ID|format% (“ Resultados da Consulta ”) — retorna os resultados da consulta personalizada especificada do Query Builder . Pode ser usado para incluir IDs de itens retornados por uma consulta personalizada nas configurações da segunda consulta personalizada. Para usar esta macro corretamente, você precisa passar dois parâmetros – os parâmetros ‘ID’ e ‘formato’. O parâmetro ‘ID’ deve ser substituído pelo ID da consulta personalizada (que pode ser encontrado na URL ao editar a consulta personalizada), e o parâmetro ‘format’ aceita estes valores:

• ids — retorna a lista de IDs de itens. Por exemplo, digamos que haja uma Consulta de Postagens com ID ‘6’; neste caso, a macro %query_results|6|ids% retornará uma lista de IDs de postagens separados por vírgula (por exemplo, ‘1705,1706,1707’). Portanto, é possível utilizar esta macro no campo Post In da aba Post & Page de uma Posts Query para incluir IDs de post retornados por outra Posts Query. Observe que a macro não está limitada à Consulta de Postagens e pode ser usada para recuperar IDs de objetos de outros tipos de consulta. Além disso, lembre-se de que macros inseridas manualmente não são suportadas no Query Builder, portanto, a macro deve ser selecionada na lista de Tags dinâmicas ;
• all — retorna uma matriz de objetos dos resultados da consulta personalizada especificada. Por exemplo, digamos que haja uma consulta personalizada com ID 6; neste caso, a macro %query_results|6|all% retornará objetos dos resultados desta consulta;
• selecionado — retorna uma lista de propriedades selecionadas da consulta especificada. Esta configuração é útil ao lidar com consultas SQL – a macro permitirá recuperar as propriedades necessárias dos resultados de sua consulta SQL e usá-las em outra consulta personalizada. Por exemplo, digamos que haja uma consulta SQL com ID ‘6’ que retorna uma lista consultada de entradas da tabela do banco de dados ‘wp_posts’; neste caso, a macro %query_results|6|selected|ID% retornará uma lista de IDs separados por vírgula porque ‘ID’ é a propriedade especificada. Você pode usá-lo no campo Postar em (guia Postagem e página de configurações) de uma consulta de postagens para gerar uma lista de postagens a partir dos resultados da consulta SQL . Lembre-se de que macros inseridas manualmente não são suportadas no Query Builder, portanto, a macro deve ser selecionada na lista de Tags Dinâmicas .

%query_count|ID|returned_count% (“ Contagem de resultados da consulta ”) — retorna o número de objetos em uma consulta personalizada. O parâmetro ‘ID’ deve ser substituído pelo ID da consulta personalizada (que pode ser encontrado na URL ao editar a consulta personalizada), e o parâmetro ‘returned_count’ aceita estes valores:

• total – retorna o número total de resultados da consulta (por exemplo, %query_count|5|total%);
• visível – retorna o número de resultados visíveis na página atual (por exemplo, %query_count|5|visible%).

Siga o tutorial Como definir a tag dinâmica de contagem de resultados da consulta para exibir o número total de postagens na consulta personalizada e o número de postagens atualmente visíveis na página.

%shortcode_result|[shortcode]% (“ Resultado do shortcode ”) — retorna o valor do shortcode especificado. Substitua a parte ‘[shortcode]’ pelo shortcode real. Esta macro permite o uso de shortcodes no Query Builder para que caso você tenha um shortcode que retorne algum valor útil (por exemplo, determinados IDs de postagem), você possa usar os resultados desse shortcode para configurar a consulta customizada. Lembre-se de que macros inseridas manualmente não são suportadas no Query Builder, portanto, a macro deve ser selecionada na lista de Tags Dinâmicas .

%jfb_record_field|field-name% (“ JetFormBuilder Record Field ”) – retorna o valor registrado do campo de formulário especificado. Funciona apenas na consulta Modelo de Listagem para Registros JetFormBuilder . Saiba mais informações sobre isso no tutorial dedicado Como exibir envios de formulários consultados em uma grade de listagem . 

Lembre-se de substituir a parte ‘nome do campo’ pelo nome do campo do formulário para mostrar o valor registrado deste campo. Se o campo contiver uma matriz de valores, adicione um caminho para o valor exato. Por exemplo, ‘nome_campo/0’, ‘nome_campo/1/chave_aninhada’, ‘nome_campo/chave_aninhada’ etc.

Descubra como trabalhar com as novas macros para JetEngine Relationships no guia especial .

%relacionado_crianças_from|post-type-slug% ( “Filhos relacionados de” ) — este código de macro é usado para exibir apenas as postagens relacionadas a crianças. Você precisa colá-lo no widget Listing Grid (abra o bloco Posts Query e adicione um novo item com o tipo Posts Parameters ).

Lembre-se de que ‘post-type-slug’ na macro descrita representa o slug do tipo post que você deseja usar (por exemplo, “eventos”). Também diz respeito às seguintes macros para as relações descritas abaixo.

%relacionado_parents_from|post-type-slug% ( “Pais relacionados de” ) — este código de macro é usado para exibir apenas as postagens relacionadas aos pais. Você precisa colá-lo no widget Listing Grid (vá para o bloco Posts Query e adicione um novo item com o tipo Posts Parameters ).

%get_grandparent|post-type-slug% ( “Get grandparent” ) — permite definir a conexão entre duas relações já existentes. Com esta macro, você pode exibir postagens dos avós. 

Por exemplo, você tem três tipos de postagem: Países, Continentes e Passeios, e precisa criar uma relação de avós entre Continentes e Passeios. Vá para Post Query (Elementor) ou Query Settings (Gutenberg) e insira as macros. Por favor, verifique o tutorial Como construir relações entre avós e netos para saber mais. 

%get_grandchild|post-type-slug% — com esta macro, você pode exibir postagens de netos. Funcionará vice-versa; no Single Tour mostre a Listagem de Continentes com a Grade de Listagem, e então precisamos usar %get_grandparent|from-post-type%.

%author_id% ( “Post author ID” ) — retorna o ID do usuário autor da postagem atual. Use esta macro para exibir o autor da postagem na página de postagem única .

%queried_user_id% ( “ID do usuário consultado” ) — retorna o ID do usuário consultado apenas nas páginas do Profile Builder e na listagem de usuários; em todos os outros casos – retorna o ID do usuário atual. Pode ser usado para exibir postagens de autoria do usuário consultado na página de perfil público .

%current_user_id% ( “ID do usuário atual” ) — retorna o ID ou o usuário atual. Pode ser usado para exibir postagens de autoria do usuário conectado no momento na página Conta .

%current_user_meta|field-name% ( “Current user meta” ) — obtém um valor do meta campo do usuário atual. Especifique o meta-campo do usuário alterando o ‘nome do campo’ para o nome do meta-campo necessário, de onde você precisa obter as informações.

%get_store|store-slug% ( “Get store” ) — retorna os IDs dos objetos adicionados pelo usuário atual ao armazenamento de dados. Pode ser usado para exibir itens adicionados pelo usuário atual ao Data Store .

%store_count|store-slug% ( “Store count” ) — retorna a quantidade de itens no armazenamento de dados do usuário atual

%get_users_for_store_item|store-slug|context% ( “Obter usuários do item da loja” ) — funciona apenas com o armazenamento de usuários e retorna IDs de usuários que adicionaram esta postagem/usuário em seus armazenamentos de dados. Em outras palavras – se você criar Seguir o sistema, com macros %get_store%, você pode gerar usuários da seguinte lista do usuário atual, e com %get_users_for_store_item% você pode gerar uma lista de seguidores do usuário atual. Para usar esta macro corretamente, você precisa passar dois parâmetros – %get_users_for_store_item|store-slug|context% store-slug é o seu slug de loja real, e context define onde o plugin irá procurar pelo ID do item atual para pesquisá-lo em outro usuário lojas. Este parâmetro aceita quatro valores:

• post — este é o contexto padrão, que será usado caso o segundo parâmetro não seja passado. Este contexto significa que o ID da postagem atual será usado como ID do item para pesquisa. Com este contexto, você pode, por exemplo, gerar uma lista de usuários que curtiram/marcaram esta postagem;
• usuário — significa que o ID do usuário atual será usado. Com este contexto, você pode gerar uma lista de seguidores para o usuário atual;
• queried_user — significa que o ID do usuário não atual, mas o ID do usuário atualmente consultado, será usado. Com este contexto, você pode gerar a lista de seguidores de algum autor no modelo de arquivo do autor ou uma lista de seguidores de usuários na página de usuário único adicionada pelo JetEngine Profile Builder ;
• autor — significa que o ID do autor da postagem atual será usado. Você pode usar este contexto para gerar seguidores do autor da postagem atual na caixa do autor (a opção Contexto também foi adicionada para todos os widgets dinâmicos e tags dinâmicas relacionadas ao usuário, portanto, de agora em diante, você pode construir uma caixa do autor com JetEngine sem listagem adicional).

%add_to_cart_text% (“ Adicionar texto ao carrinho ”) — retorna o texto exibido no botão Adicionar ao carrinho em produtos WooCommerce (por exemplo, ‘Adicionar ao carrinho’, ‘Leia mais’, etc.). Pode ser colado no campo Rótulo do widget Dynamic Link . Se a Fonte do Link Dinâmico estiver definida como “Adicionar ao carrinho”, ele funcionará como um botão Adicionar ao carrinho.

%wc_product_title% (“ WC Product Title ”) – retorna o título de um produto WooCommerce . Pode ser colado no campo Label do Dynamic Link .

%wc_get_products_in_cart% ( “Produtos WC no carrinho” ) — retorna os IDs dos produtos que são adicionados ao carrinho. Pode ser aplicado no campo Incluir de uma WC Query para recuperar produtos do carrinho.

As macros abaixo foram projetadas para uso no recurso iCalendar Template do plugin JetBooking , que pode ser encontrado em Reservas > Calendários . 

As macros aparecem apenas quando o plugin JetBooking está ativado.

%booking_status% (“ JetBooking: Status ”) – retorna o status da reserva.

%booking_unit_title% (“ JetBooking: Unit Title ”) – retorna o nome da unidade (se definido). Para saber mais, prossiga para o tutorial Como gerenciar unidades .

Macro para JetSmartFilters

A macro “JetSmartFilters Query” foi projetada para o plugin JetSmartFilters .

A macro funciona extraindo o valor selecionado dos filtros de consulta atuais. Neste contexto, a consulta de filtro é a matriz completa de argumentos que o filtro passa ao provedor para processamento adicional. Essencialmente, isso abrange os valores de filtro selecionados pelo usuário e os valores padrão com os quais eles se fundem – tudo o que afeta o resultado da filtragem.

Os casos de uso:

• Filtragem para consultas SQL avançadas;
• Use para visibilidade dinâmica dentro de listagens filtráveis;
• Altere o banner após filtrar por categorias .

Para esta macro, recomendamos usar o recurso Gerador de Macros .

Siga o caminho JetEngine > JetEngine > Macros Generator para prosseguir para o gerador.

Aqui, a macro “JetSmartFilters Query” pode ser escolhida no menu suspenso Macros .

As macros a seguir podem ser usadas no widget/bloco Repetidor Dinâmico.

%name% — este código de macro e marcação HTML ( <span></span> ou <div></div> ) são usados ​​para formatar o conteúdo do repetidor no campo Formato do Item do widget Repetidor Dinâmico . Você precisa inserir os IDs específicos dos metacampos incluídos no repetidor para exibir o conteúdo adicionado em determinado metacampo (por exemplo, %text% – esta é a macro que ajudará a exibir o conteúdo adicionado no metacampo que possui o meta-chave “texto”.)

%media-field|img_url_by_id% — insira esta macro no campo Item Format do widget Dynamic Repeater para exibir o link da URL da imagem que será extraída do banco de dados. Se você precisar renderizar a imagem real, use a tag <img>, por exemplo: <img src=”%media-field|img_url_by_id%”>.

Lembre-se de usar a chave do campo media em vez do valor ‘media-field’.

%gallery-field|img_gallery_grid% — insira esta macro no campo Item Format do widget Dynamic Repeater para exibir a galeria em um dos subcampos do repetidor. Esta macro funciona especificamente com Dynamic Repeater .

Cole o nome da chave do campo da galeria em vez do valor “campo da galeria”.

%post_id|post_url_by_id% — coloque esta macro no campo Formato do Item do widget Repetidor Dinâmico para recuperar a URL da postagem por seu ID. Pode ser usado com o metacampo Postagens para recuperar a URL da postagem selecionada (se não for salva como seleção múltipla).

O valor “post_id” representa o campo com o ID da postagem.

%date-field|format_date% ou %date-field|format_date(F j, Y)% — use essas macros se precisar alterar a data no widget Repetidor Dinâmico (coloque esta macro no campo Formato do Item do Repetidor Dinâmico ferramenta).

O valor ‘campo de data’ representa o nome do campo data/hora/datahora, e F j, Y é o formato da data, que pode ser alterado de acordo com este tutorial .

Ou as macros podem ser semelhantes a: %date-field|format_date(d)% ou %time-field|format_date(h)% .

%media-field|img_alt_by_id% — exibe um texto alternativo para uma imagem.

%media-field|file_url_by_id% — com esta macro, você pode obter o link para o anexo.

%post-field|post_title_by_id% — permite obter o nome do post pelo seu ID. Pode ser usado com o metacampo Postagens para recuperar o título da postagem selecionada (se não for salva como seleção múltipla).

%post-field|post_titles_by_ids% — adicione esta macro para obter o nome das postagens. Serão necessários dados do campo que possui vários posts. Pode ser usado com o metacampo Postagens salvo como uma seleção múltipla.

%post-field|post_link_by_id% — coloque esta macro no campo Item Format do widget Dynamic Repeater para obter o título vinculado da postagem. Pode ser usado com o metacampo Postagens para recuperar o título vinculado da postagem selecionada (se não for salvo como uma seleção múltipla).

%checkbox-field|render_acf_checkbox% — insira esta macro para exibir o valor do campo da caixa de seleção ACF. Além disso, você pode exibir campos do JetEngine se a opção Salvar como matriz estiver habilitada. 

Lembre-se de colar a chave do campo da caixa de seleção da qual deseja exibir os dados, em vez do “campo da caixa de seleção”.

%repeater-field|embed_url% — permite incorporar a URL. Por exemplo, você pode exibir um vídeo.

Cole o link necessário no metacampo de texto adicionado ao Repetidor e exiba-o adicionando a macro mencionada no campo Formato do item . Substitua o valor ‘repeater-field’ pelo nome do metacampo de texto que você adicionou ao Repeater . A macro também pode ser usada com um metacampo de mídia que possui o formato de valor “URL de mídia”.

%term-field|term_title_by_id% — adicione esta macro se precisar exibir o nome do termo por ID.

%term-field|term_titles_by_ids% — esta macro permite exibir nomes de termos por seus IDs.

As macros a seguir podem ser usadas na ação pós -envio Enviar e-mail do formulário do módulo Formulários do JetEngine . 

%field-name% – use esta macro no conteúdo da ação pós-envio Enviar e-mail para recuperar o valor do campo do formulário. Lembre-se de substituir a parte ‘nome do campo’ pelo nome real do campo do formulário (por exemplo, se houver um campo de formulário Texto com o nome ‘texto’, a macro ficará assim: %text%). A macro também oferece suporte a campos multiopcionais como Rádio, Seleção e Caixa de seleção.

%date-field|format_date% ou %date-field|format_date(F j, Y)% — use essas macros para alterar a saída de data do campo do formulário Data. O valor ‘campo de data’ representa o nome do campo data/hora/datahora, e F j, Y é o formato da data, que pode ser alterado de acordo com este tutorial.

Além disso, você pode inserir esta macro %date-field|format_date% no bloco Configurações de Notificação do Formulário, e o campo do seu Formulário herdará o formato de data padrão definido nas configurações do WordPress.

Ou as macros podem ser semelhantes a: %date-field|format_date(d)% ou %time-field|format_date(h)% .

%media-field|img_url_by_id% — recupera o URL da imagem. Lembre-se de usar a chave do campo media em vez do valor ‘media-field’. Se você precisar renderizar a imagem real no conteúdo do e-mail, use a marcação HTML e a tag <img>, por exemplo: <img src=”%media-field|img_url_by_id%”>.

%media-field|file_url_by_id% — com esta macro, você pode obter o link para o anexo.

%post-field|post_title_by_id% — cole a macro no campo Conteúdo da ação pós-envio “Enviar e-mail” para obter o título da página a partir de seu ID.

%post-field|post_titles_by_ids% — adicione esta macro para obter os nomes de vários posts. Serão necessários dados do campo que possui vários posts selecionados. Se apenas uma postagem for selecionada, retornará um valor vazio.

%post-field|post_link_by_id% — recupera o título vinculado da postagem por seu ID.

%post_field|post_url_by_id% — recupera a URL da postagem pelo seu ID.

%checkbox-field|render_acf_checkbox% — insira esta macro para exibir o valor selecionado no campo Checkbox. 

Lembre-se de colar a chave do campo da caixa de seleção da qual deseja exibir os dados, em vez do “campo da caixa de seleção”.

%term-field|term_title_by_id% — adicione esta macro se precisar exibir o nome do termo por ID.

%term-field|term_titles_by_ids% — esta macro permite exibir nomes de termos por seus IDs. Se apenas um termo for selecionado, retornará um valor vazio.