Metaadat-hookok: címsor, leírás, canonical, robots és Dublin Core

Ez a fejezet a SEOPress fejlécébe kerülő alapvető metaadatok szűrőit gyűjti össze: a címsorét, a leírásét, a canonical linkét, a robots irányelvekét és a Dublin Core címkékét, valamint két keresési és lapozási változóét. A hookok használatának általános szabályai a Composer és hookok használata fejezetben vannak. A kódot a gyermeksablonod functions.php fájljába vagy egy saját bővítménybe tedd, és még a wp_head lefutása előtt regisztráld. A további fejléc-hookokat a Metaadat-hookok: canonical, lapozás, robots, címsor és WooCommerce-ár, a dinamikus változókét a Metaadat-hookok: dinamikus változók fejezet tárgyalja.

Hook	Mit módosít	Legkisebb verzió
seopress_titles_title	a meta title szövege	2.7.1
seopress_titles_desc	a meta description szövege	2.7.1
seopress_titles_canonical	a canonical <link> elem	2.7.2
seopress_titles_robots	a teljes meta robots címke	2.7.1
seopress_titles_nosnippet	a nosnippet irányelv	2.7.1
seopress_titles_noimageindex	a noimageindex irányelv	2.7.1, 6.2
seopress_dublin_core_title	a dc.title címke	2.7.2
seopress_dublin_core_desc	a dc.description címke	2.7.2
seopress_dublin_core_relation	a dc.relation címke	2.7.2
seopress_dublin_core_source	a dc.source címke	2.7.2
seopress_get_tag_search_keywords_value	a %%search_keywords%% változó értéke	2.3
seopress_paged	a %%current_pagination%% változó értéke	2.3

Meta title: seopress_titles_title

A szűrő a kész címsort kapja meg: azt a szöveget, amelyben a dinamikus változók már a helyükre kerültek. A visszaadott szöveg kerül a <title> elembe, így minden oldaltípusnál (bejegyzés, archívum, keresés, 404) át tudod írni a címet egy helyen.

add_filter( 'seopress_titles_title', 'sajat_meta_title' );
function sajat_meta_title( $cim ) {
    return $cim . ' | Minta Bolt';
}

Ha a témád vagy egy másik bővítmény felülírja a címet, a SEOPress szűrőjének sorrendjét a Metaadat-hookok: canonical, lapozás, robots, címsor és WooCommerce-ár fejezetben leírt prioritás-szűrővel állíthatod.

Meta description: seopress_titles_desc

Ugyanígy működik, mint a címsor szűrője, de a meta description szövegét kapja meg a változók behelyettesítése után.

add_filter( 'seopress_titles_desc', 'sajat_meta_leiras' );
function sajat_meta_leiras( $leiras ) {
    return mb_substr( $leiras, 0, 155 );
}

A címek és leírások beállításáról a Címek és leírások fejezetben olvashatsz.

Canonical link: seopress_titles_canonical

A szűrő a kész <link rel="canonical" href="…"> elemet kapja meg, nem csak az URL-t. Akkor fut le, amikor a SEOPress egyedi canonical URL-t ír ki: bejegyzésnél, oldalnál, a bejegyzések oldalánál, valamint kategóriánál, címkénél és egyéb taxonómiánál. A visszaadott szöveg kerül a fejlécbe, ezért az egész elemet add vissza, ne csak az URL-t.

add_filter( 'seopress_titles_canonical', 'sajat_canonical' );
function sajat_canonical( $html ) {
    return str_replace( 'http://', 'https://', $html );
}

A canonical URL beállításairól a Canonical URL fejezet szól.

Meta robots: seopress_titles_robots, seopress_titles_nosnippet, seopress_titles_noimageindex

A robots címkét három szűrő alakíthatja:

• seopress_titles_noimageindex: az noimageindex irányelv szövegét kapja meg, akkor fut, ha a képek indexelésének tiltása be van kapcsolva.
• seopress_titles_nosnippet: a nosnippet irányelv szövegét kapja meg, akkor fut, ha a részlet megjelenítésének tiltása be van kapcsolva.
• seopress_titles_robots: a teljes, kész <meta name="robots" content="…"> elemet kapja meg, az összes irányelvvel együtt.

// A nosnippet irányelv helyett max-snippet korlát.
add_filter( 'seopress_titles_nosnippet', function ( $irany ) {
    return 'max-snippet:50';
} );

// A teljes robots címke elhagyása.
add_filter( 'seopress_titles_robots', '__return_empty_string' );

Az egyes irányelvek (a tömbként kezelt seopress_titles_robots_attrs szűrő) a Metaadat-hookok: canonical, lapozás, robots, címsor és WooCommerce-ár fejezetben vannak. A robots beállításairól a Robots és dátum fejezet szól.

Dublin Core címkék

A PRO változatban bekapcsolható Dublin Core metaadatokhoz minden címkének saját szűrője van. Mindegyik a kész <meta> elemet kapja meg, és a visszaadott szöveg kerül a fejlécbe; üres szöveggel az adott címke elmarad.

Hook	Címke	Értéke alapból
seopress_dublin_core_title	dc.title	az oldal SEOPress-címsora (csak bejegyzésnél, oldalnál és a blogoldalon jelenik meg)
seopress_dublin_core_desc	dc.description	az oldal meta description szövege (ugyanott)
seopress_dublin_core_relation	dc.relation	az oldal egyedi canonical URL-je, ennek hiányában az aktuális URL
seopress_dublin_core_source	dc.source	a webhely főoldalának URL-je

add_filter( 'seopress_dublin_core_source', 'sajat_dc_source' );
function sajat_dc_source( $html ) {
    return '<meta name="dc.source" content="https://pelda.hu/">';
}

// A dc.relation címke elhagyása.
add_filter( 'seopress_dublin_core_relation', '__return_empty_string' );

A dc.language címke szűrője a Metaadat-hookok: canonical, lapozás, robots, címsor és WooCommerce-ár fejezetben van.

A %%search_keywords%% változó értéke

A seopress_get_tag_search_keywords_value szűrő a keresési találati oldalak címében és leírásában használt %%search_keywords%% változó értékét kapja meg. Az érték alapból a keresett kifejezés idézőjelek között, üres keresésnél két idézőjel közti szóköz. A szűrő második paramétere a környezet. A régi seopress_get_search_query szűrő már elavult, ezt használd helyette.

add_filter( 'seopress_get_tag_search_keywords_value', 'sajat_kereses_kifejezes' );
function sajat_kereses_kifejezes( $ertek ) {
    return mb_strtoupper( $ertek );
}

A %%current_pagination%% változó értéke

A seopress_paged szűrő a lapozott oldalak címében és leírásában használható %%current_pagination%% változó értékét módosítja. Az érték az aktuális oldal száma, de csak a 2. oldaltól; az első oldalon üres. A szűrő csak ezt az értéket kapja meg.

add_filter( 'seopress_paged', 'sajat_oldalszam' );
function sajat_oldalszam( $oldalszam ) {
    return $oldalszam ? 'Oldal: ' . $oldalszam : '';
}

A dinamikus változók teljes listáját a Dinamikus változók fejezetben találod.