Criando consulta de usuários e exibindo os mais vendidos em uma Listing Grid
Crie um glossário
Como começaremos criando um glossário , primeiro vá para WordPress Dashboard> JetEngine e abra a guia Glossários .
Clique no botão “ Novo Glossário ” para definir os parâmetros necessários.
Preencha o campo Nome com um valor que servirá de rótulo para o glossário criado.
Depois disso, preste atenção no campo Fonte de dados . Desta vez selecionaremos a opção “Definir itens manualmente”, embora você possa escolher “Obter itens do arquivo carregado” caso queira importar valores.
Pressione o botão “ Novo campo ” para adicionar o primeiro item.
Vamos dar uma olhada nos campos apresentados e preenchê-los adequadamente.
” alt=”item do glossário de motores a jato” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/02/jetengine-glossary-item-full.png” />
- Valor do Campo — digite um valor que será salvo no banco de dados. Preste atenção que este valor não deve incluir espaços e letras maiúsculas e deve ser escrito em letras latinas. Se quiser separar as palavras, faça-o utilizando os símbolos “-” e “_”;
- Etiqueta do Campo — preencha o campo com a etiqueta exibida como título do item do glossário;
- Está marcado (selecionado) — ative a alternância mencionada para tornar o valor específico verificado por padrão. Por exemplo, nós o ativamos para uma opção, dedicada a novos usuários. Assim, todos os usuários receberão este status por padrão, sendo possível desabilitá-lo posteriormente.
Em seguida, adicione quantas opções precisar clicando no botão “ Novo campo ”, ajuste-as e não se esqueça de clicar no botão “ Salvar ”.
Depois de seguir as etapas anteriores, precisamos adicionar o glossário construído na meta box dos usuários .
Adicione um campo de caixa de seleção à Meta Box
Navegue até WordPress Dashboard> JetEngine> Meta Boxes e pressione o botão “ Adicionar Novo ” para construir uma nova meta box.
Ou selecione a metacaixa existente e pressione o botão “ Editar ” ao lado do item necessário.
A partir da guia Configurações Gerais , preencha todos os campos iniciais.
- Título da Meta Box — dê um título à meta box que você está criando;
- Meta Box for — selecione a fonte onde a meta box será exibida. No caso de uso descrito, precisamos escolher a opção “Usuário”;
- Link ‘Editar meta box’ – ative este recurso se desejar exibir o botão em forma de engrenagem na página de edição do usuário para prosseguir para a edição da meta box rapidamente.
Você também pode trabalhar na guia Condições de Visibilidade para definir a visibilidade da metacaixa do usuário.
Agora selecionaremos a opção “Editar usuário” para que apenas o administrador do site possa alterar o status dos usuários.
Lembre-se de alterar este valor para “Editar usuário e perfil” se quiser disponibilizar a edição tanto para administradores quanto para usuários.
” alt=”condições de visibilidade da meta box” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/02/meta-box-visibility-conditions-full.png” />Por fim, vá para a guia Meta Fields e pressione o botão “ New Meta Field ” para iniciar a edição.
” alt=”campos meta da caixa meta dos usuários do jetengine” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/02/jetengine-users-meta-box-meta-fields-full.png” />Vamos verificar as configurações do metacampo e trabalhar nas necessárias para obter o resultado desejado.
” alt=”a primeira parte das configurações do campo da caixa de seleção” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/02/the-first-part-of-checkbox-field-settings-full.png” />
- Rótulo — nomeie o campo exibido na metacaixa do usuário;
- Nome/ID — defina o ID para o futuro campo da caixa de seleção; você precisará dele mais tarde. Verifique se este valor deve incluir apenas letras latinas minúsculas, números, símbolos “-” e “_” sem espaços;
- Tipo de objeto — selecione a opção “Campo” pois precisa adicionar o campo com precisão;
- Tipo de campo — especifique o tipo de metacampo que deseja usar. Desta vez, selecionamos “Caixa de seleção”.
Em seguida, observe as seguintes configurações. Nem todos eles são obrigatórios no caso descrito. Preste atenção ao botão Obter opções do glossário ; ative-o para ver o campo Glossário . Escolha aqui o glossário criado anteriormente com JetEngine .
Isso é tudo que precisamos na metacaixa. Então, agora você pode clicar no botão “ Adicionar/Atualizar Meta Box ” para salvar o resultado.
Criar consulta de usuários
A próxima etapa é construir uma consulta acessando o diretório WordPress Dashboard > JetEngine > Query Builder .
Pressione o botão “ Adicionar novo ” para criar uma nova consulta.
Aqui as Configurações Gerais também são as primeiras a serem definidas na consulta descrita.
- Nome — dê um título à consulta editada;
- Tipo de Consulta — escolha “Consulta de Usuários” para definir a consulta estritamente para usuários;
- ID da consulta – opcionalmente, você pode preencher este campo se trabalhar com o plug-in JetSmartFilters e precisar do ID do filtro que você construiu.
Passando para a Consulta de usuários, abra a guia Diversos . Aqui precisamos especificar o número de usuários que serão exibidos na grade posteriormente.
” alt=”a primeira parte da guia misc da consulta dos usuários” data-src=”https://crocoblock.com/knowledge-base/wp-content/uploads/2023/02/the-first-part-of-the-users-query-misc-tab-full-1.png” />Além disso, queremos exibir os usuários não apenas dependendo de seu status, mas também do número de postagens que possuem. Então vá para o campo Ordenar por e selecione a opção “Por contagem de postagens do usuário”.
Além disso, definimos a Ordem como “Dos valores mais altos para os mais baixos”. E você pode escolher o pedido de sua preferência, se desejar.
Vá para a guia Meta Query para trabalhar em suas configurações. Pressione o botão “ Adicionar novo ” para criar uma nova cláusula de metaconsulta.
Vamos começar a preencher os campos disponíveis para edição.
- Chave/nome do campo – cole o valor do metacampo que você inseriu anteriormente na metacaixa do usuário Metacampo da caixa de seleção;
- Compare – escolha aqui a opção “Regexp” pois ela deve ser usada com os valores Checkbox e Radio;
- Valor — cole um dos valores que deseja exibir na grade;
- Tipo – escolha a opção “Char” se você trabalha com valores alfabéticos ou verifique o outro valor disponível.
Isso é tudo que precisamos para a consulta, então agora você pode clicar no botão “ Adicionar Consulta ”.
Exibir os principais especialistas
Vá para Painel do WordPress > JetEngine > Listagens . Edite a listagem existente passando o mouse sobre ela e pressionando o botão “ Editar ” ou clique no botão “ Adicionar novo ”.
Preencha a listagem com os dados dinâmicos relativos aos usuários do seu site WordPress.
Além disso, podemos adicionar os status criados a esta listagem. Coloque o widget/bloco de campo dinâmico na página.
Defina “Meta Data” como a fonte e escolha o Meta Field que você criou antes na meta box dos usuários.
Vá para a alternância de saída do campo Filtro e ative-a para definir a “Lista de valores verificados” como o retorno de chamada .
Selecione o glossário criado no campo Obter rótulos por glossário . Então agora é isso para ajustar este campo.
Você também pode estilizar os campos adicionados na seção Elementor correspondente e pressionar o botão “ Publicar ” quando tudo estiver pronto.
Vá para a página onde deseja colocar a listagem em WordPress Dashboard > Pages . Selecione a página existente e passe o mouse sobre ela para clicar no botão “ Editar ”.
Ou crie uma nova página clicando no botão “ Adicionar novo ”.
Adicionar listagem a Gutenberg
Procure o bloco Listing Grid . Depois de adicioná-lo à página, escolha o item necessário no campo Listagem .
Abra a guia Consulta Personalizada para ativar a alternância Usar Consulta Personalizada e selecione a consulta criada no campo Consulta Personalizada .
Pressione o botão “ Publicar/Atualizar ” para ativar a página.
Ajustar listagem no Elementor
O mesmo procedimento descrito anteriormente pode ser repetido no Elementor Page Builder.
Encontre o widget Listing Grid e coloque-o na página. Escolha o item que você construiu anteriormente no campo Listagem .
Vá para a guia Consulta personalizada , ative o botão Usar consulta personalizada e escolha a consulta criada como opção no campo Consulta personalizada .
É isso; pressione o botão “ Publicar/Atualizar ”.
E agora, por meio do JetEngine e seu recurso Query Builder , todos os usuários com status “Top Specialist” serão exibidos na grade e ordenados de acordo com o número de postagens do usuário.