A ligação com o Remote-Site falha

Os plugins da suite trazem consigo a área «Sites remotos» (em alemão: „Remote-Sites“): aí ligas outras instalações do WordPress através de uma palavra-passe de aplicação e comandas-as a partir daqui. Ligar, testar e remover funcionam em todos os plugins através do mesmo código partilhado, pelo que as mensagens são em toda a parte iguais. Este artigo atribui-as.

As mensagens em detalhe

• «Indica o URL (http/https), o utilizador e a palavra-passe de aplicação.» — um campo está vazio ou o endereço não começa por http:// ou https://
• «Site inacessível.» — não voltou resposta nenhuma; ao criar aparece antes «Ligação falhada:», na verificação posterior «Teste falhado:»
• «Dados de acesso recusados (verifica a palavra-passe de aplicação).» — o site de destino respondeu com 401 ou 403
• «Nenhuma resposta REST válida (código …).» — houve uma resposta, mas nenhum JSON analisável; o código indicado vem junto
• «Site não encontrado.» — a entrada em que clicaste já não consta da lista desta instalação

Criar e verificar a ligação

1. Abre a página do respetivo plugin no menu do WordPress e muda, à esquerda, no grupo «Rede», para «Sites remotos» (em alemão: „Remote-Sites“).
2. Preenche no cartão «Ligar site» os campos «URL do site», «Nome de utilizador» e «Palavra-passe de aplicação».
3. Clica em «Conectar & testar».
4. Verifica a qualquer momento, mais tarde, uma ligação existente através do botão «Testar» na tabela «Sites conectados».
5. Lê na coluna «Estado» (em alemão: „Status“) se o site está registado como «conectado», «erro» ou «não verificado».

O teste é uma chamada autenticada da rota de utilizadores do próprio WordPress no site de destino. Dispõe de 20 segundos e não segue redirecionamentos. São tentadas duas formas de endereço: primeiro a forma com rest_route, que funciona com qualquer definição de ligações permanentes, depois o caminho por /wp-json/. Só conta como sucesso uma verdadeira resposta JSON. De seguida, o teste vai buscar o nome do site pela rota raiz; se isso não resultar, fica o nome de anfitrião na lista.

Teste verde e mesmo assim a ação falha

• As ações ao lado de cada site chamam rotas próprias do site de destino: «Estado remoto» e «Backup remoto» no plugin Backup, «Estado» e «Limpar cache» no Performance, «Enviar config» no Consent, «Estado de segurança» no Security, «Estado do SEO» no SEO, «Obter estatísticas» no Analytics, «Estado das funções» no Roles e «Estado da origem» no Media
• Estas rotas exigem no site de destino a permissão manage_options — a palavra-passe de aplicação tem, portanto, de pertencer a uma conta com direitos de administrador
• O respetivo plugin tem de estar instalado e ativo no site de destino. Caso contrário, a ação falha: as consultas como «Estado remoto», «Obter estatísticas» ou «Estado da origem» (em alemão: „Fernstatus“, „Statistik abrufen“, „Herkunfts-Stand“) indicam que não é acessível („… nicht abrufbar“) com o código de resposta; «Backup remoto», «Limpar cache» e «Enviar config» (em alemão: „Fern-Backup“, „Cache leeren“, „Config senden“) indicam uma falha („… fehlgeschlagen:“) com a resposta do site de destino ou o seu código
• O facto de «Testar» dar verde diz apenas que o endereço e os dados de acesso estão certos — sobre o plugin do outro lado não diz nada
• No plugin Analytics, a área «Sites remotos» (em alemão: „Remote-Sites“) só aparece para administradores