Como configurar o endpoint da API REST para consulta personalizada

No site principal, vá para WordPress Dashboard> JetEngine> guia JetEngine e certifique-se de ativar a alternância de tipo de conteúdo personalizado .

Em seguida, vá para WordPress Dashboard> JetEngine> Custom Content Types e clique no botão “ Add New ” ou clique para editar o CCT criado, quais itens você deseja transferir.

Essas configurações são necessárias na seção Configurações Gerais : insira o Nome e o Slug será preenchido automaticamente no campo Nome . Você pode alterar o Slug ao criar o CCT, mas use apenas letras latinas aqui e evite espaços: use hífens ou sublinhados.

Outras configurações são opcionais para transferir os itens CCT via REST API. Leia mais sobre eles na Visão geral do tipo de conteúdo personalizado (CCT) .

Na guia Configurações de campos , adicionamos os seguintes metacampos: o campo Nome “Texto”, o campo Data “Data” e o campo “Mídia” da imagem.

O campo “Mídia” requer mais atenção.

Ajuste todas as configurações desejadas para o CCT e pressione o botão “ Adicionar/Atualizar Tipo de Conteúdo ”.

Em seguida, prossiga para a guia do menu CCT no painel do WordPress e crie vários itens CCT clicando no botão “ Adicionar novo ” e preenchendo os metacampos.

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

Na seção Configurações gerais , insira o nome da consulta e selecione o tipo de consulta “ Consulta de tipo de conteúdo personalizado ” . 

Em seguida, ative a alternância Register Rest API Endpoint para desdobrar uma seção com mais configurações para o registro do endpoint.

Uma descrição detalhada de todas as opções pode ser encontrada no capítulo Register Rest API Endpoint .

Você pode definir o Endpoint Namespace e o Endpoint Path adequados para melhorar o SEO do seu site WordPress.

O acesso restrito para o endpoint também pode ser definido. Você pode configurar o acesso ou entrada pública apenas para usuários com determinadas funções ou capacidades.

Você pode ajustar os argumentos de consulta para personalizar o conteúdo retornado por um servidor web. Por exemplo, inserimos um NOME DO ARGUMENTO DE CONSULTA “classificar” e VALOR PADRÃO “asc” para classificar itens (eventos) por data, do mais antigo para o mais recente.

Na seção Configurações de consulta de tipos de conteúdo , selecione o CCT necessário na lista suspensa Do tipo de conteúdo .

Os argumentos registrados devem ser mapeados para as configurações da consulta.

No nosso caso, clicamos no botão “ Adicionar novo parâmetro de classificação ” na seção Ordenar e Ordenar por . Definimos a ordem por “Data”, a ordem “Do menor para o maior (1, 2, 3; a, b, c)” e o tipo “Data” para classificar itens (eventos) por data, do mais próximo ao mais próximo. mais recente.

Ajuste outras configurações de consulta de acordo com suas necessidades e clique no botão “ Adicionar/Atualizar Consulta ”.

Copie o URL do endpoint da API Rest ou o exemplo de URL do endpoint da API Rest com argumentos de consulta se você adicionar argumentos de consulta ao endpoint.

No segundo site, siga o caminho WordPress Dashboard > JetEngine > JetEngine no segundo site para onde deseja transferir os itens CCT consultados e ative o botão Rest API Listings . Pressione o botão “ Salvar ” e aguarde até que o recarregamento da página seja concluído. 

Depois disso, a aba Rest API Endpoints estará disponível. Abra-o e clique no botão “ + Novo Endpoint ”.

Digite o nome do endpoint (opcional), insira o URL copiado no campo URL do endpoint da API , o caminho dos itens “/” e defina a autorização , se necessário.

Todas as configurações estão descritas no capítulo Módulo REST API .

Em seguida, clique no botão “ Enviar solicitação ” para enviar uma solicitação de amostra para verificar a conexão do endpoint da API e buscar os campos disponíveis. Você obterá o status “Conectado” se tudo progredir sem problemas.

Por fim, pressione o botão “ Salvar ”.

No segundo site, vá para WordPress Dashboard > JetEngine > Listings e clique no botão “ Add New ”.

Selecione a fonte da listagem “REST API Endpoint” e escolha o endpoint adicionado recentemente no menu suspenso Do endpoint da API . Digite o nome do item da Listagem (opcional) e defina uma das visualizações da Listagem (pode ser “Elementor”, “Blocos (Gutenberg)” ou “Tijolos”). Por exemplo, escolhemos o editor Elementor.

Por último, clique no botão “ Criar item de listagem ”.

Na página de edição, coloque o widget Campo Dinâmico . Mantenha a fonte “Post/Term/User/Object Data” . No menu suspenso Campo de objeto , role para baixo até a seção API REST e selecione o metacampo necessário cujos dados você deseja exibir.

Primeiro, escolhemos o metacampo “nome”.

Em seguida, duplicamos o widget e escolhemos o metacampo “data”. Para os tipos de metacampo “Data”, você pode ativar a alternância de saída do campo Filtro e escolher o retorno de chamada “Formatar data” para personalizar o formato da data.

Leia sobre Personalização do formato de hora e data .

Saiba mais sobre os retornos de chamada de campo dinâmico .

A imagem pode ser exibida de duas maneiras. A primeira é colocar o widget Dynamic Image e escolher o metacampo “Media” (“imagem”, no nosso caso) necessário na seção REST API como Source .

Como segunda forma, para o widget Campo Dinâmico , escolhemos o metacampo “imagem”, habilitamos a alternância de saída Personalizar campo e inserimos “<img src=’%s’/>” na área de texto Formato do campo .

Ajuste outras configurações do modelo de listagem e clique no botão “ Atualizar ”.

Para colocar a listagem, abra a página necessária no Elementor, bloco WordPress ou editor Bricks, coloque a Listing Grid lá e escolha a LISTING recentemente criada no menu suspenso.

Os eventos em nosso bloco Listing Grid são exibidos em ordem crescente por datas.

Defina as configurações da página e da grade de listagem e clique no botão “ Publicar/Atualizar ”.