Tartalomelemzési hookok: belső linkek, valódi előnézet és Search Console

Ez a fejezet azokat a szűrőket gyűjti össze, amelyekkel a tartalomelemzés, a belső linkajánlások és a Google Search Console-adatok viselkedését igazíthatod. A szűrőket a sablon functions.php fájljába vagy egy saját bővítménybe tedd.

Hook	Mire jó
seopress_pro_significant_kw_custom_fields	Mely egyéni mezők (meta kulcsok) szövegét olvassa a belső linkajánló.
seopress_pro_significant_kw_acf_field_types	Mely ACF-mezőtípusok értékét olvassa szövegként.
seopress_pro_significant_kw_prose_line_length	Az a sorhossz, amely fölött egy mezősort folyószövegnek vesz.
seopress_pro_significant_kw_content	A kulcsszókinyeréshez olvasott végső szöveg.
seopress_pro_significant_kw_render_content	Renderelje-e a tartalmat a kulcsszókinyerés előtt.
seopress_real_preview_custom_args	A tartalomelemzés előnézeti kérésének alapargumentumai.
seopress_real_preview_remote	Az előnézeti kérés teljes argumentumkészlete.
seopress_search_console_match_url	A Search Console-sor URL-je a bejegyzéshez párosítás előtt.
seopress_search_console_match_post_id	Végső tartalék a bejegyzés azonosítójának megtalálására.
seopress_search_console_start_date	A Search Console-lekérdezés kezdődátuma.
seopress_search_console_end_date	A Search Console-lekérdezés záródátuma.

Belső linkajánlások: mit olvasson a bővítmény

A belső linkajánló a bejegyzés szövegéből kulcsszavakat von ki. Az olvasott szöveg a bejegyzés tartalma, kiegészítve az egyéni mezők szövegével. Alapból azokat az ACF-mezőket olvassa, amelyek értéke a bejegyzéshez mentve van, és a típusuk szöveg, hosszú szöveg vagy vizuális szerkesztő.

Egyéni mezők kiválasztása

A seopress_pro_significant_kw_custom_fields szűrő a beolvasott meta kulcsok tömbjét adja át (alapból a bejegyzés ACF-mezőinek kulcsai) és a bejegyzés objektumát. Hozzáadhatod más szerkesztő vagy mezőkezelő által használt meta kulcsokat, vagy üres tömböt adhatsz vissza, hogy a bővítmény csak a post_content tartalmát olvassa.

add_filter( 'seopress_pro_significant_kw_custom_fields', function ( $keys, $post ) {
    // Saját szerkesztő meta kulcsának felvétele.
    $keys[] = 'sajat_szoveg_meta';
    return $keys;
}, 10, 2 );

// Csak a bejegyzés tartalma számítson.
add_filter( 'seopress_pro_significant_kw_custom_fields', '__return_empty_array' );

Két további szűrő finomhangol:

• seopress_pro_significant_kw_acf_field_types: a beolvasott ACF-mezőtípusok tömbje, alapértéke text, textarea, wysiwyg. Ha az ACF nincs betöltve, vagy a mező már nem létezik, a típus ismeretlen, és az érték olvasható marad.
• seopress_pro_significant_kw_prose_line_length: bájtban megadott szám (alapérték 200). Az ennél hosszabb mezősorokat a bővítmény csupán a szavai alapján is folyószövegnek tekinti.

A végső szöveg módosítása

A seopress_pro_significant_kw_content szűrő megkapja a kulcsszókinyeréshez összeállított szöveget, a bejegyzést és a változatlan post_content értéket ($raw). Olyan oldalszerkesztőnél jó, amely a WordPressen kívül rendereli a tartalmát: itt visszaadhatod a szerkesztő szövegét, és a belső linkajánlás működik.

add_filter( 'seopress_pro_significant_kw_content', function ( $content, $post, $raw ) {
    return $content . ' ' . sajat_szerkeszto_szovege( $post->ID );
}, 10, 3 );

A seopress_pro_significant_kw_render_content szűrő azt dönti el, hogy a bővítmény renderelje-e a tartalmat (blokkok, rövidkódok kibontása) a szöveg kiolvasása előtt. Alapérték: igaz, ha a tartalom blokkot vagy szögletes zárójelet (rövidkódot) tartalmaz, és nem üres. A renderelés nem ingyenes, mert minden mentéskor és a javaslatpanel minden megjelenítésekor lefut, ezért itt kikapcsolhatod, ha nincs rá szükség.

add_filter( 'seopress_pro_significant_kw_render_content', '__return_false' );

A tartalomelemzés valódi előnézeti kérése

A tartalomelemzés a bejegyzés oldalát egy belső kéréssel kéri le. Két szűrő fér hozzá ehhez a kéréshez:

• seopress_real_preview_custom_args: a kérés alapargumentumai (alapból no_admin_bar = 1). Oldal- vagy témaszerkesztőkhöz hasznos, ha további lekérdezési argumentumot kell átadni.
• seopress_real_preview_remote: a kérés teljes argumentumkészlete (például sütik, fejlécek). Ez fut le utoljára, így egy szerkesztő vagy biztonsági bővítmény az egész készletet átnézheti és módosíthatja, a sütiket is beleértve. Az átirányítások követését a bővítmény mindenképp letiltja, ezt szűrővel nem lehet visszakapcsolni.

add_filter( 'seopress_real_preview_remote', function ( $args ) {
    $args['timeout'] = 30;
    return $args;
} );

Search Console-sorok párosítása

A Search Console-sorok URL-jét a bővítmény a WordPress url_to_postid() függvényével párosítja bejegyzéshez. A nyelvi előtagot (például /en/) használó többnyelvű bővítmények (TranslatePress, Polylang, WPML) ezt az előtagot nem regisztrálják a WordPress átírási szabályai között, ezért a párosítás sikertelen lehet. Két szűrő segít:

1. seopress_search_console_match_url: a párosítás előtt módosíthatod az URL-t (séma, gazdanév és útvonal). Paraméterei: a megtisztított URL és a Search Console által visszaadott eredeti URL. Itt távolítsd el a nyelvi előtagot.
2. seopress_search_console_match_post_id: végső tartalék. Ha az url_to_postid() nullát ad (például lefordított, saját bővítmény által feloldott közvetlen hivatkozásnál), itt adhatod vissza a bejegyzés azonosítóját. Paraméterei: az eddigi azonosító, a megtisztított URL és az eredeti URL.

add_filter( 'seopress_search_console_match_url', function ( $clean_url, $url ) {
    // A /en/ nyelvi előtag eltávolítása.
    return str_replace( '/en/', '/', $clean_url );
}, 10, 2 );

add_filter( 'seopress_search_console_match_post_id', function ( $post_id, $clean_url, $url ) {
    if ( $post_id ) {
        return $post_id;
    }
    // Saját feloldás, például a többnyelvű bővítmény függvényével.
    return (int) sajat_url_feloldo( $clean_url );
}, 10, 3 );

A Search Console-lekérdezés időszaka

A bővítmény a beállított időszakot (alapból az elmúlt három hónapot) a mai naptól számolja. Két szűrővel igazíthatod a dátumokat. Mindkettő Y-m-d formátumú szöveget kap és vár.

Szűrő	Mit módosít	Alapérték
seopress_search_console_start_date	A mai nap mínusz a beállított időszak.
seopress_search_console_end_date	A mai nap.

add_filter( 'seopress_search_console_end_date', function ( $date ) {
    // A Search Console adatai késnek: két nappal korábbi záródátum.
    return gmdate( 'Y-m-d', strtotime( '-2 days' ) );
} );