Blokowanie skryptów

Automatyczne blokowanie (domyślne)

W trybie automatycznym CookieHug wykrywa i blokuje skrypty firm trzecich, ramki iframe i piksele śledzące za pomocą dopasowania hostname i MutationObserver. Observer monitoruje zarówno nowe elementy DOM, jak i zmiany atrybutu src na istniejących elementach. Znane domeny śledzące są automatycznie kategoryzowane (statystyki, marketing, preferencje) i blokowane do momentu uzyskania zgody.

Dopasowanie hostname: Wzorce są dopasowywane do hostname z URL (nie do pełnego URL), co zapobiega fałszywym trafieniom — np. segment.com nie zablokuje przypadkowo my-segment.com. Wzorce zawierające ścieżkę (np. facebook.com/tr) są dopasowywane do pełnego URL. Względne URL-e (skrypty first-party) nigdy nie są blokowane.

Obsługiwane usługi obejmują: Google Analytics (w tym region1), Google Tag Manager, Google Ads, Meta/Facebook Pixel, TikTok, Snapchat, LinkedIn, Twitter/X, Pinterest, Bing Ads, Reddit, Quora, Amazon Ads, Hotjar, Clarity, Plausible, Matomo, Amplitude, FullStory, Mouseflow, Fathom, Datadog RUM, LogRocket, YouTube, Vimeo, Google Maps, Intercom, Crisp, LiveChat, Tawk.to, Drift, HubSpot, Zendesk, Freshworks i inne.

Skrypty na białej liście (np. jQuery, Bootstrap, popularne biblioteki CDN) nigdy nie są blokowane.

Ważne: Skrypt CookieHug musi być umieszczony w <head> przed skryptami firm trzecich. Skrypty załadowane przed CookieHug nie mogą być wstecznie zablokowane.

Ręczne oznaczanie skryptów

Użyj data-cookiehug-consent, aby ręcznie kontrolować, które skrypty wymagają zgody. Ustaw type skryptu na text/plain, aby zapobiec wykonaniu przed uzyskaniem zgody.

<!-- Skrypt statystyczny (zewnętrzny) -->
<script type="text/plain" data-cookiehug-consent="statistics"
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXX">
</script>

<!-- Skrypt marketingowy (inline) -->
<script type="text/plain" data-cookiehug-consent="marketing">
  fbq('init', '123456789');
  fbq('track', 'PageView');
</script>

<!-- Skrypt preferencji -->
<script type="text/plain" data-cookiehug-consent="preferences"
  src="https://cdn.example.com/chat-widget.js">
</script>

Kategorie zgód

Zastępniki zablokowanych elementów

Gdy CookieHug blokuje iframe (wideo, mapę, osadzenie społecznościowe, widget czatu), automatycznie zastępuje go stylowanym zastępnikiem, który wyświetla odpowiednią ikonę, komunikat wyjaśniający dlaczego zawartość jest zablokowana oraz przycisk do udzielenia zgody dla danej kategorii.

Osadzenia bez żadnego żądania przed zgodą

Statyczny <iframe src="https://www.youtube.com/embed/…"> w HTML zaczyna się ładować w chwili, gdy parser przeglądarki do niego dojdzie. CookieHug neutralizuje go kilka milisekund później i pokazuje zastępnik, ale pierwsze żądanie zdążyło już wyjść — dostawca widzi adres IP odwiedzającego i adres strony, zanim zapadła jakakolwiek decyzja. Audyt „przed zgodą” raportuje to jako ostrzeżenie („żądanie przerwane przed odpowiedzią”).

Żeby domknąć tę lukę do zera, wpisz adres w data-cookiehug-src i pomiń src. Przeglądarka nie wysyła wtedy nic; CookieHug pokazuje zastępnik i ustawia prawdziwy src dopiero po zgodzie (albo od razu, jeśli zgoda jest już zapisana).

Kategoria pochodzi z data-cookiehug-consent, jeśli jest podana, a w przeciwnym razie z katalogu usług (YouTube, Vimeo, Mapy Google itd. są klasyfikowane automatycznie). Nieznane hosty trafiają domyślnie do marketing.

WordPress: wtyczka CookieHug (0.2.7+) przepisuje osadzenia w treści wpisów, widgetach i blokach osadzeń automatycznie — nic nie trzeba robić ręcznie.

<!-- Przed: ładuje się od razu, CookieHug może tylko przerwać żądanie -->
<iframe src="https://www.youtube.com/embed/VIDEO_ID" width="560" height="315"></iframe>

<!-- Po: żadnego żądania aż do zgody -->
<iframe data-cookiehug-src="https://www.youtube.com/embed/VIDEO_ID"
  data-cookiehug-consent="marketing" width="560" height="315"></iframe>

Użycie runScripts() w SPA

W aplikacjach Single Page Application, gdzie zawartość jest ładowana dynamicznie, wywołaj CookieHug.runScripts() po dodaniu nowej zawartości z oznaczonymi skryptami do DOM:

// Po dynamicznym załadowaniu nowej zawartości strony
loadPageContent().then(function() {
  CookieHug.runScripts();
});