Visão geral do tipo de consulta de postagens do Query Builder

Ajuste os pontos gerais da consulta personalizada trabalhando nos campos a seguir.

• Tipo de postagem – neste menu suspenso, você verá todos os tipos de postagem do seu site, tanto padrão quanto feitos com o plugin JetEngine . Escolha as postagens do tipo de postagem que você gostaria de consultar;
• Status da postagem — aqui você pode escolher o status das postagens adicionadas à lista. Você pode adicionar vários deles aqui;
• Palavra-chave de pesquisa – a consulta de postagens pesquisará todas as postagens e mostrará apenas as postagens que contêm uma palavra que você digita nesta barra em seu título, trecho ou conteúdo. Se você adicionar um hífen antes da palavra (como: “-sapatos”), todas as postagens com essa palavra serão excluídas da lista. Você também pode preencher esta barra usando tags dinâmicas . Clique no botão no final da barra e você verá a lista de tags dinâmicas;
• Ordenar e Ordenar por — aqui, você pode adicionar parâmetros de classificação. Pode haver vários deles para cada consulta. Clique no botão “ Adicionar novo parâmetro de classificação ” para adicionar uma nova condição de classificação. Cada item de parâmetro de classificação possui recursos adicionais:
  • Ordenar por — neste menu suspenso, você pode escolher o parâmetro pelo qual os itens serão ordenados;
  • Ordem — aqui você pode selecionar a ordem crescente (do menor para o maior) ou decrescente (do maior para o menor);

• Possui senha – ative esta opção se desejar adicionar à lista apenas as postagens que podem ser vistas após inserir a senha;
• Senha da postagem – se você deseja adicionar apenas postagens com uma senha específica, digite-a nesta barra.

Esta guia permite adicionar as postagens à lista de acordo com os valores de seus metacampos. Você define um valor na área de texto Valor e, em seguida, os dados do metacampo escolhido na barra Chave/nome do campo são comparados a esse valor. Se corresponderem, a postagem será adicionada à lista. As condições que o valor do metacampo deve atender são chamadas de Meta Query Clause . Você pode adicionar quantas Meta Clauses desejar clicando no botão “ Adicionar Novo ”.

Além disso, preste atenção aos botões “Tags dinâmicas” ao lado da chave/nome do campo e das barras de valor . Isso significa que você pode não apenas selecionar o valor, mas também personalizar seu Contexto e Fallback na seção Configurações avançadas.

Caso algo dê errado, o texto digitado no campo Fallback será exibido ao usuário.

• Chave/nome do campo — insira o nome do metacampo anexado ao tipo de postagem que você escolheu na guia Configurações gerais. Você pode usar tags dinâmicas nesta barra. Lembre-se de definir Contexto e Fallback na guia Configurações avançadas, se necessário;
• Valor — o valor que você definir aqui será comparado ao valor do metacampo que você escolheu na barra Chave/nome do campo ;
• Comparar — aqui você pode selecionar como os valores serão comparados:
  • Igual – exibe postagens com valor igual;
  • Diferente – mostra postagens que não possuem valor igual;
  • Maior que – mostra postagens de maior valor. Funciona apenas com valores numéricos;
  • Maior ou igual – exibe postagens que possuem valor maior ou igual. Também funciona apenas para valores numéricos;
  • Menor que – mostra postagens de menor valor. Somente para valores numéricos;
  • Menor ou igual – exibe postagens que possuem valor numérico menor ou igual;
  • Curtir – mostra postagens que possuem o valor que você definiu no campo Valor mencionado no conteúdo;
  • Não gostei – exibe apenas os posts que não possuem o valor que você colocou no campo Valor mencionado no conteúdo;
  • Na lista – após você adicionar vários valores ao campo Valor , mostra os posts que possuem pelo menos um deles em seu conteúdo;
  • Não está na lista – exibe postagens que possuem quaisquer valores, exceto aqueles que você digitou no campo Valor ;
  • Entre – exibe postagens que contenham o valor entre dois, que são definidos no campo  Valor ;
  • Não entre – mostra todas as postagens, exceto aquelas que possuem um valor que corresponde ao intervalo definido;
  • Exist – mostra todos os posts que contém a Chave . Você não precisa definir o Valor neste caso;
  • Não existe – exibe todas as postagens que não possuem a chave . Você também não precisa selecionar o Valor ;
  • Regexp – consulta postagens de acordo com os valores dos metacampos Checkbox e Radio;
  • Não regexp – exclui os valores dos metacampos Checkbox e Radio mencionados da consulta;
• Tipo – este menu suspenso permite especificar que tipo de dados são armazenados no metacampo escolhido:
  • Char – dados alfabéticos que não diferenciam maiúsculas de minúsculas;
  • Numérico – apenas números inteiros;
  • Data – valores de data (esteja ciente de que a opção Salvar como carimbo de data/hora nos campos de onde você obtém valores de data) deve estar habilitada. Ative Salvar como carimbo de data/hora se precisar classificar ou consultar postagens por data;
  • Data e hora – data e hora (lembre-se, deve estar habilitado o botão Salvar como carimbo de data/hora nos campos de onde você obtém os valores de data);
  • Decimal – dados numéricos fracionários;
  • Tempo – valores de tempo;
  • Binário – dados sensíveis ao caso;
  • Assinado – números inteiros, tanto positivos quanto negativos;
  • Sem sinal – números inteiros, apenas positivos.
• Nome da cláusula – se você der um nome exclusivo a esta Meta Cláusula, ela aparecerá no menu suspenso Ordenar por e você poderá usá-la para classificar as postagens.

Nesta aba você pode consultar as postagens de acordo com as taxonomias, categorias ou termos que estão vinculados a elas. O conjunto de condições é denominado Cláusula de Consulta Fiscal , e você pode adicionar várias delas a uma consulta clicando no botão “ Adicionar Novo ”.

• Taxonomia — neste menu suspenso, você pode selecionar o tipo de taxonomia aplicada às postagens. Todas as taxonomias disponíveis serão listadas lá;
• Campo – aqui você pode escolher como exibir os termos: por “ID do termo”, “Slug”, “Nome” ou “ID da taxonomia do termo”. Se você selecionou o “Term ID”, deverá preencher o campo Termos com a macro %current_terms% para exibir os posts com os mesmos termos do principal da página. Para adicionar mais termos aos atuais, você pode simplesmente inserir os IDs necessários separando-os com vírgula;
• Termos — de acordo com o que você escolheu no menu Campo , aqui você deve digitar o ID, slug ou nome do termo desejado;
• Excluir filhos — se você escolheu uma taxonomia hierárquica e não deseja adicionar postagens com termos filhos, habilite esta alternância;
• Operador de comparação — este campo define como diferentes termos funcionarão juntos:
  • O operador IN mostra todos os valores da taxonomia escolhida; 
  • NOT IN oculta todos os itens que se aplicam ao termo selecionado; 
  • O operador AND permite a existência de múltiplas condições; 
  • EXIST é usado para testar a existência de qualquer registro em uma subconsulta;
  • NOT EXIST executa a ação oposta.

Aqui, todos os campos apresentam as modificações da data. Defina os valores necessários para obter o resultado preciso.

• Ano — os posts que foram criados ou modificados neste ano serão adicionados à lista;
• Mês — os posts que foram criados ou modificados neste mês serão adicionados à lista;
• Dia — os posts que foram criados ou modificados neste dia serão adicionados à lista;
• Depois — postagens criadas ou modificadas após a data inserida nesta barra serão adicionadas à lista;
• Antes — digite a data aqui, e todos os posts criados ou modificados antes dela serão adicionados à lista;

• Inclusivo — se você ativar esta alternância, a data digitada nos campos Depois ou Antes será incluída no intervalo;
• Comparar – aqui você pode escolher como a data adicionada às barras Ano , Mês e Dia será comparada com a data de criação ou modificação da postagem;
• Coluna — neste menu suspenso, você pode escolher qual data levar – a data de criação ou modificação.

Esta guia permite incluir ou excluir postagens concretas por seus IDs ou slugs. Todos os recursos podem ser preenchidos com o auxílio de tags dinâmicas clicando no botão do lado direito da barra.

• Postar em — se houver vários posts que você deseja adicionar à lista, você pode digitar seus IDs aqui, separados por vírgulas. Esta barra é apenas para vários posts. Se você quiser adicionar apenas um, use a barra Post ID ;
• Post Not In – você pode excluir uma ou várias postagens específicas digitando seus IDs aqui;
• Post Name In — é possível adicionar postagens à lista não por seus IDs, mas por nomes. Digite slugs aqui e separe-os por vírgulas;
• Post Parent ID – se você digitar o ID de uma postagem aqui, todas as postagens filhas serão adicionadas à lista. Você também pode digitar “0” nesta barra, e todas as postagens principais que possuem filhos serão adicionadas à lista sem postagens secundárias;

• Post Parent In – aqui, você pode adicionar vários IDs de postagem pai separados por vírgulas, e todas as postagens filhas serão adicionadas à lista;
• Post Parent Not In — todos os “filhos” dos posts pais que você menciona aqui por seus IDs serão excluídos da lista;
• Post ID – uma barra para IDs de postagem únicos. A postagem que você mencionou aqui será adicionada à lista;
• Post Slug — digite aqui o slug do post e ele será adicionado à lista;
• ID da página — para adicionar a página à lista, digite aqui o seu ID;
• Slug da página – digite o slug da página aqui para adicioná-la à lista.

Aqui você pode adicionar postagens com um determinado número de comentários à lista. A Consulta de Postagens pega o número de comentários que a postagem possui e o compara com o número que você definiu na barra de números de Comentários , adicionando-os à lista posteriormente se a condição for atendida.

• Número de comentários – digite o número de comentários aqui ou pegue o número de algum metacampo por meio das tags dinâmicas;
• Comparar — aqui você pode escolher como o número será comparado. A postagem será adicionada à lista se o número de comentários e o valor que você colocou na barra numérica de Comentários forem:
  • Igual – os números são iguais;
  • Diferente – os números não são iguais;
  • Maior que – o número de comentários é maior que o valor que você definiu;
  • Maior ou igual – o número de comentários é maior ou igual ao valor que você definiu;
  • Menor que – o número de comentários é menor que o valor que você definiu;
  • Menor ou igual – o número de comentários é menor ou igual ao valor que você definiu.

Esta aba funciona como se a lista de posts tivesse paginação. No entanto, você precisa adicionar o widget ou bloco de paginação à sua grade de listagem . Você pode definir o número de postagens por página e, em seguida, adicionar as postagens que estariam na página específica da paginação, se estivesse na página.

• Postagens por página — decida quantas postagens haverá em cada página da paginação. Se você digitar “-1” aqui, todos os posts serão mostrados em uma página, e o valor Offset não funcionará;
• Offset — o número que você digitar aqui será o número de primeiras postagens que não serão adicionadas à lista;
• Paginado — aqui você pode digitar o número da página, e todos os posts que deveriam ter sido mostrados naquela página de paginação serão adicionados à lista;
• Página — o número definido aqui será o número de páginas de uma primeira página estática;

• Ignorar postagens fixas – por padrão, essa alternância está desabilitada e as postagens fixas são colocadas no topo da lista de itens. Você pode ativá-lo e as postagens permanecerão onde deveriam estar.

Esta aba auxilia na consulta de postagens de acordo com seu autor e inclui diversos campos para customização.

• ID do autor — digite aqui o ID do único autor, e todas as postagens que o autor criou serão adicionadas à lista;
• Nome do Autor — todos os posts do autor cujo nome você digitar aqui serão adicionados à lista;
• Author In – nesta barra você pode digitar os IDs de vários autores, e todos os posts que eles criaram serão adicionados à lista;
• Autor não presente – se você digitar os IDs dos autores aqui, as postagens que eles criaram serão excluídas da lista.

Defina a consulta que depende dos valores geográficos. Personalize todas as configurações relativas aos indicadores do mapa.

• Selecione o local – defina o ponto no mapa representado para obter as opções ao seu redor.

• Campo de Endereço — preencha esta barra com o valor do metacampo que armazena um endereço; podem ser dois valores que contêm latitude e longitude.

• Distância — defina o raio da pesquisa. Será realizado dependendo do centro que você selecionou anteriormente;
• Unidades — escolha entre as unidades de distância disponíveis.

Para saber como exibir resultados de pesquisa divididos por categorias de Listagem usando a Consulta Personalizada, assista a este tutorial em vídeo .