Stats4U w witrynie statycznej bez ujawniania prywatnego dostępu

Witryna statyczna może ładować licznik Stats4U bez uruchamiania PHP ani utrzymywania bazy odwiedzających na własnym hostingu. Przeglądarka ładuje integrację ze Stats4U i tam odbywa się zliczanie. Poprawna instalacja nadal wymaga, by opublikowany HTML, zasady hostingu i przeglądarka odwiedzającego pozwalały na potrzebne żądania.

Przygotowanie publicznej integracji

1. Dla nowego licznika należy wybrać wygląd i skopiować wygenerowany kod. W przypadku istniejącego licznika trzeba zachować jego numer. Przed edycją witryny należy bezpiecznie zapisać prywatny link do zarządzania. Licznik może działać bez konta, choć dostęp właściciela nadal wymaga ochrony.
2. We wspólnym szablonie HTML należy umieścić wyłącznie publiczne osadzenie w miejscu przeznaczonym na licznik. Generator witryny statycznej musi przenieść ten szablon do opublikowanych stron. Po wdrożeniu trzeba sprawdzić wygenerowany HTML; edycja komponentu źródłowego nie dowodzi jego obecności na działającej stronie.
3. Token właściciela, link do zarządzania i klucze API nie powinny trafić do publicznego HTML ani repozytoriów. Zwykłe osadzenie wymaga tylko numeru licznika i publicznych opcji wyglądu. Przed zatwierdzeniem zmian należy przejrzeć cały skopiowany tekst; prywatne zakładki nie powinny być publikowane jako instrukcje instalacji.

Integracja obsługiwana przez hosting

Jeśli dozwolone są zewnętrzne skrypty, należy użyć wygenerowanego kodu JavaScript i hostowanego adresu s4u.js. Dzięki temu aktualizacje docierają do integracji. Pobrana kopia pozostaje w skopiowanej wersji do czasu osobnej aktualizacji; zmiana witryny nie aktualizuje tego pliku automatycznie.

Gdy akceptowane są tylko obrazy, Markdown lub BBCode, należy użyć odpowiedniej wygenerowanej integracji. Może ona zliczać żądania obrazów, natomiast szczegóły stron zależą od HTTP Referer lub jawnie przekazanego adresu. Opcjonalne zdarzenia automatyczne wymagają JavaScript; sam obraz nie rozpoznaje potwierdzonego wyniku formularza.

Bezpieczne sprawdzenie opublikowanego wyniku

Własną stronę testową, do której istnieją uprawnienia, należy sprawdzić w panelu sieciowym przeglądarki. Kontrola obejmuje numer licznika, powielone fragmenty kodu i zablokowane zasoby. Content Security Policy, filtrowanie edytora lub rozszerzenie przeglądarki mogą blokować skrypt albo obraz. Nie należy wyłączać szerokich zabezpieczeń tylko po to, by wyświetlić licznik.

Zwykła wizyta na stronie może zostać zliczona. Nie należy ręcznie otwierać adresu obrazka licznika ani wielokrotnie go odświeżać w ramach diagnostyki. Niewidoczny wzór może ładować się prawidłowo bez wyświetlania obrazka; zamiast dodawać kolejny kod dla uzyskania widocznego efektu, należy sprawdzić żądania i odpowiedni raport.

Czego licznik nie może obserwować

Licznik raportuje żądania i obsługiwane pomiary, które docierają do Stats4U. Nie widzi każdego żądania obsłużonego przez hosting statyczny, błędów serwera, nieudanych pobrań ani zużycia transferu. Wymaga to logów hostingu lub jego monitoringu, jeśli są dostępne. Hosting statyczny nie oznacza, że takie informacje muszą być niedostępne.

Witryna statyczna nadal potrzebuje aktualizowanych treści, chronionego konta publikowania i odpowiedniej informacji o prywatności. Licznik nie znosi tych obowiązków. Opcjonalny pomiar kampanii lub zdarzeń należy włączać dopiero po zrozumieniu konfiguracji; instalacja podstawowego kodu nie wypełnia wszystkich zaawansowanych raportów.

Wybór i publikacja właściwej integracji

Poradnik instalacji wyjaśnia dostępne formaty kodu i kontrole po osadzeniu.

Poradnik instalacji