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

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 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 és a HTML-térkép hookjai 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:

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:

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.

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 fejezetben) töröld a product_visibility feltételt a tax_query tömbből:

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.

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.

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.

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.