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

> Három szűrő: a SEOPress képességeinek REST-kitettsége, a Markdown-változathoz használt bejegyzéstípusok és az XML-oldaltérkép-ellenőrzés HTTP-kérése.

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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/fejlesztoknek-composer-es-hookok/) 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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-mcp-szerver/) 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)](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-abilities/) fejezet szól.

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

```php
add_filter( 'seopress_abilities_api_rest_enabled', '__return_true' );
```

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

```php
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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-agent-readiness-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:

```php
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:

```php
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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-ai-llms-txt/) 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](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/oldalterkepek-hibaelharitas/) 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:

```php
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ő:

```php
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.