Instalar o Stats4U num site estático sem expor o acesso privado

Um site estático pode carregar um contador Stats4U sem executar PHP ou manter uma base de dados de visitantes no próprio alojamento. O navegador carrega a integração a partir do Stats4U e a contagem acontece aí. O funcionamento depende do HTML publicado, das regras do alojamento e de o navegador permitir os pedidos necessários.

Preparar a integração pública

1. Para um contador novo, escolhe-se um modelo e copia-se o código gerado. Um contador existente mantém o número. Antes de editar o site, convém guardar em segurança a ligação privada de gestão. Um contador pode funcionar sem conta, mas o acesso do proprietário continua a precisar de proteção.
2. No modelo HTML partilhado deve ficar apenas a incorporação pública, na localização prevista. Um gerador de sites estáticos tem de transportar esse modelo para as páginas publicadas. Após a publicação, é necessário verificar o HTML gerado: editar um componente de origem não prova que exista na página pública.
3. O token do proprietário, a ligação de gestão e as chaves API devem ficar fora do HTML e dos repositórios públicos. O número e as opções públicas de apresentação bastam para a incorporação normal. Convém rever todo o texto copiado antes de confirmar as alterações; os marcadores privados não devem ser publicados como instruções de instalação.

Usar a integração suportada pelo alojamento

Quando são permitidos scripts externos, o código JavaScript gerado e o endereço alojado de s4u.js permitem receber atualizações. Uma cópia descarregada mantém a versão copiada até ser atualizada separadamente; alterar o site não atualiza automaticamente esse ficheiro.

Quando só são aceites imagens, Markdown ou BBCode, usa-se a integração gerada correspondente. Pode contar pedidos de imagens; os detalhes das páginas dependem do HTTP Referer ou de um endereço explícito. Os eventos automáticos opcionais exigem JavaScript; uma imagem, por si só, não observa o resultado confirmado de um formulário.

Verificar o resultado publicado em segurança

Uma página de teste própria e autorizada deve ser inspecionada no painel de rede do navegador, verificando número, código duplicado e recursos bloqueados. Content Security Policy, filtros do editor ou extensões podem impedir o carregamento do script ou da imagem. Não convém desativar proteções abrangentes apenas para apresentar um distintivo.

Uma visita normal pode contar. O endereço da imagem de contagem não deve ser aberto manualmente nem atualizado repetidamente para diagnóstico. Um modelo invisível pode carregar corretamente sem distintivo; convém verificar os pedidos e o relatório correspondente em vez de acrescentar código apenas para obter algo visível.

O que um contador não pode observar

O contador apresenta pedidos e medições suportadas que chegam ao Stats4U. Não vê todos os pedidos tratados pelo alojamento estático, erros do servidor, transferências falhadas ou largura de banda. São necessários os registos ou a monitorização do alojamento, quando disponíveis. O alojamento estático não implica a indisponibilidade dessas informações.

Um site estático continua a precisar de conteúdos mantidos, uma conta de publicação protegida e um aviso de privacidade adequado. O contador não elimina essas responsabilidades. As medições opcionais de campanhas ou eventos devem ser ativadas após compreensão da configuração; instalar o código básico não preenche todos os relatórios avançados.

Escolher e publicar a integração correta

O guia de instalação explica os formatos disponíveis e as verificações após a incorporação.

Abrir o guia de instalação