Um contador para sítios estáticos
O alojamento estático tornou-se, discretamente, a forma sensata de colocar um pequeno site na internet. GitHub Pages, Codeberg Pages, Neocities, ou uma pasta de ficheiros em qualquer alojamento barato: sem base de dados, sem linguagem do lado do servidor, nada para atualizar, nada que possa ser comprometido.
Tem exatamente uma lacuna. Não há nenhum registo de servidor para ler, nem forma de executar seja o que for que faça a contagem. Publica-se, e depois não se sabe se alguém visitou.
Foi para esta situação que o contador de visitas foi inventado, e é por isso que não é, de facto, obsoleto.
O que fazer
O excerto de código da página de estatísticas cola-se no HTML do site, no local onde o contador deve aparecer. É todo o procedimento. Funciona porque o contador é uma imagem e um pequeno script — duas coisas que qualquer alojamento estático serve sem saber nem querer saber o que são.
A contagem acontece no nosso servidor. O alojamento continua a ser uma pasta de ficheiros.
O script não se copia para o repositório
Este é o único conselho que justifica todo o artigo, porque os hábitos de sites estáticos empurram fortemente na direção contrária. Trazer as dependências para dentro do repositório («vendoring») é normalmente boa prática — é reprodutível, sobrevive ao desaparecimento da fonte original, e poupa um pedido.
Não o faça aqui.
Um script copiado fica congelado no momento em que foi copiado. Continua a fazer o que fazia naquele dia, para sempre, em cada visita, e nada do que seja feito na fonte original o consegue alcançar. Isto não é hipotético: quando a resolução de ecrã foi removida do contador este ano, as cópias do script antigo continuaram a enviá-la, e a única forma de acabar com essa recolha foi fazer com que o servidor recusasse o valor vindo de qualquer origem.
O mesmo aplica-se a correções de segurança, a alterações no que é enviado, e a tudo o resto que deva chegar aos visitantes de um site. O script liga-se por ligação. É um pedido, fica em cache, e mantém-se atualizado.
O que se obtém, e o que não
Obtêm-se contagens de visitantes, dias, países, navegadores, domínios de referência, as páginas mais visitadas, e uma vista em tempo real de quem está no site agora mesmo. Para um site pessoal, uma página de projeto, ou uma pequena montra online, isso é normalmente todo o conjunto de perguntas que interessam.
Não há análise de registos, porque não há registos. Não há nada sobre pedidos que falham, ficheiros que dão erro 404, ou largura de banda. Se isso for importante, o alojamento estático já era, à partida, a forma errada de resolver o problema.
Mais uma coisa que combina com sites estáticos
Nada aqui precisa de uma conta. Não há registo, nenhuma palavra-passe para guardar num repositório, nem nenhuma chave para deixar escapar num commit público — uma categoria de acidente em que os projetos de sites estáticos são invulgarmente bons.