Hookok: RSS-változók, exportlekérdezések, jogosultság és tartalomtípusok

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.

Hook	Legkisebb verzió	Mire jó
seopress_rss_dyn_vars, seopress_rss_dyn_vars_value	5.2	Saját dinamikus változók az RSS-hírcsatorna elé és mögé írt HTML-ben.
seopress_metadata_query_args	3.7.3	A metaadat-export bejegyzéslekérdezésének módosítása.
seopress_metadata_query_terms_args	4.1	A metaadat-export taxonómia-lekérdezésének módosítása.
seopress_lb_widget_css	4.0	A helyi vállalkozás widget beágyazott CSS-ének módosítása.
seopress_capability	3.8.2	Más szerepkör is használhassa a SEOPress felületét.
seopress_post_types	3.7.3	A SEOPress által kezelt tartalomtípusok listájának módosítása.

Egyéni változók az RSS-hírcsatornában

Az RSS-hírcsatornában a bejegyzések elé és mögé írható HTML-ben (lásd RSS-hírcsatornák) a SEOPress a beépített változókat cseréli le: %%sitetitle%%, %%tagline%%, %%post_author%%, %%post_permalink%%, %%post_title%%. Saját változót két szűrővel adhatsz hozzá, és a két tömbnek azonos sorrendűnek kell lennie:

• seopress_rss_dyn_vars: a változónevek tömbje;
• seopress_rss_dyn_vars_value: a hozzájuk tartozó értékek tömbje.

add_filter( 'seopress_rss_dyn_vars', 'sajat_rss_valtozok' );
function sajat_rss_valtozok( $valtozok ) {
    $valtozok[] = '%%ceg_neve%%';
    return $valtozok;
}

add_filter( 'seopress_rss_dyn_vars_value', 'sajat_rss_ertekek' );
function sajat_rss_ertekek( $ertekek ) {
    $ertekek[] = 'Minta Kft.';
    return $ertekek;
}

Ezután a %%ceg_neve%% változót beírhatod az RSS HTML-mezőibe.

A metaadat-export lekérdezései

A metaadatok CSV-exportja (lásd CSV import és export) két külön lekérdezéssel dolgozik: egyikkel a bejegyzéseket, másikkal a taxonómia-elemeket olvassa be. Mindkettő szűrhető, a visszatérési érték a módosított lekérdezési tömb. Mindkét szűrő négy értéket kap: a lekérdezési tömböt, a kiválasztott tartalomtípusok (illetve taxonómiák) listáját, az egy lépésben exportált elemek számát és az eltolást.

• seopress_metadata_query_args: a bejegyzések lekérdezése. Alapból minden állapotú bejegyzést kér, dátum szerint csökkenő sorrendben.
• seopress_metadata_query_terms_args: a taxonómia-elemek lekérdezése.

add_filter( 'seopress_metadata_query_args', 'sajat_export_szuro', 10, 4 );
function sajat_export_szuro( $args, $tipusok, $increment, $offset ) {
    // Csak a közzétett bejegyzések kerüljenek az exportba.
    $args['post_status'] = 'publish';
    return $args;
}

A helyi vállalkozás widget CSS-e

A seopress_lb_widget_css szűrő a helyi vállalkozás widget elé írt <style> címkét adja át szövegként. Az alap stílus a widget soraiban lévő elemeket külön sorba teszi, a város és az irányítószám kivételével. Szöveget kapsz, és szöveget kell visszaadnod.

add_filter( 'seopress_lb_widget_css', 'sajat_lb_widget_css' );
function sajat_lb_widget_css( $css ) {
    return $css . '<style>.widget_seopress_pro_wrap_lb{font-size:.9em;}</style>';
}

A widgetről a Helyi vállalkozás fejezet szól.

A SEOPress használatához szükséges jogosultság

Alapból a SEOPress oldalait a manage_options jogosultsággal rendelkezők érik el (az átirányításoknál az edit_redirections az alap). A seopress_capability szűrő két értéket kap: az alapértelmezett jogosultságot és az oldal azonosítóját (például dashboard, titles_metas, xml_html_sitemap, advanced, import_settings, export_settings, license). A visszaadott jogosultságot a SEOPress csak akkor használja, ha a belépett felhasználó rendelkezik vele, különben marad az alap.

add_filter( 'seopress_capability', 'sajat_seopress_jogosultsag', 10, 2 );
function sajat_seopress_jogosultsag( $cap, $context ) {
    // A szerkesztők is elérhetik a SEOPress oldalait.
    return 'edit_pages';
}

A jogosultságokról bővebben a Felhasználói jogosultságok fejezetben olvashatsz.

A kezelt tartalomtípusok listája

A SEOPress a nyilvánosan megjeleníthető tartalomtípusokat kezeli, de alapból kihagyja a médiafájlokat, a saját belső típusait (404-es napló, pozíciókövetés, backlinkek) és néhány sablontípust (például Elementor- és Bricks-sablonok). A seopress_post_types szűrő a kész listát adja át (tartalomtípus-objektumok tömbje, a kulcs a típus neve), mellé két értéket: $return_all (igaz, ha a kihagyott típusok is benne vannak) és az eredeti lekérdezési paramétereket. Visszatérési értéknek a módosított listát add vissza.

add_filter( 'seopress_post_types', 'sajat_tartalomtipusok', 10, 3 );
function sajat_tartalomtipusok( $tipusok, $return_all, $args ) {
    // Egy saját típus kivétele a SEOPress kezeléséből.
    unset( $tipusok['kapcsolat_urlap'] );
    return $tipusok;
}