# Oldaltérkép-hookok: XSL-megjelenés, tételek URL-je, rejtett termékek, hírkulcsszavak és HTML-térkép címkék

> Szűrő-hookok az oldaltérképekhez: az XSL stíluslap és CSS módosítása, a tételek URL-je, a főoldal URL-je, az archívumlinkek, a rejtett WooCommerce-termékek, a hírkulcsszavak és a HTML-térkép tartalomtípus-neve, termékkategória-lekérdezése.

Ez a fejezet az oldaltérképek további szűrőit gyűjti össze. 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 írja le. A kódot a gyermeksablonod `functions.php` fájljába vagy egy saját bővítménybe tedd. A többi térképszűrőt az [XML-térkép és videótérkép hookjai](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-terkep-xml-es-video-hookok/) és a [HTML-térkép hookjai](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-terkep-html-terkep-hookok/) fejezet tartalmazza.

| Hook | Legkisebb verzió | Mire jó |
|---|---|---|
| `seopress_sitemaps_xsl` | 5.3 | Az XML-térképek böngészős megjelenését adó XSL stíluslap teljes kódja. |
| `seopress_sitemaps_xsl_css` | 5.3 | Az XSL stíluslap CSS-e. |
| `seopress_sitemaps_video_xsl` | 5.7 | A videótérkép XSL stíluslapja. |
| `seopress_sitemaps_single_url` | 5.3 | Egy tartalom adatai (URL, módosítás dátuma, képek) a tartalomtípus térképén. |
| `seopress_sitemaps_term_single_url` | 5.3 | Egy kategória vagy címke adatai a taxonómiák térképén. |
| `seopress_sitemaps_single_query` | 2.4 | A tartalomtípus térképének lekérdezése (például a rejtett termékek felvétele). |
| `seopress_sitemaps_home_url` | 4.1.6 | A főoldal URL-je, amelyből a térképek hivatkozásai épülnek. |
| `seopress_sitemaps_no_archive_link` | 4.5 | Egy tartalomtípus archívumlinkjének bejegyzése a térképen. |
| `seopress_sitemaps_news_keywords_value` | 3.8.7 | A Google News térkép kulcsszavai. |
| `seopress_sitemaps_html_cpt_name` | 5.2 | A tartalomtípus neve a HTML-térképen. |
| `seopress_sitemaps_html_product_cat_query` | 5.0 | A termékkategóriák lekérdezése a HTML-térképen. |

## Az XSL stíluslap és a CSS

Az XML-térképeket a böngésző egy XSL stíluslap segítségével jeleníti meg táblázatként. Három szűrővel írhatod át:

| Hook | Mit kapsz | Mit adj vissza |
|---|---|---|
| `seopress_sitemaps_xsl` | A térképindex stíluslapjának teljes XML-kódja (szöveg). | A módosított kód. |
| `seopress_sitemaps_video_xsl` | A videótérkép stíluslapjának teljes kódja (szöveg). | A módosított kód. |
| `seopress_sitemaps_xsl_css` | A stíluslapba kerülő CSS-szabályok (szöveg). A térképindex és a videótérkép is használja. | A módosított CSS. |

Ha csak a kinézeten változtatnál, a CSS szűrője elég. A szöveg a `<style>` elembe kerül, ezért a saját szabályaidat fűzd hozzá a kapott szöveghez:

```php
add_filter( 'seopress_sitemaps_xsl_css', 'sajat_terkep_css' );
function sajat_terkep_css( $css ) {
    return $css . ' #main h1 { color: #0b5ed7; }';
}
```

## A tételek URL-je

Két szűrő minden egyes térképtételnél lefut, mielőtt a SEOPress kiírja azt:

| Hook | Paraméterek | Mikor fut |
|---|---|---|
| `seopress_sitemaps_single_url` | `$url`, `$post` | Egy tartalomtípus (bejegyzés, oldal, termék …) térképén, tartalmanként. |
| `seopress_sitemaps_term_single_url` | `$url`, `$term` | Egy taxonómia (kategória, címke …) térképén, kifejezésenként. |

A `$url` tömb kulcsai: `loc` (az URL), `mod` (az utolsó módosítás dátuma) és `images` (a tételhez tartozó képek). Visszatérési értéknek a módosított tömböt add vissza. Ha `null` értéket vagy üres `loc` kulcsot adsz vissza, a tétel kimarad a térképből. A SEOPress is ezen a szűrőn át hagyja ki a noindex tartalmakat és azokat, amelyeknek egyedi kanonikus URL-jük van.

Példa: egy bejegyzés kihagyása azonosító alapján:

```php
add_filter( 'seopress_sitemaps_single_url', 'sajat_tetel_kihagyasa', 10, 2 );
function sajat_tetel_kihagyasa( $url, $post ) {
    if ( 123 === $post->ID ) {
        return null;
    }
    return $url;
}
```

## A főoldal URL-je

A `seopress_sitemaps_home_url` szűrő a webhely főoldalának URL-jét adja át (záró perjellel), és ebből épül a térképek stíluslapjának és hivatkozásainak címe. Szöveget kell visszaadnod, és legyen a végén perjel. Ha a WPML nyelvei külön tartományon vannak, a SEOPress ezt magától beállítja.

```php
add_filter( 'seopress_sitemaps_home_url', 'sajat_terkep_fooldal' );
function sajat_terkep_fooldal( $home_url ) {
    return 'https://www.pelda.hu/';
}
```

## Rejtett WooCommerce-termékek a térképen

A SEOPress a termékek térképéből alapból kihagyja azokat a termékeket, amelyek katalógus-láthatósága „kizárva a katalógusból” (`exclude-from-catalog`). Ha a rejtett termékeket is fel szeretnéd venni, a `seopress_sitemaps_single_query` szűrőben (paraméterei: `$args`, `$path`; részletesen az [XML-térkép hookjai](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-terkep-xml-es-video-hookok/) fejezetben) töröld a `product_visibility` feltételt a `tax_query` tömbből:

```php
add_filter( 'seopress_sitemaps_single_query', 'sajat_rejtett_termekek', 10, 2 );
function sajat_rejtett_termekek( $args, $path ) {
    if ( 'product' === $path && ! empty( $args['tax_query'] ) ) {
        foreach ( $args['tax_query'] as $kulcs => $feltetel ) {
            if ( is_array( $feltetel ) && isset( $feltetel['taxonomy'] ) && 'product_visibility' === $feltetel['taxonomy'] ) {
                unset( $args['tax_query'][ $kulcs ] );
            }
        }
    }
    return $args;
}
```

## Archívumlink a térképen

Ha egy tartalomtípusnak van archívumoldala, a SEOPress ennek az URL-jét is felveszi a tartalomtípus térképére. A `seopress_sitemaps_no_archive_link` szűrő a kész `<url>` XML-részletet (szöveg) és a tartalomtípus azonosítóját (`$path`) adja át. Szöveget kell visszaadnod: ha üres szöveget adsz vissza, az archívumlink nem kerül a térképre.

```php
add_filter( 'seopress_sitemaps_no_archive_link', 'sajat_archivum_link', 10, 2 );
function sajat_archivum_link( $sitemap_url, $path ) {
    if ( 'esemeny' === $path ) {
        return '';
    }
    return $sitemap_url;
}
```

## Kulcsszavak a Google News térképen

Ha a Google News térkép kulcsszavait bekapcsoltad, a SEOPress a tartalom célkulcsszavait írja a `<news:keywords>` elembe. A `seopress_sitemaps_news_keywords_value` szűrő ezt a szöveget adja át, és szöveget kell visszaadnod.

```php
add_filter( 'seopress_sitemaps_news_keywords_value', 'sajat_hir_kulcsszavak' );
function sajat_hir_kulcsszavak( $kulcsszavak ) {
    return $kulcsszavak . ', hírek';
}
```

## A HTML-térkép tartalomtípus-neve és termékkategóriái

| Hook | Paraméterek | Mit adj vissza |
|---|---|---|
| `seopress_sitemaps_html_cpt_name` | `$nev`, `$cpt_key` | A tartalomtípus megjelenítendő neve (a szakaszcím a térképen); szöveg. |
| `seopress_sitemaps_html_product_cat_query` | `$args_cat_query` | A termékkategóriák `get_terms()` paramétertömbje, módosítva. |

```php
add_filter( 'seopress_sitemaps_html_cpt_name', 'sajat_tipus_nev', 10, 2 );
function sajat_tipus_nev( $nev, $cpt_key ) {
    if ( 'product' === $cpt_key ) {
        return 'Termékeink';
    }
    return $nev;
}

add_filter( 'seopress_sitemaps_html_product_cat_query', 'sajat_termek_kategoriak' );
function sajat_termek_kategoriak( $args ) {
    $args['hide_empty'] = true;
    return $args;
}
```

A termékkategória-szűrő csak a termékek szakaszára vonatkozik; a taxonómia azonosítóját a SEOPress a szűrő után állítja be.