Közösségi hookok: Open Graph, X-kártya és oEmbed

Ez a fejezet azokat a hookokat gyűjti össze, amelyekkel a közösségi megosztáshoz kapcsolódó metacímkéket és az oEmbed adatokat alakíthatod. 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. A beállításokról a Open Graph és X (Twitter) kártya metaadatok fejezetben olvashatsz.

Hook	Típus	Legkisebb verzió	Mire jó
seopress_social_og_locale	szűrő	2.7.2	Az og:locale címke (és az alternatív nyelvek).
seopress_social_og_url	szűrő	2.7.2	Az og:url címke.
seopress_social_og_title	szűrő	2.7.2	Az og:title címke.
seopress_social_og_desc	szűrő	2.7.2	Az og:description címke.
seopress_social_og_thumb	szűrő	2.7.2	Az og:image címke (és a kép méretei).
seopress_social_og_site_name	szűrő	2.7.2	Az og:site_name címke.
seopress_social_twitter_card_title	szűrő	2.7.2	A twitter:title címke.
seopress_social_twitter_card_desc	szűrő	2.7.2	A twitter:description címke.
seopress_social_twitter_card_thumb	szűrő	2.7.2	A twitter:image címke.
seopress_social_image_size	szűrő	9.4	Az Open Graph és az X-kártya képének mérete.
seopress_social_og_type	szűrő	2.7.2	Az og:type metacímke.
seopress_social_og_author	szűrő	3.3	Az article:author és article:publisher címkék.
seopress_titles_og_updated_time	szűrő	3.5	Az og:updated_time címke.
seopress_social_twitter_card_summary	szűrő	2.7.2	A twitter:card címke.
seopress_social_twitter_card_site	szűrő	2.7.2	A twitter:site címke.
seopress_social_twitter_card_creator	szűrő	2.7.2	A twitter:creator címke.
seopress_oembed_title	szűrő	3.8.9	Az oEmbedben kiírt cím.
seopress_oembed_thumbnail_size	szűrő	3.8.9	Az oEmbed bélyegképének mérete.
seopress_oembed_thumbnail	szűrő	3.8.9	Az oEmbed bélyegképének adatai.

Open Graph és X-kártya címkék szűrői

Az alábbi szűrők mindegyike a kész HTML-címkét kapja meg (például <meta property="og:title" content="…">), és a visszaadott szöveg kerül a fejlécbe. Mivel az értéket már a címke kódolja, a saját szövegedet te magad kódold (például esc_attr()-rel). Üres szöveggel az adott címke kimarad. A 404-es oldalon egyik címke sem jelenik meg, a szűrő eredményétől függetlenül. A szűrők csak akkor futnak, ha a megfelelő közösségi funkció (Open Graph vagy X-kártya) be van kapcsolva.

Szűrő	Címke	Megjegyzés
seopress_social_og_locale	og:locale	Az oldal nyelvi kódja. Többnyelvű webhelyen (Polylang, WPML) az og:locale:alternate sorok is ebben a szövegben vannak, külön sorban.
seopress_social_og_url	og:url	Az aktuális oldal címe. Keresési találati oldalon a /search/<keresőszó> alak szerepel.
seopress_social_og_title	og:title	A cím a sablon változóinak behelyettesítése után kerül a szűrőhöz.
seopress_social_og_desc	og:description	A leírás a változók behelyettesítése után kerül a szűrőhöz.
seopress_social_og_thumb	og:image	A kiválasztott kép címkéi, a kép méretadataival együtt. Ha nincs bejegyzésszintű kép, az alapértelmezett közösségi kép, ennek hiányában a webhely ikonja szerepel.
seopress_social_og_site_name	og:site_name	A webhely neve. Üres webhelynévnél a címke nincs kiírva.
seopress_social_twitter_card_title	twitter:title	A cím a változók behelyettesítése után kerül a szűrőhöz.
seopress_social_twitter_card_desc	twitter:description	A leírás a változók behelyettesítése után kerül a szűrőhöz.
seopress_social_twitter_card_thumb	twitter:image	A kép címe. Ha az X-kártyának nincs saját képe, az alapértelmezett X-kép vagy a Facebook-kép szerepel (utóbbi, ha az X-kártya az Open Graph képét használja).

// Az Open Graph cím kiegészítése a webhely nevével.
add_filter( 'seopress_social_og_title', function ( $html ) {
    return str_replace( '">', ' | Minta Bolt">', $html );
} );

// A webhelynév címke kihagyása.
add_filter( 'seopress_social_og_site_name', '__return_empty_string' );

// Fix nyelvi kód az Open Graphban.
add_filter( 'seopress_social_og_locale', function ( $html ) {
    return '<meta property="og:locale" content="hu_HU">';
} );

// Az X-kártya képének cseréje.
add_filter( 'seopress_social_twitter_card_thumb', function ( $html ) {
    return '<meta name="twitter:image" content="' . esc_url( 'https://example.com/kep.jpg' ) . '">';
} );

A közösségi kép mérete

A seopress_social_image_size szűrő azt a WordPress-képméretet adja meg, amelyből az og:image és az X-kártya képe készül. Az alapérték full, vagyis az eredeti kép. A szűrő a méret nevét (például large vagy medium_large) várja, és ugyanazt a visszaadott méretet használja minden olyan helyen, ahol a SEOPress közösségi képet ír ki.

add_filter( 'seopress_social_image_size', function ( $size ) {
    return 'large';
} );

Open Graph típus

Az og:type címkét a SEOPress oldaltípusonként állítja be:

• a címlapon és a blogoldalon website,
• termékeken product,
• videót tartalmazó bejegyzésen video.other,
• cikk jellegű tartalmon article,
• egyéb önálló tartalmon website,
• keresési találatokon, archívumokon és 404-es oldalon object.

A seopress_social_og_type szűrő a kész HTML-címkét kapja meg (például <meta property="og:type" content="article">), és a visszaadott szöveg kerül a fejlécbe. A 404-es oldalon a címke nem jelenik meg akkor sem, ha a szűrő értéket ad vissza.

add_filter( 'seopress_social_og_type', function ( $html ) {
    if ( is_singular( 'recept' ) ) {
        return '<meta property="og:type" content="article">';
    }
    return $html;
} );

Open Graph szerző és kiadó

Ha a SEO → Social Networks oldalon megadtad a Facebook-oldalad URL-jét, és a Facebook Open Graph be van kapcsolva, a cikk jellegű oldalakon a SEOPress kiírja az article:author és az article:publisher címkét is. A seopress_social_og_author szűrő mindkét címkét egyben, két sorban kapja meg, és a visszaadott szöveg kerül a fejlécbe. Videót tartalmazó bejegyzésen ezek a címkék nem jelennek meg.

add_filter( 'seopress_social_og_author', function ( $html ) {
    return '<meta property="article:publisher" content="https://www.facebook.com/peldaoldal">';
} );

Az og:updated_time címke

A seopress_titles_og_updated_time szűrő az og:updated_time címke kész HTML-jét kapja, és a visszaadott szöveg kerül a fejlécbe. Üres szöveggel kiveheted a címkét. A hook ugyanabban a blokkban fut, mint az article:published_time és az article:modified_time szűrője, és a címke értéke az oldal utolsó módosításának ideje.

add_filter( 'seopress_titles_og_updated_time', '__return_empty_string' );

X (Twitter) kártya

Ha az X-kártya be van kapcsolva, három szűrő módosíthatja a kártya főbb címkéit. Mindegyik a kész HTML-címkét kapja meg.

Szűrő	Alapértelmezett címke	Mikor jelenik meg
seopress_social_twitter_card_summary	<meta name="twitter:card" content="summary_large_image">, vagy content="summary" kisebb képméretnél	Az X-kártya bekapcsolva; a 404-es oldalon nem.
seopress_social_twitter_card_site	<meta name="twitter:site" content="@fiok">	Ha a SEO → Social Networks oldalon megadtad az X (Twitter) fiókot; a 404-es oldalon nem.
seopress_social_twitter_card_creator	<meta name="twitter:creator" content="@fiok">	A szerző profiljában megadott X-fiók, ennek hiányában a webhely fiókja.

A fiók nevét a SEOPress @fiok alakra hozza akkor is, ha teljes profil-URL-t írtál be.

add_filter( 'seopress_social_twitter_card_summary', function ( $html ) {
    return '<meta name="twitter:card" content="summary_large_image">';
} );

oEmbed

Ha egy másik WordPress-oldal beágyazza a te bejegyzésedet, az oEmbed-válasz címét és bélyegképét a SEOPress állítja be. Három szűrő módosíthatja:

• seopress_oembed_title: a bejegyzés oEmbed-címe. A cím a SEO → Titles & Metas beállításai szerint készül (a sablon változóival együtt), és ezt a kész szöveget kapja meg a szűrő.
• seopress_oembed_thumbnail_size: a bélyegkép képmérete, ha a bejegyzésnek nincs külön megadott Open Graph képe, csak kiemelt képe. Az alapérték a SEO → Social Networks oldalon beállított képméret, ennek hiányában full.
• seopress_oembed_thumbnail: a bélyegkép adatait tartalmazó tömb. A tömb url kulcsa a kép címe; a kiemelt képből készült bélyegképnél width (szélesség) és height (magasság) is van benne.

add_filter( 'seopress_oembed_title', function ( $title ) {
    return $title . ' | Minta Bolt';
} );

add_filter( 'seopress_oembed_thumbnail_size', function ( $size ) {
    return 'medium_large';
} );

add_filter( 'seopress_oembed_thumbnail', function ( $thumbnail ) {
    return array(); // nincs bélyegkép az oEmbedben
} );