Macros para relações WordPress

Aviso

Esteja ciente de que as macros legadas funcionam apenas com as relações legadas. As macros de refatoração descritas neste tutorial funcionam com a relação de refatoração que você pode criar após a atualização 2.11.0 do JetEngine .

legado e refatoração de macros

Se você criou um relacionamento pai-filho e deseja mostrar itens relacionados – esta macro é para você.

Coisas para saber

Esta macro exibe itens pais ou filhos do objeto.

Esta macro permite que você obtenha postagens filhas ou pais relacionadas ao objeto. Por exemplo, se você tiver os tipos de postagem relacionados a Provedores e Serviços , poderá exibir apenas os serviços que o provedor específico oferece.

postagem pai relacionada e postagens filhasNavegue até JetEngine > Query Builder e clique no botão “Adicionar novo” .

Dê um nome à sua consulta . Selecione o tipo de item pai ou filho que deseja exibir no campo Tipo de Consulta . Por exemplo, se você precisar obter as postagens filhas do usuário pai, escolha a opção “Post Query”.

Consulta de postagens

Se você precisar obter os itens relacionados do tipo de postagem, selecione a opção “Post Query” no campo Tipo de Consulta . Na seção Geral , especifique o Tipo de postagem .

publica o tipo de consulta para os itens relacionadosAbra a seção Postagem e página , clique no ícone de macros próximo ao campo Postar em e selecione a opção “Itens relacionados”.

macros em consultaExistem essas configurações na janela Itens Relacionados :

  • Da Relação . Especifique a relação de onde você deseja obter os itens pai ou filho;
  • Do objeto . Especifique se deseja exibir itens filhos ( opção Objeto Filho ) ou pais ( opção Objeto Pai );
  • ID de objeto inicial de . Indique de onde a consulta obterá o ID do objeto para exibir seus itens relacionados:
    • ID do objeto atual . Mostra os itens relacionados da postagem atual na Página Única (como em nosso exemplo, a consulta mostra os serviços relacionados da postagem do provedor atual), do item de listagem ativo atual e assim por diante;
    • ID do usuário atual. Mostra os itens relacionados do usuário atualmente logado;
    • ID do usuário consultado. Mostra os itens relacionados do usuário selecionado, por exemplo, na página do usuário no Profile Builder ;
    • Variável de consulta . Mostra os itens relacionados da solicitação global ou das variáveis ​​de solicitação do WordPress. Se você selecionar esta opção, o quarto Nome da Variável aparecerá;
    • Variável de objeto atual . Mostra os itens relacionados do objeto definido como atual pelo JetEngine . Se você selecionar esta opção, o quarto Nome da Variável aparecerá ;
    • Objeto padrão do WordPress (para a página atual) . Sempre mostra os itens relacionados de um objeto global atual para a página atual definida pelo WordPress, ao contrário da opção “Da Relação”. Por exemplo, em uma única página/postagem única, será sempre a postagem atual, mesmo se você for para a listagem adicionada a esta página.
  • Nome variável . Este campo aparece se você selecionar as opções “Variável de Consulta” ou “Variável de Objeto Atual”. Esta opção permite definir o nome da variável que o plugin irá buscar na consulta ou objeto atual.

macros de itens relacionadosDefinimos essa consulta para a relação neste tutorial. Após terminar, clique nos botões “Aplicar” e “Adicionar Consulta” .

consulta para tipos de postagem relacionadosCrie um item de listagem para a postagem secundária/pai relacionada que você deseja exibir, caso ainda não tenha feito isso. Em seguida, preencha-o com conteúdo usando, por exemplo, Dynamic Field ou outros widgets dinâmicos. Não se esqueça de publicá-lo.

” alt=”configurar item de listagem para postagens” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2022/01/setup-listing-item-2.png” />Prossiga para a página única (ou a página de arquivo para os termos relacionados) com o item pai/filho (por exemplo, postagem) e coloque a grade de listagem com os itens filhos/pai lá. Abra a seção Consulta personalizada no widget Grade de listagem , ative o botão Usar consulta personalizada e selecione o nome da consulta personalizada necessária . Depois de terminar a edição, clique no botão “Publicar” ou “Atualizar” .

consulta personalizada de grade de listagem

Consulta de termos

Selecione a opção “Consulta de Termos” no campo Tipo de Consulta para obter os itens relacionados da taxonomia. Na seção Geral , escolha o nome da Taxonomia ou vários nomes.

termos tipo de consultaAbra a seção Incluir/Excluir , clique no ícone de macros próximo ao campo Incluir e selecione a opção “Itens Relacionados”. Em seguida, defina as opções de macro de acordo com suas necessidades. Descrevemos todas as configurações de macro no parágrafo Consulta de postagens .

macro de itens relacionados para termosApós terminar, clique nos botões “Aplicar” e “Adicionar Consulta” .

Crie um item de listagem para os termos filhos/pais relacionados que você deseja exibir, caso ainda não tenha feito isso.

configurar item de listagem para termosPreencha-o com conteúdo com a ajuda, por exemplo, do Dynamic Field ou de outros widgets dinâmicos.

” alt=”listando item para termos com o campo dinâmico” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2022/01/listing-item-with-the-dynamic-field-2.png” />Prossiga para a página única (ou a página de arquivo para os termos relacionados) com o item pai/filho (por exemplo, postagem) e coloque a grade de listagem com os itens filhos/pai lá. Abra a seção Consulta personalizada no widget Grade de listagem , ative o botão Usar consulta personalizada e selecione o nome da consulta personalizada necessária . Depois de terminar a edição, clique no botão “Publicar” ou “Atualizar” . Então, você pode navegar até o front end e ver o resultado.

termos relacionados na única página

Consulta de usuários

Selecione o tipo “Consulta de usuários” se decidir exibir usuários relacionados. Vá para a seção Incluir/Excluir , clique no ícone de macros próximo ao campo Incluir e selecione a opção “Itens Relacionados”. Em seguida, defina as opções de macro de acordo com suas necessidades. Após terminar, clique nos botões “Aplicar” e “Adicionar Consulta” .

tipo de consulta de usuários para relaçõesEm seguida, crie um item de listagem para usuários e arraste e solte o widget Grade de listagem na página única (ou você pode colocá-lo na página de arquivo para os termos relacionados). Abra a seção Consulta personalizada no widget Grade de listagem , ative o botão Usar consulta personalizada e selecione o nome da consulta personalizada necessária . Depois de terminar a edição, clique no botão “Publicar” ou “Atualizar” . Então, você pode navegar até o front end e ver o resultado.

usuários relacionados no front-end

Consulta de tipo de conteúdo personalizado

Se você decidir exibir itens relacionados ao tipo de conteúdo personalizado , selecione o tipo “Consulta de tipo de conteúdo personalizado” . Selecione o nome do CCT necessário no campo Do tipo de conteúdo e clique no botão “Adicionar novo” na seção Consulta .

consulta de tipo de conteúdo personalizado para relaçõesNa nova janela, escolha a opção “Item ID” no Campo e “Igual (=)” no Comparar. Clique no ícone de macros próximo ao campo Valor e selecione a opção “Itens Relacionados”. Em seguida, defina as opções de macro de acordo com suas necessidades. Por fim, selecione o tipo “Numérico”. Após terminar, clique nos botões “Aplicar” e “Adicionar Consulta” .

consultar as configurações do CCT com a macro de itens relacionados

Macro de Irmãos Relacionados é semelhante à Macro de Item Relacionado , mas não exibe o pai ou os filhos do item, mas os irmãos. Por exemplo, você tem a conexão “País > Passeios”. A Macro de Itens Relacionados pode mostrar os passeios filhos do país na Grade de Listagem na Página Única do País, e a Macro Irmãos Relacionados pode exibir os passeios relacionados na Página Única do Tour.

Vá para JetEngine> Query Builder e clique no botão “Adicionar novo” .

Dê um nome à sua consulta . Selecione o tipo de itens irmãos que deseja exibir no campo Tipo de Consulta . Descrevemos acima como definir os diferentes tipos de consulta para tais macros. Para nosso exemplo, selecionamos a opção “Pós-consulta”, mas escolha o tipo adequado de consulta se quiser mostrar os termos irmãos, usuários ou itens CCT.

Na seção Geral , especifique o Tipo de postagem .

consulta para irmãosAbra a seção Postagem e página , clique no ícone de macros próximo ao campo Postar e selecione a opção “Irmãos relacionados”.

macro de irmãos relacionadosEm seguida, defina as opções de macro de acordo com suas necessidades. As configurações desta macro são semelhantes à anterior. Para nossa causa, selecionamos o nome da relação necessária, a opção “Objeto filho” (porque queremos exibir passeios que são itens filhos em nossa relação) e a opção “ID do objeto atual” (porque desejamos que os usuários vejam os passeios relacionados ao passeio que eles visitam).

macro de irmãos relacionados para os tipos de postagemClique no botão “Adicionar Consulta” ou “Atualizar Consulta” . Em seguida, crie o Item de Listagem , caso ainda não tenha feito isso, ou prossiga para a Página Única .

página única para passeiosColoque o widget Listing Grid lá, abra a seção Consulta Personalizada , ative o botão Usar Consulta Personalizada e selecione o nome da Consulta Personalizada necessária . Como você pode ver, o tour na página única é para a Argentina, então a grade de listagem com a consulta também mostra os tours relacionados para a Argentina, seu mesmo pai.

grade de listagem para os irmãos relacionadosDepois de terminar a edição, clique no botão “Publicar” ou “Atualizar” .

Esta macro obtém os avós do objeto. Antes de definir a consulta, esteja ciente de que você constrói um relacionamento com a opção Relação pai habilitada.

relação parentalIsso significa que você tem 2 parentes, um é “Pai” e outro é “Filho”. Por exemplo, continentes para países e países para passeios. O segundo deve ter a opção Relação pai habilitada.

esquema de relacionamentosAgora é hora de criar uma consulta que una esses dois e nos permita recuperar os avós por meio dos netos e vice-versa.

Vá para JetEngine> Query Builder e clique no botão “Adicionar novo” .

Dê um nome à sua consulta . Selecione o tipo de itens avós que deseja exibir no campo Tipo de Consulta . Acima, descrevemos como definir os diferentes tipos de consulta. Para nosso exemplo, selecionamos a opção “Post Query”.

Clique no ícone de macros próximo ao campo necessário e selecione a opção “Avós Relacionados”.

macro de avós relacionadosEm seguida, defina as opções de macro de acordo com suas necessidades. Para o nosso caso, selecionamos o nome do relacionamento onde está um neto da relação “Continente > País” (“Continente” é um tipo de postagem de avô), e a opção “ID do objeto atual” (porque queremos exibir o continente que é avô do tour neto na página única do tour). Se você quiser saber mais sobre as opções de ID de objeto neto de , vá para a seção Macro de itens relacionados neste tutorial e leia sobre a opção ID de objeto inicial de ; eles têm as mesmas configurações.

configurações macro relacionadas aos avósClique no botão “Adicionar Consulta” ou “Atualizar Consulta” . Em seguida, crie a Listagem para os itens dos avós, caso ainda não tenha feito isso, e prossiga para a Página Única do neto .

página única para passeiosColoque o widget Listing Grid com os itens avós lá. Abra a seção Consulta personalizada no widget Grade de listagem , ative o botão Usar consulta personalizada e selecione o nome da consulta personalizada necessária . Como você pode ver, este widget com consulta mostra o continente dos avós do passeio dos netos.

postagens de netos e avósDepois de terminar a edição, clique no botão “Publicar” ou “Atualizar” .

Esta macro obtém os netos do objeto relacionado. Antes de definir a consulta, esteja ciente de que você constrói um relacionamento com a  opção Relação pai  habilitada.

relação parentalIsso significa que você tem 2 parentes, um é “Pai” e outro é “Filho”. Por exemplo, continentes para países e países para passeios. O segundo deve ter a opção Relação pai habilitada.

esquema de relacionamentosAgora é hora de criar uma consulta que una esses dois e nos permita recuperar netos por meio de avós e vice-versa.

Vá para  JetEngine> Query Builder e  clique no  botão “Adicionar novo”  .

Dê um  nome à sua consulta . Selecione o tipo de itens netos que deseja exibir no   campo Tipo de Consulta . Acima, descrevemos como definir os diferentes tipos de consulta. Para nosso exemplo, selecionamos a opção “Post Query”.

Clique no ícone de macros próximo ao campo necessário e selecione a opção “Netos Relacionados”.

macro netos relacionadosEm seguida, defina as opções de macro de acordo com suas necessidades. Para o nosso caso, selecionamos o nome do relacionamento onde está um neto para a relação “País > Passeios” (“Tours” é um tipo de postagem neto) e a opção “Current Object ID” (porque queremos exibir os passeios que são netos do continente avó na página única do continente).

configurações de macros infantis relacionadasClique no  botão “Adicionar Consulta”  ou  “Atualizar Consulta”  . Em seguida, crie a  Listagem  para os itens dos netos, caso ainda não tenha feito isso, e prossiga para a  Página Única dos avós .

Coloque o  widget Listing Grid  com os itens netos lá. Abra a  seção Consulta personalizada  no  widget Grade de listagem  , ative o  botão Usar consulta personalizada  e selecione o nome da  consulta personalizada necessária .

consulta personalizada para a grade de listagemComo você pode ver, este widget com consulta mostra os passeios dos netos pelo continente europeu.

postagens de avós e netos no front end

É isso. Agora você sabe como exibir postagens, termos, usuários e itens CCT relacionados ao WordPress para pais, filhos, irmãos e avós com a ajuda de macros e do recurso JetEngine Query Builder .

Índice