WP_GET_SIDEBAR() │ WP 5.9.0
Функция wp_get_sidebar() позволяет получить зарегистрированную боковую панель (sidebar) по заданному ID.
Возврат
Функция возвращает массив с данными боковой панели или null, если панель с указанным ID не зарегистрирована.
Использование
wp_get_sidebar( $id );
Параметры
$id (строка, обязательный) — ID боковой панели.
Примеры
Предположим, мы зарегистрировали боковую панель с помощью функции register_sidebar(), и у нас есть боковая панель с ID 'sidebar'. Мы можем получить её данные следующим образом:
$sidebar = wp_get_sidebar( 'sidebar' );
print_r( $sidebar );
Если боковая панель успешно найдена, этот код выведет что-то вроде этого:
Array
(
[name] => Sidebar
[id] => sidebar
[description] => Виджетная область в боковой панели.
[class] => some-class
[before_widget] => "
n",
[after_widget] =>
[before_title] => '',
[before_sidebar] =>
[after_sidebar] =>
[show_in_rest] =>
)
Примечания
- Глобальная переменная
$wp_registered_sidebars содержит все зарегистрированные боковые панели в массиве.
Изменения
Функция была введена в версии 5.9.0.
Код WP_GET_SIDEBAR
Вот как выглядит реализация функции wp_get_sidebar() внутри WordPress:
function wp_get_sidebar( $id ) {
global $wp_registered_sidebars;
foreach ( (array) $wp_registered_sidebars as $sidebar ) {
if ( $sidebar['id'] === $id ) {
return $sidebar;
}
}
if ( 'wp_inactive_widgets' === $id ) {
return array(
'id' => 'wp_inactive_widgets',
'name' => __( 'Неактивные виджеты' ),
);
}
return null;
}
Связанные функции
dynamic_sidebar()is_active_sidebar()is_active_widget()is_dynamic_sidebar()is_registered_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_widgets_init()
Эти функции помогают управлять виджетами и боковыми панелями в WordPress, позволяя вам кастомизировать внешний вид вашего сайта.
