UNREGISTER_SIDEBAR() │ WP 2.2.0

Функция unregister_sidebar() позволяет удалить сайдбар из списка зарегистрированных. Это полезно, если вам не нужны некоторые боковые панели (сайдбары) на вашем сайте.

Результат

Функция не возвращает ничего (null).

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

Чтобы удалить сайдбар, используйте следующий код:

unregister_sidebar( $sidebar_id );

• $sidebar_id (string|int) — обязательный параметр, который указывает идентификатор сайдбара, который вы хотите удалить.

Примеры

Удаление зарегистрированных сайдбаров

Если вы добавите следующий код в файл functions.php вашей темы, сайдбары, зарегистрированные для темы TwentyTen, будут удалены:

add_action( 'widgets_init', 'remove_some_widgets', 11 );

function remove_some_widgets() {
    // Удаляем некоторые виджеты
    unregister_sidebar( 'first-footer-widget-area' );
    unregister_sidebar( 'second-footer-widget-area' );
    unregister_sidebar( 'third-footer-widget-area' );
    unregister_sidebar( 'fourth-footer-widget-area' );
}

В этом примере мы установили приоритет 11 для хука widgets_init. Это необходимо, потому что функции дочерней темы подключаются раньше, чем функции основной темы. Если оставить приоритет пустым, он будет равен 10, и сайдбары не будут удалены.

Изменяя приоритет нашего хука, мы можем быть уверены, что он будет вызываться после загрузки файла functions.php родительской темы.

Примечания

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

Изменения

Представлена в версии 2.2.0.

Код функции UNREGISTER_SIDEBAR

function unregister_sidebar( $sidebar_id ) {
    global $wp_registered_sidebars;

    unset( $wp_registered_sidebars[ $sidebar_id ] );
}

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

Вот некоторые функции, которые могут быть вам полезны при работе с сайдбарами:

• dynamic_sidebar() — выводит динамический сайдбар.
• is_active_sidebar() — проверяет, активен ли сайдбар.
• register_sidebar() — регистрирует новый сайдбар.
• unregister_widget() — удаляет виджет из списка.
• wp_get_sidebars_widgets() — получает виджеты для всех сайдбаров.

Эти функции помогут вам более эффективно управлять сайдбарами на вашем сайте WordPress.