Analitikai hookok: egyéni kódok, Google Ads, hozzájárulási üzenet, Matomo

Ez a fejezet az előző analitikai hookfejezet kiegészítése. Itt az egyéni követőkódok, a Google Ads, a süti-hozzájárulási sáv, a Google Analytics vezérlőpult-widgetje és a Matomo néhány további szűrője található. A szűrőket a sablon functions.php fájljába vagy egy saját bővítménybe tedd. A beállítófelületről az Analitika, a süti-hozzájárulás és a Matomo fejezet szól.

Hook	Legkisebb verzió	Mire jó
seopress_gtag_after_additional_tracking_html	3.5	Az egyéni követőkód a fejlécben.
seopress_custom_body_tracking	3.6.2	Az egyéni követőkód a <body> nyitása után.
seopress_custom_footer_tracking	3.7.5	Az egyéni követőkód a <body> zárása előtt.
seopress_gtag_ads	3.6	A Google Ads config sora.
seopress_ga_dashboard_widget_cap	3.5.4	A Google Analytics vezérlőpult-widget jogosultsága.
seopress_rgpd_message	3.1	A süti-hozzájárulási sáv szövege.
seopress_rgpd_full_message	3.3.7	A süti-hozzájárulási sáv teljes HTML-je.
seopress_rgpd_full_message_styles	3.8.2	A sáv beágyazott stíluslapja.
seopress_matomo_site_domain	3.8.5	Az oldal domainjének az oldalcím elé írása a Matomóban.
seopress_matomo_cookie_domain	3.8.5	A Matomo sütijének domainje aldomainek követésekor.
seopress_matomo_cd_author_ev	3.8.5	A szerző egyéni dimenziója a Matomóban.
seopress_matomo_tracking_html	3.8.5	A teljes Matomo-követőkód.

Egyéni követőkódok

Az Analytics › Tracking code részen három mezőbe írhatsz saját kódot: Other tracking code (head), Other tracking code (body) és Other tracking code (footer). Mindhárom kódja az oldalra kerülés előtt átmegy egy szűrőn, amely szövegként megkapja a mezőbe írt kódot. A visszaadott szöveg kerül az oldalra változtatás nélkül, ezért csak megbízható kódot adj vissza. Ha a mező üres, a szűrő nem fut.

Mező	Szűrő	Hová kerül a kód
Other tracking code (head)	seopress_gtag_after_additional_tracking_html	A fejlécbe (<head>), a Google Analytics kódja után.
Other tracking code (body)	seopress_custom_body_tracking	Közvetlenül a <body> nyitó címkéje után.
Other tracking code (footer)	seopress_custom_footer_tracking	A <body> záró címkéje elé.

add_filter( 'seopress_custom_footer_tracking', function ( $html ) {
    // Például egy megjegyzés hozzáfűzése a lábléci kódhoz.
    return $html . "\n<!-- Saját követőkód vége -->";
} );

Ugyanígy működik a másik kettő is: a hook neve cserélődik, a függvény a mezőbe írt HTML-t kapja és adja vissza.

Google Ads

Ha az Enable Google Ads mezőbe beírtál egy AW-… azonosítót, a bővítmény egy gtag('config', …) sort ír az oldalra. A sort a seopress_gtag_ads szűrő szövegként kapja meg, és a visszaadott szöveg kerül az oldalra. A sor csak akkor készül el, ha a látogató nem utasította el a süti-hozzájárulást.

add_filter( 'seopress_gtag_ads', function ( $js ) {
    // A konfigurációs sor módosítása vagy cseréje.
    return $js;
} );

A Google Analytics vezérlőpult-widgetje

Ha a biztonsági beállításoknál nincs szerepkör megadva a Google Analytics widgethez, a widgetet az látja, akinek az edit_dashboard jogosultsága megvan. A seopress_ga_dashboard_widget_cap szűrő ezt a jogosultságnevet kapja, és másikat adhatsz vissza. Ha a szerepkör meg van adva, a szűrő nem fut.

add_filter( 'seopress_ga_dashboard_widget_cap', function ( $cap ) {
    return 'manage_options';
} );

A süti-hozzájárulási sáv

Három szűrő módosítja a hozzájárulási sávot, a szűrők sorrendje szerint haladva a szövegtől a teljes kódig.

Szöveg. A seopress_rgpd_message szűrő a sáv szövegét kapja. Ez a beállításoknál megadott üzenet, ennek hiányában az alapértelmezett szöveg, az adatvédelmi oldal linkjével. Ha az üzenetben a [seopress_privacy_page] helyőrző szerepelt, a szűrő már a kicserélt (valódi hivatkozást tartalmazó) szöveget kapja.

add_filter( 'seopress_rgpd_message', function ( $msg ) {
    return $msg . ' Kérdés esetén írj nekünk.';
} );

Teljes HTML. A seopress_rgpd_full_message szűrő a sáv teljes HTML-jét kapja, és a visszaadott kód jelenik meg a látogatónak. Öt paramétere van:

Paraméter	Tartalma
1.	A sáv teljes HTML-je (ezt kell visszaadni).
2.	A szöveg, a seopress_rgpd_message szűrő utáni állapotban.
3.	Az elfogadó gomb felirata.
4.	Az elutasító gomb felirata.
5.	A háttérréteg (backdrop) HTML-je, amely a sáv után kerül az oldalra.

add_filter( 'seopress_rgpd_full_message', function ( $html, $msg, $accept, $decline, $backdrop ) {
    // Itt újraépítheted a sáv szerkezetét. A gombok azonosítói
    // (seopress-user-consent-accept, seopress-user-consent-close)
    // maradjanak meg, különben a gombok nem működnek.
    return $html;
}, 10, 5 );

Stílusok. A seopress_rgpd_full_message_styles szűrő a sáv beágyazott <style> blokkját kapja szövegként (a nyitó és záró címkével együtt). A visszaadott szöveg íródik ki az oldalra. Így a sáv színeit, méretét vagy elhelyezését egy saját szabállyal is felülírhatod, a beállítófelület használata nélkül.

add_filter( 'seopress_rgpd_full_message_styles', function ( $styles ) {
    return $styles . '<style>.seopress-user-consent button{border-radius:0;}</style>';
} );

Matomo

A Matomo-szűrők csak akkor futnak, ha a Matomo be van kapcsolva, és az azonosító mezők ki vannak töltve.

Szűrő	Alapértelmezett érték	Mikor fut
seopress_matomo_cookie_domain	_paq.push(['setCookieDomain', '*.example.com']);	Ha az aldomainek követése be van kapcsolva; a domain a webhely címéből készül.
seopress_matomo_site_domain	_paq.push(['setDocumentTitle', document.domain + '/' + document.title]);	Ha a Prepend site domain be van kapcsolva.
seopress_matomo_cd_author_ev	_paq.push(['setCustomVariable', …, 'visit']); a szerző nevével	Ha a szerző egyéni dimenziójához rendeltél helyet, és egyedi bejegyzés vagy oldal van megnyitva.
seopress_matomo_tracking_html	A teljes <script> blokk	Mindig, amikor a Matomo-kód készül.

Az első három szűrő az adott _paq.push(…) sort kapja szövegként, a visszaadott szöveg kerül a kódba. A seopress_matomo_tracking_html a teljes, <script> címkékkel együtt összeállított követőkódot kapja, így ezzel bármelyik sort módosíthatod vagy a kódot kiegészítheted.

add_filter( 'seopress_matomo_tracking_html', function ( $html ) {
    // A teljes Matomo-kód módosítása vagy kiegészítése.
    return $html;
} );