Проверка, зарегистрирована ли боковая панель (IS_REGISTERED_SIDEBAR) │ WP 4.4.0

Функция проверки, зарегистрирована ли боковая панель (или сайдбар) в WordPress.

Время выполнения: 1 раз — 0.000013 сек (очень быстро) | 50000 раз — 0.02 сек (очень быстро)

Нет хуков (Hooks)

Результат (RETURN)

Функция возвращает true или false. Возвращает true, если боковая панель зарегистрирована, и false, если нет.

Использование (USAGE)

is_registered_sidebar( $sidebar_id );

• $sidebar_id (string|int) (обязательный): ID панели, когда она была зарегистрирована.

Примеры

Пример 1: Проверка, зарегистрирована ли боковая панель 'sidebar', и регистрация, если нет

add_action( 'widgets_init', 'register_my_widgets' );

function register_my_widgets(){
    if( is_registered_sidebar( 'sidebar' ) ){
        return;
    }

    register_sidebar( [
        'name'         => 'боковая панель сайта',
        'id'           => 'sidebar',
        'description'  => 'Эти виджеты будут отображаться в боковой панели сайта',
        'before_title' => '
',
        'after_title'  => '
'
    ] );
}

Примечания (NOTES)

• Глобальная переменная. Массив: $wp_registered_sidebars — зарегистрированные боковые панели.

История изменений (CHANGELOG)

• Начиная с версии 4.4.0 — введена функция.

Код функции (IS_REGISTERED_SIDEBAR)

function is_registered_sidebar( $sidebar_id ) {
    global $wp_registered_sidebars;

    return isset( $wp_registered_sidebars[ $sidebar_id ] );
}

Связанные функции

• Боковые панели (Widgets)
  • dynamic_sidebar()
  • is_active_sidebar()
  • is_active_widget()
  • is_dynamic_sidebar()
  • register_sidebar()
  • register_sidebars()
  • register_widget()
  • the_widget()
  • unregister_sidebar()
  • unregister_widget()
  • wp_get_sidebars_widgets()
  • wp_register_sidebar_widget()
  • wp_register_widget_control()
  • wp_unregister_sidebar_widget()
  • WP_Widget_Archives()
  • wp_widgets_init()

Эта информация поможет вам понять, как работает регистрация боковых панелей в WordPress и как можно использовать функцию is_registered_sidebar() для проверки их существования.