Plugin WordPress de Visitantes em Tempo Real

Visitantes Ativos Agora — O Pulso Inteligente do Teu Website

No universo de zeros e uns, cada visitante é um batimento de luz. O plugin “Visitantes Ativos Agora” (versão 3.6) foi desenvolvido para tornar visível o ritmo real de um site — quantos humanos o habitam neste instante, e quantos robôs o rondam.

⚙️ O que faz

Este plugin acrescenta ao painel administrativo do WordPress um dashboard widget e uma página dedicada no menu lateral, oferecendo:

• Contador em tempo real de visitantes humanos e bots.
• Gráfico dinâmico (via Chart.js) mostrando apenas os visitantes humanos ativos nos últimos cinco minutos.
• Atualização automática a cada 10 segundos.
• Limpeza automática de registos com mais de 24 horas.

🧠 Deteção Inteligente

A versão 3.6 introduz uma camada de análise inteligente que distingue humanos de robôs através do cabeçalho User-Agent.
Termos como bot, spider, crawl, wget ou bingpreview são automaticamente identificados e classificados como acessos automáticos.
Assim, o administrador vê no topo: 👤 Humanos: X | 🤖 Bots: Y, enquanto o gráfico exibe apenas o tráfego humano — o verdadeiro pulso do site.

🔒 Estrutura e Privacidade

Para garantir desempenho e anonimato, o plugin utiliza uma tabela dedicada de registo mínima e segura:

CREATE TABLE wp_visitas_ativas (
  id_hash VARCHAR(64) NOT NULL,
  ultimo_acesso INT(11) NOT NULL,
  tipo VARCHAR(10) DEFAULT 'humano',
  PRIMARY KEY (id_hash)
);
  

O campo id_hash é uma assinatura anónima gerada por md5(IP + User-Agent).
Nenhum endereço IP é guardado, apenas um identificador único, garantindo total conformidade com as boas práticas de privacidade.

⚡ Desempenho e Robustez

O registo é efetuado com $wpdb->replace(), evitando duplicações e mantendo a tabela sempre leve.
A limpeza automática remove entradas antigas (mais de 24h) e o sistema é compatível com cache, proxies e CDNs como Cloudflare ou Nginx reverso.

🔧 Instalação

1. Descarrega o ficheiro wp-visitas-ativos-v3_6.zip.
2. Em WordPress → Plugins → Adicionar novo → Carregar plugin.
3. Ativa-o e acede ao novo menu “Visitantes Ativos”.

Imediatamente o painel exibirá o número de humanos e bots ativos, e um gráfico com o histórico recente.
Uma leitura instantânea e visual da vitalidade do teu site.

💡 Para Desenvolvedores

O código é limpo, modular e extensível. O hook shutdown garante execução mesmo em temas sem wp_footer(), e o modo de depuração cria registos em wp-content/debug-visitas.log quando o WP_DEBUG está ativo.
A função get_client_ip_from_headers() identifica o IP real mesmo atrás de proxies ou redes privadas.

“Cada visitante é uma partícula de tempo, e cada acesso, um eco de curiosidade. Ver o pulso é compreender a vida digital que criámos.”

✍️ Francisco Gonçalves — SofteLabs / Fragmentos do Caos