Menu dokumentacji

Blokowanie skryptów

Automatyczne blokowanie skryptów, ręczne tagowanie, kategorie zgody, placeholdery i obsługa aplikacji SPA.

Kontrola 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>

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.

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();
});