Installare Stats4U su un sito statico senza esporre l’accesso privato

Un sito statico può caricare un contatore Stats4U senza eseguire PHP o mantenere un database di visitatori sul proprio hosting. Il browser carica l’integrazione da Stats4U e il conteggio avviene lì. L’installazione funziona se HTML pubblicato, regole dell’hosting e browser del visitatore consentono le richieste necessarie.

Preparare l’integrazione pubblica

1. Per un nuovo contatore si sceglie un modello e si copia il codice generato. Un contatore esistente conserva il proprio numero. Prima di modificare il sito, il link privato di gestione va salvato al sicuro. Un contatore può funzionare senza account, ma l’accesso del proprietario richiede comunque protezione.
2. Nel modello HTML condiviso va inserito soltanto il codice pubblico, nella posizione prevista. Un generatore di siti statici deve riportare il modello nelle pagine pubblicate. Dopo la distribuzione occorre verificare l’HTML generato: modificare un componente sorgente non ne dimostra la presenza nella pagina pubblica.
3. Token del proprietario, link di gestione e chiavi API devono restare fuori da HTML e repository pubblici. Numero del contatore e opzioni grafiche pubbliche bastano per l’incorporamento normale. Prima del commit va controllato tutto il testo copiato; i segnalibri privati non sono istruzioni di installazione da pubblicare.

Usare l’integrazione supportata dall’hosting

Dove sono consentiti script esterni, il codice JavaScript generato e l’indirizzo ospitato di s4u.js permettono di ricevere aggiornamenti. Una copia scaricata resta alla versione copiata finché non viene aggiornata separatamente; modificare il sito non aggiorna automaticamente quel file.

Dove sono accettati soltanto immagini, Markdown o BBCode, si usa l’integrazione generata corrispondente. Può contare richieste di immagini; i dettagli delle pagine dipendono dall’HTTP Referer o da un indirizzo esplicito. Gli eventi automatici facoltativi richiedono JavaScript; un’immagine da sola non può osservare l’esito confermato di un modulo.

Verificare il risultato pubblicato in sicurezza

Una pagina di prova propria e autorizzata va esaminata nel pannello di rete del browser, verificando numero, codici duplicati e risorse bloccate. Content Security Policy, filtri dell’editor o estensioni possono impedire il caricamento dello script o dell’immagine. Non è opportuno disattivare ampie protezioni soltanto per visualizzare un badge.

Una normale visita può essere conteggiata. L’indirizzo dell’immagine di conteggio non va aperto manualmente né ricaricato ripetutamente per diagnosticare l’installazione. Un modello invisibile può caricarsi correttamente senza badge; prima di aggiungere altro codice solo per ottenere qualcosa di visibile, vanno controllati richieste e rapporto corrispondente.

Cosa non può osservare un contatore

Il contatore riporta richieste e misurazioni supportate che raggiungono Stats4U. Non vede tutte le richieste gestite dall’hosting statico, errori del server, download falliti o banda. Servono i registri o il monitoraggio dell’hosting, se disponibili. Un hosting statico non implica che queste informazioni siano necessariamente assenti.

Un sito statico richiede comunque contenuti aggiornati, un account di pubblicazione protetto e un’informativa privacy adeguata. Il contatore non elimina tali responsabilità. Le misurazioni facoltative di campagne o eventi vanno attivate dopo averne compreso la configurazione; il codice di base non popola tutti i rapporti avanzati.

Scegliere e pubblicare l’integrazione corretta

La guida all’installazione spiega i formati disponibili e i controlli successivi all’incorporamento.

Aprire la guida all’installazione