O que você vai montar
Com o WordPress conectado, cada artigo gerado no ClickHunt vai direto para o seu site, com imagens, capa, categorias, tags e autor, sem copiar e colar. A conexão usa uma senha de aplicativo do próprio WordPress: não precisa instalar plugin nenhum.
Disponível em todos os planos. Só o dono ou um administrador do projeto consegue configurar.
Antes de começar
- WordPress instalado no seu servidor (o chamado WordPress.org), versão 5.6 ou mais nova. Sites no WordPress.com não são suportados.
- Site com HTTPS (endereço começando com
https://). Sem HTTPS, o WordPress esconde a opção de senha de aplicativo. - Um usuário com perfil Autor, Editor ou Administrador. Os perfis Colaborador e Assinante não podem publicar nem enviar imagens.
Passo 1: gere a senha de aplicativo no WordPress
- Entre no painel do seu WordPress (
seusite.com/wp-admin) com o usuário que vai assinar a conexão. - No menu lateral, clique em Usuários › Perfil.
- Role a página até o fim, até a seção Senhas de aplicativo (em inglês, Application Passwords).
- No campo Nome da nova senha de aplicativo, digite
ClickHunt. - Clique em Adicionar nova senha de aplicativo.
- O WordPress mostra uma senha com 24 caracteres em grupos de 4, parecida com
abcd EFGH 1234 ijkl MNOP 5678. Copie agora: ela aparece uma única vez. Pode copiar com os espaços, o ClickHunt tira sozinho.
Essa senha não é a sua senha de login. Ela serve só para o ClickHunt, e você pode revogá-la a qualquer momento nessa mesma tela, sem mexer na sua senha.
Não achou a seção Senhas de aplicativo? Quase sempre é um destes motivos:
- o site não está em HTTPS;
- um plugin de segurança (Wordfence, iThemes Security, All In One WP Security, etc.) desligou o recurso. Procure a opção "Application Passwords" nas configurações do plugin e ative;
- a hospedagem desativou a REST API do WordPress. Peça para liberar.
Passo 2: cole a chave no ClickHunt
- No projeto, abra Configurações › Integrações, seção Hospedagem.
- No card WordPress, clique no ícone de engrenagem (Configurar).
- Preencha os três campos:
- Endereço do site: a URL onde o WordPress está instalado, com
https://. Ex.:https://seusite.com. Se o WordPress está numa pasta, comohttps://seusite.com/blog, coloque com a pasta. Se você colar o endereço com/wp-adminno fim, o ClickHunt corrige sozinho. - Usuário do WordPress: o mesmo usuário com que você entra no painel (o nome de usuário, ou o e-mail).
- Credencial do aplicativo (API key): a senha de aplicativo copiada no passo 1.
- Endereço do site: a URL onde o WordPress está instalado, com
- Clique em Conectar. O status fica Verificando por alguns segundos e depois passa para Pronto para ativar.
Atenção ao www: o endereço precisa ser exatamente o que o seu WordPress usa. Se o site abre em https://www.seusite.com, use com www.
Passo 3: torne o WordPress o destino dos artigos
Conectar a credencial não muda nada ainda. Para os próximos artigos irem para o WordPress:
- No mesmo card WordPress, clique em Conectar (o botão principal, fora da engrenagem).
- Confirme em Conectar o WordPress?.
- O card passa para Conectado.
Se o seu blog estava no ClickHunt, ele sai do ar e os próximos artigos vão para o WordPress. Nada é apagado: você pode voltar quando quiser.
O que acontece depois de conectado
- Publicação. Ao publicar no ClickHunt, o post é criado publicado no WordPress. As mudanças podem levar até 5 minutos para aparecer.
- Agendamento. Quem agenda é o ClickHunt. No dia e hora marcados, o post é publicado no WordPress. Lá ele não aparece como "Agendado".
- Rascunho. Um rascunho com título no ClickHunt também nasce como rascunho no WordPress.
- Edição. Salvar o artigo de novo no ClickHunt atualiza o mesmo post, sem duplicar.
- Exclusão. Excluir o artigo no ClickHunt manda o post para a lixeira do WordPress. Nada é apagado de vez.
- Corpo do texto. Vai em blocos nativos do editor do WordPress (Gutenberg).
- Imagens. Vão para a Biblioteca de mídia. A capa vira a imagem destacada.
- Categorias. São ligadas pelo nome às categorias que já existem no seu WordPress. O ClickHunt não cria categoria nova: se faltar, o artigo sai sem ela e aparece um aviso. Crie a categoria no WordPress com o mesmo nome.
- Tags. São criadas se não existirem.
- Autor. O ClickHunt procura no WordPress um autor com o mesmo nome. Se não achar, o post sai assinado pelo usuário da conexão. Para assinar com o nome certo, crie o usuário com esse nome no WordPress.
- Uma via só. O que você edita direto no WordPress não volta para o ClickHunt e pode ser sobrescrito na próxima vez que o artigo for salvo aqui.
Na lista de conteúdos, cada artigo mostra Enviando ao WordPress, No WordPress ou Falha no envio, com o botão Tentar de novo.
Mensagens de erro
| Mensagem | O que fazer |
|---|---|
| Usuário ou senha de aplicativo inválidos | Confira o usuário, gere uma senha de aplicativo nova e cole de novo. Confira também o www no endereço. |
| O firewall do site está bloqueando o acesso do ClickHunt | O Cloudflare ou um plugin de segurança barrou a conexão. Peça a quem cuida do site para liberar o caminho /wp-json/. No Cloudflare: desligue o Bot Fight Mode ou crie uma regra que libere /wp-json/. Depois clique em Verificar de novo. |
| A REST API do WordPress não foi encontrada nesse endereço | Confira a URL do site e se algum plugin de segurança desligou a REST API. |
| Este usuário do WordPress não tem permissão para publicar artigos (ou para enviar arquivos) | Use um usuário Autor, Editor ou Administrador. |
| O site recusou o envio de alguma imagem | O artigo foi publicado, mas a hospedagem barrou a imagem (muito comum com imagens WebP e o ModSecurity). Peça à hospedagem para liberar o upload de imagens pela REST API. |
| Não foi possível conectar a este site agora | O site estava fora do ar ou lento. Tente de novo em alguns minutos. |
Perguntas frequentes
Os artigos que já publiquei no ClickHunt vão para o WordPress? Só os que forem publicados ou salvos depois que o WordPress virar o destino.
Posso usar o meu usuário administrador? Pode. Se preferir, crie um usuário Editor só para o ClickHunt: fica mais fácil de identificar e de revogar.
Como desconecto? Na engrenagem do card, clique em Desconectar. A credencial é apagada e os próximos artigos deixam de ir para lá. O que já foi publicado continua no ar. Para cortar o acesso pelo lado do WordPress, revogue a senha em Usuários › Perfil › Senhas de aplicativo.