O InspectWP WordPress Connector permite que o teu projeto receba um instantâneo de saúde diário a partir de dentro da tua instalação WP — dados impossíveis de detetar do exterior através do crawl. O conector não analisa nada por si só; apenas envia ao InspectWP uma lista estritamente limitada de métricas técnicas. Este guia acompanha-te no download, na instalação, no emparelhamento, nos dados que recolhemos e na desconexão.
1. Baixar e instalar o plugin
O InspectWP WordPress Connector não está no diretório público do WordPress.org — baixa-lo diretamente do InspectWP e carrega-lo no teu site.
- Abre a página de download do conector e clica em Baixar plugin conector (ZIP). Não precisas de descompactar o ficheiro.
- No WordPress, vai a Plugins → Adicionar novo → Carregar plugin.
- Seleciona o ZIP baixado, clica em Instalar agora e depois em Ativar plugin.
- Encontrarás o novo menu em Ferramentas → InspectWP Connector.
2. Gerar um código de emparelhamento no InspectWP
- Abre o projeto que queres conectar no teu painel InspectWP.
- Clica em Conectar plugin no cartão do projeto.
- Clica em Gerar código. O código é de utilização única e expira em 10 minutos.
3. Emparelhar do lado do WordPress
- No WordPress, abre Ferramentas → InspectWP Connector e permanece no separador Connection.
- Cola o código de emparelhamento e clica em Connect.
- Pronto. O plugin agenda um instantâneo diário e um heartbeat de 6 em 6 horas.
4. Que dados são enviados
O InspectWP recolhe apenas uma lista estritamente limitada de métricas técnicas de saúde. A lista completa é mostrada no plugin em Ferramentas → InspectWP Connector → Data, juntamente com uma pré-visualização JSON ao vivo da carga exata. Nunca enviamos:
- Conteúdo de artigos, comentários, dados de clientes, corpos de e-mails
- Palavras-passe, hashes de palavras-passe, tokens de sessão
- Valores do wp-config (apenas flags booleanas como WP_DEBUG)
- E-mails ou nomes de utilizadores (apenas contagens)
O que enviamos: versão e integridade do core do WP, versões de plugins e temas e estado de atualização, configuração PHP/MySQL, flags de depuração, métricas de saúde da BD (tamanho, opções autoloaded, contagens de transients/revisões/spam), flags de configuração (prefixo de BD predefinido, salts predefinidos, FS_METHOD), saúde do cron (tarefas em atraso).
5. Agendamento e fiabilidade
O plugin usa o WP-Cron. Em sites com pouco tráfego, o WP-Cron pode disparar com atraso ou nem sequer disparar. Se um instantâneo diário não chegar a tempo, o backend do InspectWP marca a ligação como obsoleta. Podes consultar o próximo instantâneo e heartbeat agendados a qualquer momento em Ferramentas → InspectWP Connector → Schedule. A solução recomendada em sites de produção é um verdadeiro cron de Linux a chamar wp-cron.php.
6. Sincronização manual
Podes enviar um instantâneo a pedido através do botão Sync now no separador Connection (também disponível no separador Schedule). Útil logo após o emparelhamento para verificar se tudo funciona, ou após uma atualização para enviar um estado fresco ao InspectWP.
7. Desconectar
Duas formas:
- A partir do WordPress: abre Ferramentas → InspectWP Connector → Connection e clica em Disconnect. O plugin instrui o backend do InspectWP a revogar esta ligação, limpa as credenciais locais e para as tarefas cron.
- A partir do InspectWP: no cartão do projeto, clica em Desconectar. O token de ligação torna-se inválido; o plugin receberá um 401 na próxima tentativa de sincronização.
Em ambos os casos, os instantâneos já entregues permanecem visíveis no InspectWP. Se voltares a conectar mais tarde, os instantâneos históricos reaparecem.
8. Perguntas frequentes
O plugin torna o meu site mais lento? Não. Só é executado no cron diário e ao clicar explicitamente em «Sync now» — sem carga no frontend, sem carga na administração para além do separador de definições.
Posso usar uma conta InspectWP para vários sites? Sim. Cada site WP é emparelhado com um projeto InspectWP específico. Uma conta InspectWP pode ter muitos projetos e, por isso, muitos sites conectados.
E se perder o código de emparelhamento? Gera um novo. O anterior expira automaticamente após 10 minutos de qualquer forma.
Como atualizo o plugin? Quando houver uma nova versão disponível, baixa o ZIP mais recente da página de download do conector e volta a carregá-lo no WordPress. A tua ligação mantém-se intacta entre atualizações.