Megjelenés hookok: admin sáv, menü, beacon, widgetek és elsődleges kategória

Ez a fejezet azokat a hookokat gyűjti össze, amelyekkel a SEOPress admin felületén megjelenő elemeket változtathatod meg. A hookok használatának általános szabályait (hova másold a kódot, mit ellenőrizz előtte) a Composer és hookok használata fejezet írja le. A kódot általában a gyermeksablonod functions.php fájljába vagy egy saját bővítménybe tedd.

Hook	Típus	Legkisebb verzió	Mire jó
seopress_primary_term_inline_selector	szűrő	a legújabb kiadásokban érhető el	Az elsődleges kategória legördülőjének elrejtése a szerkesztőoldalon.
seopress_adminbar_counter	szűrő	8.7	Az admin sáv SEO-menüjén látható számláló módosítása.
wp_dashboard_setup	művelet	3.5	A SEOPress-widgetek eltávolítása a vezérlőpultról.
seopress_can_enqueue_universal_metabox	szűrő	5.0	Az univerzális SEO-metabox be- és kikapcsolása (például WooCommerce-termékeknél), illetve a beacon kikapcsolása.
seopress_beacon_svg	szűrő	5.0	Az univerzális SEO-metabox beacon-ikonjának cseréje.
seopress_seo_admin_menu_title	szűrő	4.4	A SEO menüpont nevének átírása.
seopress_adminbar_noindex	szűrő	4.1	Az admin sávban megjelenő noindex-figyelmeztetés HTML-jének módosítása.

Az elsődleges kategória legördülőjének elrejtése

A seopress_primary_term_inline_selector szűrő azt dönti el, hogy a szerkesztőoldalon a kategória-választó mellett megjelenjen-e az elsődleges kategória legördülője. Az alapérték true. A szűrő paraméterként a taxonómia nevét és az aktuális bejegyzéstípust is megkapja.

add_filter( 'seopress_primary_term_inline_selector', '__return_false' );

Jó tudni:

• A szűrő csak a legördülőt rejti el. Az már elmentett elsődleges kategória továbbra is érvényesül a %category% típusú permalinkeknél és a navigációs morzsában.
• Az elsődleges kategória nélküli bejegyzések továbbra is az alapértelmezett WordPress-kategóriát használják.
• Az elsődleges kategória mezője a SEO-metabox Haladó fülén továbbra is elérhető.
• Ha az elsődleges kategória funkciót egy taxonómiára teljesen ki akarod kapcsolni, a seopress_primary_term_taxonomies szűrőt használd.

Magáról a funkcióról az Elsődleges kategória fejezetben olvashatsz.

Az admin sáv számlálójának módosítása

A SEOPress az admin sáv SEO menüpontja mellett egy kis számlálót mutat, ha vannak értesítések. A seopress_adminbar_counter szűrő megkapja a számláló kész HTML-jét és az értesítések számát, és a visszaadott HTML jelenik meg. Ha üres szöveget adsz vissza, a számláló eltűnik:

add_filter( 'seopress_adminbar_counter', '__return_empty_string', 10, 2 );

A számláló csak akkor jelenik meg egyáltalán, ha van értesítés, és a megjelenés beállításai között nem rejtetted el.

A SEOPress-widgetek eltávolítása a vezérlőpultról

A vezérlőpult widgetjeit a WordPress wp_dashboard_setup művelete alatt lehet eltávolítani. A SEOPress PRO analitikai widgetjeinek azonosítói:

• seopress_ga_dashboard_widget (Google Analytics),
• seopress_matomo_dashboard_widget (Matomo Analytics).

add_action( 'wp_dashboard_setup', 'sajat_seopress_widgetek_eltavolitasa', 20 );
function sajat_seopress_widgetek_eltavolitasa() {
    remove_meta_box( 'seopress_ga_dashboard_widget', 'dashboard', 'normal' );
    remove_meta_box( 'seopress_matomo_dashboard_widget', 'dashboard', 'normal' );
}

A magasabb prioritás (20) azért kell, hogy a kódod a widgetek regisztrálása után fusson le.

Az univerzális SEO-metabox bekapcsolása (például WooCommerce-termékhez)

A seopress_can_enqueue_universal_metabox szűrő dönti el, hogy az adott szerkesztőoldalon betöltődik-e az univerzális SEO-metabox. Ha true értéket adsz vissza, a metabox megjelenik, így például a WooCommerce-termékek szerkesztőjében vagy bármely más bejegyzéstípusnál is használhatod.

add_filter( 'seopress_can_enqueue_universal_metabox', '__return_true' );

A beacon kikapcsolása

Ugyanezzel a szűrővel kapcsolhatod ki a SEO-beacont is: ha false értéket adsz vissza, az univerzális metabox nem töltődik be.

add_filter( 'seopress_can_enqueue_universal_metabox', '__return_false' );

A frontenden a beacon elrejtésére a megjelenés beállításai között külön kapcsoló is van. A szűrő minden esetben felülírja azt, mert utolsóként fut le.

A beacon ikonjának cseréje

A seopress_beacon_svg szűrő az univerzális SEO-metabox beacon-ikonjának címét adja meg (az alapérték a SEOPress saját beacon.svg fájlja). Adj vissza egy saját SVG-fájl URL-jét:

add_filter( 'seopress_beacon_svg', 'sajat_beacon_ikon' );
function sajat_beacon_ikon( $url ) {
    return get_stylesheet_directory_uri() . '/img/sajat-beacon.svg';
}

A SEO menüpont nevének átírása

A seopress_seo_admin_menu_title szűrő a bal oldali admin menü SEO feliratát adja meg. Add vissza az új nevet:

add_filter( 'seopress_seo_admin_menu_title', 'sajat_seo_menu_nev' );
function sajat_seo_menu_nev( $cim ) {
    return 'Keresőoptimalizálás';
}

A PRO csomag white label funkciója is ezt a szűrőt használja a menü átnevezéséhez.

A noindex-figyelmeztetés módosítása az admin sávban

Ha az oldal noindex jelzést kap (a webhely nem engedi az indexelést, vagy a keresőmotorok láthatóságát a WordPress kikapcsolta), a SEOPress egy figyelmeztetést tesz az admin sávba: egy áthúzott szem ikont és a noindex is on! feliratot, amely a noindex beállításait tartalmazó fülre mutat. A seopress_adminbar_noindex szűrő megkapja ennek a HTML-jét, és a visszaadott érték jelenik meg. Üres szöveggel eltünteted:

add_filter( 'seopress_adminbar_noindex', '__return_empty_string' );

Ha a SEOPress menüt teljesen eltávolítottad az admin sávból, a noindex-figyelmeztetés akkor is önállóan megjelenik, mert fontos jelzés (például egy véletlenül noindexre hagyott éles oldalnál). Elrejteni a megjelenés beállításai között lehet.