Como adicionar e editar itens de tipo de conteúdo personalizado remotamente usando API REST

Por exemplo, vamos supor que você tenha vários sites e aplicativos onde os usuários podem assinar as notícias da sua empresa. Para reunir todos esses assinantes em uma tabela, você teria que visitar cada site separadamente e mover os dados manualmente para um armazenamento.

O plugin REST API permite que você agilize suficientemente esse processo. Você pode criar um tipo de conteúdo personalizado “Assinantes” em seu site principal e criar um ponto de acesso (chamado Endpoint) para ele por meio da API REST. Depois disso, você pode criar formulários simples em outras fontes e vinculá-los ao Assinantes CCT. Os dados que os usuários adicionam ao formulário serão armazenados como um item CCT, que é fácil de listar e usar posteriormente.

Abra o painel do seu site, vá para JetEngine > Tipo de conteúdo personalizado e clique no botão “ Adicionar novo ”. Escolha o nome, o ícone do menu e a posição do CCT, bem como a capacidade de acesso. Se precisar de mais detalhes, confira nosso tutorial de criação de tipo de conteúdo personalizado .

Registrar CREATE item REST API Endpoint

Ative a alternância Registrar CREATE item REST API Endpoint . Você precisará ainda mais do URL do endpoint , então salve-o em algum lugar. No campo Capacidade de Acesso , escolha quem poderá utilizar o Endpoint. Por exemplo, poderia ser “edit_posts”, que concederá acesso aos usuários que podem editar postagens – editores e administradores.

Adicione todos os metacampos necessários na seção Campo e clique no botão “ Adicionar tipo de conteúdo ” no lado direito da janela.

Registrar UPDATE item REST API Endpoint

Se quiser dar aos visitantes a oportunidade de editar os itens, você deve levar em consideração alguns detalhes:

• A funcionalidade de atualização não permite editar os dados existentes, mas sim reescrevê-los. O usuário deverá preencher novamente todos os campos, e as novas informações substituirão as antigas;
• Você terá que adicionar um campo adicional ao formulário que permitirá ao usuário escolher qual item deseja atualizar;
• Para mostrar ao usuário a lista de itens disponíveis, você terá que criar uma listagem separada. Siga este tutorial se não souber como criá-lo;
• Você terá que criar um formulário separado para a funcionalidade UPDATE. Não é possível combinar solicitações para diferentes URLs da API REST em um único formulário.

Registrar DELETE item REST API Endpoint

Este Endpoint só pode ser usado por meio de um aplicativo separado. Você não poderá excluir itens CCT usando um formulário em outro site. Junto com todos os outros endpoints da API REST, será útil se você quiser criar um aplicativo móvel. Nesse caso, utilizará o seu site como banco de dados.

Acesse o site ao qual deseja adicionar o formulário, abra o painel e prossiga para JetEngine > JetEngine Dashboard > Modules . Role a página para baixo e ative a alternância Listagens da API REST . Depois, vá para JetEngine > JetEngine Dashboard > guia REST API Endpoints e clique no botão “ New Endpoint ”. 

Depois de nomear o Endpoint, cole o URL do campo Endpoint URL no API Endpoint URL . Se você alterou a capacidade de acesso , ative o botão Autorização .

Você também precisaria definir as senhas do aplicativo. Vá para a guia Usuários > Perfil WordPress e role para baixo até o título Senhas de aplicativos .

Insira qualquer nome no campo Nome da nova senha do aplicativo e clique no botão Adicionar nova senha do aplicativo” .

Copie a nova senha e salve-a em algum lugar.

Retorne ao endpoint de customização. Em Tipo de Autorização , escolha a opção “Senha do Aplicativo” e insira o nome de usuário e senha obtidos anteriormente no campo User:password string .

Clique no botão “ Enviar solicitação ” e clique no botão “ Salvar ” assim que a conexão for estabelecida.

Você pode receber um erro se não houver itens no CCT conectado, então crie alguns itens anteriormente.

Criar formulário

Agora, vá para o submenu JetEngine> Formulários , clique no botão “ Adicionar Novo ” e nomeie o formulário.

Você terá que adicionar tantos campos de formulário quantos metacampos no CCT de assinantes. Clique no botão “ Adicionar Campo ” e crie todos os campos necessários. Se precisar de uma dica, siga nosso tutorial de criação de formulários .

Criar solicitação

Quando os campos do formulário estiverem prontos, role a página para baixo até a seção Ações pós-envio/Configurações de notificação , pressione “ Adicionar notificação ” e depois “ Editar ”. No menu suspenso Tipo , escolha a opção “Solicitação de API REST”.

Cole o URL do terminal no campo URL da API REST . Você pode usar macros se precisar.

A área de texto do corpo personalizado é para o código JSON da solicitação. Aqui você precisa definir as conexões entre os campos do formulário e os metacampos CCT. Na descrição colocada no lado direito da área de texto, há um link para a ferramenta de edição online – abra-a.

Exclua as linhas de 2 a 14 e use este código:

"CCT_field_ID" : "macros"

Em vez da CCT_field_IDparte “”, você deve colocar os IDs de todos os metacampos do tipo de conteúdo personalizado. 

Em vez da macrosparte “”, você deve inserir os nomes dos campos do formulário correspondentes. Eles estão listados ao lado do campo URL da API REST .

O resultado deve ficar assim, onde “idade”, por exemplo, é o nome do metacampo do site principal e “%idade%” é a macro com o nome do campo do formulário:

Se você definiu uma autorização anteriormente, marque a caixa de seleção Autorização na parte inferior da janela de notificação de solicitação da API REST . Escolha a opção “Senhas do aplicativo” no campo Tipo de autorização e cole o nome de usuário e a senha como fez na área de texto User:password string .

Não se esqueça de clicar nos botões “ Aplicar alterações ” e “ Publicar ” quando terminar.

Coloque o formulário em qualquer página, preencha os campos e clique no botão Enviar” . Verifique se o novo item aparece no site principal.

Criar formulário

O processo é basicamente o mesmo do item UPDATE REST API Endpoint. Vá para JetEngine > Formulários e clique no botão “ Adicionar Novo ”. Nomeie o formulário e adicione os campos que corresponderão aos metacampos do CCT. Para uma descrição mais detalhada, consulte nosso tutorial de criação de formulário .

Além disso, será necessário criar um campo adicional onde o usuário deverá escolher o número de identificação do item que deseja editar. Pode ser um campo de formulário do tipo Número ou qualquer outro tipo que você achar adequado, mas esteja ciente de que ele deve conter um valor numérico.

Adicionar solicitação

Vá para a seção Ações pós-envio/Configurações de notificação e clique no botão “ Adicionar notificação ”. Depois, clique no botão “ Editar ”.

Selecione a opção “Solicitação de API REST” no menu suspenso Tipo . Cole o UPDATE Endpoint URL no campo REST API URL . Ao invés da parte “{_ID}”, insira o código da macro do campo do formulário onde os usuários irão escolher o ID do item.

A área de texto Corpo Personalizado deve ser preenchida com o código personalizado que conecta os campos do formulário e os campos CCT. O algoritmo é o mesmo da solicitação CREATE Endpoint.

Quando terminar, clique nos botões “ Aplicar alterações ” e depois “ Publicar ”.

É hora de colocar o formulário na página. Vá para o painel e encontre a página onde deseja colocar o formulário. Abra-o com o construtor de páginas Elementor ou editor Gutenberg e encontre o widget/bloco Form . Adicione-o à página. No menu suspenso Selecionar formulário , escolha o formulário que você acabou de criar.

No Elementor, ficará assim:

E em Gutenberg assim:

Personalize-o com a ajuda das ferramentas disponíveis na aba do menu Estilo (Elementor) ou na seção Estilo de Bloco (Gutenberg) e clique no botão “ Atualizar ”. Abra a visualização da primeira página e preencha o formulário com algum conteúdo.

Acesse o site onde você criou o CCT. Abra a guia do tipo de postagem personalizada criada e verifique as atualizações. Você verá um novo item com valores semelhantes aos inseridos no formulário.