Hookok: képességek kitettsége, Markdown-változat és térkép-ellenőrzés

Ez a fejezet három, egymástól független szűrőt ír le. A hookok használatának általános szabályait a Composer és hookok használata fejezet tartalmazza.

Hook	Típus	Legkisebb verzió	Mire jó
seopress_abilities_api_rest_enabled	szűrő (filter)	10.0	Kitettek-e a SEOPress képességei a REST API-n.
seopress_agent_ready_markdown_post_types	szűrő	9.8	Mely bejegyzéstípusokhoz készül Markdown-változat.
seopress_sitemap_diagnostic_request_args	szűrő	10.0	Az XML-oldaltérkép-ellenőrzés HTTP-kérésének paraméterei.

A képességek REST-kitettsége

A seopress_abilities_api_rest_enabled szűrő azt dönti el, hogy a SEOPress képességei (abilities) elérhetők-e külső eszközök és AI-ügynökök számára a REST API-n. Egy logikai értéket kap: azt, amit a SEO → Advanced oldal Abilities API részében az Expose abilities to AI agents and external tools kapcsoló beállít. A visszaadott érték dönt, így a kapcsoló állásától függetlenül is be- vagy kikapcsolhatod a kitettséget.

Ez a kitettség vezérli az MCP-szervert is: ha a szűrő false-t ad vissza, az MCP-végpont le van tiltva. A képességek működéséről és a kapcsoló beállításáról a SEOPress képességek (Abilities API) fejezet szól.

Példa: a kitettség bekapcsolása kódból, a beállítástól függetlenül:

add_filter( 'seopress_abilities_api_rest_enabled', '__return_true' );

Példa: csak éles webhelyen legyen kitéve, fejlesztői és tesztkörnyezetben soha:

add_filter( 'seopress_abilities_api_rest_enabled', function ( $enabled ) {
    return 'production' === wp_get_environment_type() ? $enabled : false;
} );

Az Insights képességeinek kapcsolójáról (seopress_insights_abilities_api_rest_enabled) az Abilities-fejezet beszél, az egy másik szűrő.

A Markdown-változathoz használt bejegyzéstípusok

Amikor a webhely AI-ügynökökre való felkészültsége be van kapcsolva, a SEOPress PRO a bejegyzésekhez és oldalakhoz Markdown-változatot is kiszolgál, és ezt a HTTP-válasz egy Link fejlécében (rel="alternate"; type="text/markdown") jelzi. A beállításokról az AI-ügynök-készség és llms.txt fejezet szól.

A seopress_agent_ready_markdown_post_types szűrő azt a bejegyzéstípus-listát kapja, amelyre ez érvényes. Az alapérték két típus: post (bejegyzés) és page (oldal). A főoldal (és a bejegyzések blogoldala) ettől függetlenül mindig megkapja a Markdown-változatot. A szűrőt két helyen használja a bővítmény: a Link fejléc kiadásakor és a Markdown-változat kiszolgálásakor, ezért a lista egyszerre érvényes mindkettőre.

Példa: az egyéni bejegyzéstípusok, a termékek és a „portfólió” típus is kapjon Markdown-változatot:

add_filter( 'seopress_agent_ready_markdown_post_types', function ( $post_types ) {
    $post_types[] = 'product';
    $post_types[] = 'portfolio';
    return $post_types;
} );

Példa: csak a bejegyzések kapjanak Markdown-változatot:

add_filter( 'seopress_agent_ready_markdown_post_types', function () {
    return array( 'post' );
} );

Az llms.txt fájlba kerülő bejegyzéstípusokat nem ez, hanem a seopress_llms_post_types szűrő határozza meg, lásd az llms.txt és Content-Signal hookok fejezetet.

Az XML-oldaltérkép-ellenőrzés HTTP-kérése

A SEOPress az oldaltérkép hibaelhárításánál egy saját kérést küld a webhely sitemaps.xml címére (és a benne szereplő térképekre), hogy lássa, helyesen válaszol-e. Az ellenőrzésről az Oldaltérkép hibaelhárítása fejezet szól.

A seopress_sitemap_diagnostic_request_args szűrő ennek a kérésnek a paramétereit adja át módosításra. Két paramétert kap: a kérés argumentumainak tömbjét és a lekért URL-t. Az alapértelmezett argumentumok:

Kulcs	Alapérték
timeout	15 másodperc
redirection	5
sslverify	false (a kérés a saját webhelyedre megy)
user-agent	Mozilla/5.0 (compatible; WP Sitemap Diagnostic; <a webhely címe>)
headers	Accept: application/xml,text/xml,*/*;q=0.8

Erre akkor lehet szükség, ha a webhelyet jelszavas védelem (HTTP-hitelesítés), tűzfal vagy biztonsági bővítmény védi, és az ellenőrző kérést elutasítja.

Példa: HTTP-hitelesítéssel védett tesztkörnyezetben a kérés fejlécet kap:

add_filter( 'seopress_sitemap_diagnostic_request_args', function ( $args, $url ) {
    $args['headers']['Authorization'] = 'Basic ' . base64_encode( 'felhasznalo:jelszo' );
    return $args;
}, 10, 2 );

Példa: lassú kiszolgálón hosszabb várakozási idő:

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

A hitelesítő adatokat ne írd közvetlenül a kódba, ha a fájl verziókezelőbe kerül: használj konstanst vagy környezeti változót.