O WordPress é o seu próprio site e não a rede de outra pessoa, por isso a ligação funciona de forma diferente de todos os outros canais: não há nenhuma aplicação do Ocoya para aprovar num serviço central. Liga-se com uma palavra-passe de aplicação, que o WordPress emite precisamente para isto e que pode revogar a qualquer momento sem alterar a sua própria palavra-passe.
Antes de começar
Três coisas têm de se verificar no site:
- É acessível por https. Uma palavra-passe de aplicação não pode ser enviada em segurança por http, por isso o Ocoya recusa sites http.
- A sua REST API está acessível. Alguns plugins de segurança desativam-na ou bloqueiam-na.
- O utilizador que liga tem a função Author, Editor ou Administrator. As funções inferiores não podem publicar.
Ligar o WordPress
Há duas formas de entrar. Ambas terminam na mesma ligação.
Abra Channels e escolha WordPress
Selecione Channels, depois Connect channel, e escolha WordPress — está listado em Blogging.
Introduza o endereço do seu site
Escreva o endereço do site, como https://example.com. O Ocoya usa-o para encontrar a REST API do site.
Aprove no seu próprio site ou cole uma palavra-passe
O Ocoya pode enviá-lo para o ecrã Authorize application do seu site, onde o WordPress cria a palavra-passe e a devolve. Se preferir não ser redirecionado, gere uma você mesmo em Users → Profile → Application Passwords e cole-a juntamente com o seu nome de utilizador.
A revogação faz-se no seu site: elimine a palavra-passe de aplicação em Users → Profile e o Ocoya deixa de poder aceder-lhe. A ligação chama-se Ocoya nesse ecrã, por isso é claro qual remover.
O que pode publicar
| Tipo de publicação | Suportado |
|---|---|
| Texto | Sim — obrigatório |
| Título | Opcional |
| Imagens | Sim — até 10 |
| GIF | Sim |
| Vídeo | Não |
As publicações são feitas em direto, não como rascunhos no site.
Sem vídeo. Um site WordPress pode alojar um, mas com tamanhos e codificações que dependem do limite de carregamento do seu próprio site e não de uma publicação agendada — por isso o Ocoya recusa-o em vez de falhar a meio do carregamento.
O título
Cada publicação do WordPress tem um título, mas não é obrigado a escrever um. Deixe o campo vazio e o Ocoya usa a primeira linha da sua legenda no momento da publicação.
É essa a diferença em relação ao DEV.to, onde o campo é obrigatório no compositor: aqui, nada é rejeitado por falta de título.
As imagens vão para a sua biblioteca de multimédia
As imagens são carregadas para a biblioteca de multimédia do próprio site, em vez de ligadas a partir do Ocoya. Duas consequências que vale a pena conhecer:
- A publicação mantém as suas imagens depois de substituir ou eliminar o criativo no Ocoya.
- Aparecem na sua biblioteca, onde esperaria encontrá-las.
As imagens ficam no fim do corpo, não no espaço da imagem de destaque. Esse espaço contém uma única capa que o seu tema recorta à sua maneira — só uma imagem sobreviveria, colocada num sítio que não escolheu. No corpo, todas as imagens sobrevivem com as suas próprias proporções.
Limites do WordPress
| Título | 200 caracteres, opcional |
| Corpo | 100 000 caracteres |
| Imagens | 10 |
| Vídeo | Não suportado |
O WordPress guarda o corpo numa coluna de texto e não impõe nenhum limite de comprimento próprio, por isso o limite do corpo é uma barreira de segurança do Ocoya. O número de imagens também é nosso — o limite real do seu site é o tamanho de carregamento, que só ele conhece.
Problemas comuns
“WordPress sites must be connected over https.” O endereço do site é http. Uma palavra-passe de aplicação não pode ser enviada em segurança por esse protocolo.
“Your WordPress site did not return a REST API response. The REST API may be disabled or blocked by a security plugin.” Algo no site está a bloquear /wp-json. Os plugins de segurança e de firewall são a causa habitual.
“This WordPress user is not allowed to publish posts. Connect a user with the Author, Editor or Administrator role.” A função do utilizador ligado é demasiado baixa.
“WordPress posts require text.” A publicação tem imagens mas não tem corpo.
“WordPress did not store the uploaded image.” O carregamento da multimédia foi recusado — normalmente por causa do limite de tamanho do próprio site ou de um tipo de ficheiro que este não aceita.
“Connection to your profile has expired. Please reconnect.” A palavra-passe de aplicação foi revogada ou alterada. Gere uma nova e volte a ligar. Veja Voltar a ligar um canal.