Macros para relações WordPress
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 .
Macro de itens relacionados
Se você criou um relacionamento pai-filho e deseja mostrar itens relacionados – esta macro é para você.
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.
Navegue 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 .
Abra 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”.
Existem 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.
Definimos essa consulta para a relação neste tutorial. Após terminar, clique nos botões “Aplicar” e “Adicionar Consulta” .
Crie 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 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.
Abra 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 .
Apó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.
Preencha-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.
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” .
Em 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.
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 .
Na 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” .
Macro de irmãos relacionados
A 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 .
Abra 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”.
Em 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).
Clique 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 .
Coloque 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.
Depois de terminar a edição, clique no botão “Publicar” ou “Atualizar” .
Macro dos avós relacionados
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.
Isso 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.
Agora é 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”.
Em 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.
Clique 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 .
Coloque 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.
Depois de terminar a edição, clique no botão “Publicar” ou “Atualizar” .
Macro Netos Relacionados
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.
Isso 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.
Agora é 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”.
Em 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).
Clique 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 .
Como você pode ver, este widget com consulta mostra os passeios dos netos pelo continente europeu.
É 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 .