: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
* @package WPSEO\Admin\Menu
* Registers the admin menu on the left of the admin area.
class WPSEO_Admin_Menu extends WPSEO_Base_Menu {
* Registers all hooks to WordPress.
public function register_hooks() {
// Needs the lower than default priority so other plugins can hook underneath it without issue.
add_action( 'admin_menu', [ $this, 'register_settings_page' ], 5 );
* Registers the menu item submenus.
public function register_settings_page() {
$manage_capability = $this->get_manage_capability();
$page_identifier = $this->get_page_identifier();
$admin_page_callback = $this->get_admin_page_callback();
// Get all submenu pages.
$submenu_pages = $this->get_submenu_pages();
foreach ( $submenu_pages as $submenu_page ) {
if ( WPSEO_Capability_Utils::current_user_can( $submenu_page[3] ) ) {
$manage_capability = $submenu_page[3];
$page_identifier = $submenu_page[4];
$admin_page_callback = $submenu_page[5];
foreach ( $submenu_pages as $index => $submenu_page ) {
$submenu_pages[ $index ][0] = $page_identifier;
* The current user has the capability to control anything.
* This means that all submenus and dashboard can be shown.
global $admin_page_hooks;
'Yoast SEO: ' . __( 'Dashboard', 'wordpress-seo' ),
'Yoast SEO ' . $this->get_notification_counter(),
// Wipe notification bits from hooks.
// phpcs:ignore WordPress.WP.GlobalVariablesOverride -- This is a deliberate action.
$admin_page_hooks[ $page_identifier ] = 'seo';
// Add submenu items to the main menu if possible.
$this->register_submenu_pages( $submenu_pages );
* Returns the list of registered submenu pages.
* @return array List of registered submenu pages.
public function get_submenu_pages() {
$search_console_callback = null;
// Account for when the available submenu pages are requested from outside the admin.
if ( isset( $wpseo_admin ) ) {
$google_search_console = new WPSEO_GSC();
$search_console_callback = [ $google_search_console, 'display' ];
$this->get_submenu_page( __( 'General', 'wordpress-seo' ), $this->get_page_identifier() ),
__( 'Search Console', 'wordpress-seo' ),
$this->get_submenu_page( __( 'Tools', 'wordpress-seo' ), 'wpseo_tools' ),
$this->get_submenu_page( $this->get_license_page_title(), 'wpseo_licenses' ),
* Filter: 'wpseo_submenu_pages' - Collects all submenus that need to be shown.
* @param array $submenu_pages List with all submenu pages.
return (array) apply_filters( 'wpseo_submenu_pages', $submenu_pages );
* Returns the notification count in HTML format.
* @return string The notification count in HTML format.
protected function get_notification_counter() {
$notification_center = Yoast_Notification_Center::get();
$notification_count = $notification_center->get_notification_count();
/* translators: Hidden accessibility text; %s: number of notifications. */
$notifications = sprintf( _n( '%s notification', '%s notifications', $notification_count, 'wordpress-seo' ), number_format_i18n( $notification_count ) );
return sprintf( '<span class="update-plugins count-%1$d"><span class="plugin-count" aria-hidden="true">%1$d</span><span class="screen-reader-text">%2$s</span></span>', $notification_count, $notifications );
* Returns the capability that is required to manage all options.
* @return string Capability to check against.
protected function get_manage_capability() {
return 'wpseo_manage_options';