llms.txt és Content-Signal hookok

Ez a fejezet az llms.txt fájlhoz és az AI-ügynökök felé jelzett Content-Signal direktívához tartozó hookokat írja le. A fájl beállításairól az AI-ügynök-készség és llms.txt fejezet szól; a hookok általános használatáról a Composer és hookok használata fejezet.

Hook	Típus	Legkisebb verzió	Mire jó
seopress_llms_post_types	szűrő (filter)	9.7	Mely bejegyzéstípusok szerepelnek az llms.txt-ben.
seopress_llms_query_posts	szűrő	9.8	Az llms.txt-be kerülő bejegyzések listája.
seopress_llms_txt_file	szűrő	9.5	Az elkészült llms.txt teljes tartalma.
seopress_llms_placeholders_replaced	szűrő	9.5	Az egyedi tartalom a helyőrzők cseréje után.
seopress_llms_txt_url	szűrő	9.5	Az llms.txt URL-je.
seopress_default_llms_txt_content	szűrő	9.5	Az automatikusan generált alapértelmezett tartalom.
seopress_agent_ready_content_signal	szűrő	9.8	A robots.txt-be kerülő Content-Signal értékek.

Az llms.txt-ben szereplő bejegyzéstípusok és bejegyzések

Bejegyzéstípusok. A seopress_llms_post_types szűrő az llms.txt-be kerülő bejegyzéstípusok neveinek tömbjét kapja. Alapértelmezés szerint minden nyilvános bejegyzéstípus benne van, kivéve a mellékleteket (attachment) és a SEOPress belső típusait (seopress_404, seopress_schemas, seopress_bot).

add_filter( 'seopress_llms_post_types', function ( $post_types ) {
    // A „kapcsolat” típusú bejegyzések kimaradnak.
    return array_diff( $post_types, array( 'kapcsolat' ) );
} );

Bejegyzések. A seopress_llms_query_posts szűrő három paramétert kap: a már lekérdezett bejegyzések tömbjét (WP_Post objektumok), a lekérdezés argumentumait (a get_posts() paraméterei) és a nyelvkódot (all az összes nyelvre, a tényleges nyelvkód egy adott nyelvre, vagy az alapértelmezett nyelv). A visszaadott lista kerül a fájlba, ezért itt kiszűrhetsz bejegyzéseket, átrendezheted őket, vagy gyorsítótárba teheted az eredményt. A szűrő a helyőrzős egyedi tartalomnál és az automatikusan generált tartalomnál is lefut.

add_filter( 'seopress_llms_query_posts', function ( $posts, $args, $lang ) {
    // A jelszóval védett bejegyzések ne kerüljenek a fájlba.
    return array_filter( $posts, function ( $post ) {
        return empty( $post->post_password );
    } );
}, 10, 3 );

Ha sok bejegyzést kérsz le a helyőrzőkkel, és a TranslatePress is aktív, a fordított bejegyzésenként több lekérdezés is futhat. Ilyenkor érdemes a seopress_llms_query_posts vagy a seopress_llms_txt_file szűrőn keresztül gyorsítótárat (átmeneti tárolót, transient) alkalmazni.

Az llms.txt tartalmának és URL-jének módosítása

A három szűrő különböző ponton avatkozik be:

Hook	Mikor fut le	Paraméter
seopress_default_llms_txt_content	Csak akkor, ha az automatikusan generált tartalom készül (nincs egyedi tartalom elmentve a beállításokban).	A generált szöveg.
seopress_llms_placeholders_replaced	Csak akkor, ha a beállításokban egyedi llms.txt-tartalmat mentettél, a helyőrzők cseréje után.	A helyőrzők nélküli szöveg.
seopress_llms_txt_file	Mindig, a fájl kiadása előtt, mindkét esetben.	A fájl teljes szövege.
seopress_llms_txt_url	Az llms.txt URL-jének meghatározásakor.	Az URL (alapértelmezés: a webhely főcíme + /llms.txt).

Az alapértelmezett tartalom szűrője a generált szöveg végére (vagy elé) saját szakaszt tud fűzni, de az egyedi tartalmat nem érinti:

add_filter( 'seopress_default_llms_txt_content', function ( $content ) {
    return $content . "\n## Kapcsolat\n\nKérdéseddel írj nekünk az [email protected] címre.\n";
} );

Ha mindkét esetben (generált és egyedi tartalomnál) módosítani szeretnél, használd a seopress_llms_txt_file szűrőt:

add_filter( 'seopress_llms_txt_file', function ( $content ) {
    return $content . "\n<!-- Frissítve: " . gmdate( 'Y-m-d' ) . " -->\n";
} );

Az llms.txt URL-je mindig a webhely főcíme alatt van, a többnyelvű bővítmények nyelvi előtagja nélkül (hasonlóan a robots.txt-hez). A seopress_llms_txt_url szűrővel ezt az URL-t módosíthatod ott, ahol a SEOPress megjeleníti a fájl címét (például a beállítóoldalon és a diagnosztikában):

add_filter( 'seopress_llms_txt_url', function ( $url ) {
    return 'https://www.example.com/llms.txt';
} );

A Content-Signal értékek szűrése

A Content-Signal direktíva a robots.txt-ben jelzi az AI-ügynököknek, mire használhatják a tartalmadat. Az alapértékek: search=yes (keresés), ai-input=yes (az AI-válaszok forrásaként) és ai-train=no (modellek tanítása). A seopress_agent_ready_content_signal szűrő egy tömböt kap, amelynek kulcsai a jelzések nevei, értékei a yes vagy no; a visszaadott tömbből a SEOPress kulcs=érték párokat készít, vesszővel elválasztva.

Példa: a válaszokban való felhasználás tiltása is:

add_filter( 'seopress_agent_ready_content_signal', function ( $signals ) {
    $signals['ai-input'] = 'no';
    return $signals;
} );

Ezzel a robots.txt-ben a Content-Signal: search=yes, ai-input=no, ai-train=no sor jelenik meg. Ha a robots.txt már tartalmaz Content-Signal: sort, a SEOPress nem fűz hozzá újat.