register_sidebars() WP 2.2
Создает указанное количество панелей виджетов (сайдбаров) одновременно. Функция создана для удобного создания нескольких панелей виджетов. Если нужно создать только одну панель, как это делается в большинстве тем, используйте функцию register_sidebar() или используйте эту функцию, указав единицу (1) в первом параметре.
Хуков нет.
Возвращает
Ничего не возвращает.
Использование
register_sidebars( $number, $args );
Шаблон использования
$args = array( 'name' => 'Sidebar %d', 'id' => "sidebar", 'before_widget' => '<li id="%1$s" class="widget %2$s">', 'after_widget' => '</li>', 'before_title' => '<h2 class="widgettitle">', 'after_title' => '</h2>' ); register_sidebars( 2, $args );
- $number(число)
- Сколько панелей создать, указывается число.
По умолчанию: 1 - $args(строка/массив)
Параметры для создаваемых панелей виджетов. Передаваемые параметры:
-
name - Название панели. Названия у создаваемых панелей должны быть разные, используйте %d в названии, которая будет заменена на порядковый номер панели. По умолчанию 'Sidebar %d'.
-
id - Идентификатор панели. К каждой следующией после первой панели автоматически будет добавлено число порядкового номера. Например если мы будем создавать 3 панели и укажем в id "sidebar", то получим: "Sidebar", "Sidebar-2", "Sidebar-3".
-
description - описание панели. При создании нескольких сайдбаров одновременно этот параметр не имеет смысла и по умолчанию пустой.
-
before_widget - HTML который будет расположен перед каждым виджетом в панели.
-
after_widget - HTML который будет расположен после каждого виджет в панели.
-
before_title - HTML который будет расположен перед каждым заголовком виджета панели.
- after_title - HTML который будет расположен после каждого заголовка виджета панели.
Можно указывать параметры в виде ассоциативного массива или в виде строки.
По умолчанию: по умолчанию-
Примеры
#1 Регистрация одной панели Аналог функции register_sidebar()
register_sidebars();
#2 Регистрация двух панелей
Этот пример показывает как зарегистрировать 2 панели с названиями "Foobar 1" and "Foobar 2":
register_sidebars( 2, ['name'=>'Foobar %d'] );
#3 Создадим 2 панели и поместим заголовок каждого виджета в тег <h1>
:
register_sidebars( 2, ['before_title'=>'<h1>','after_title'=>'</h1>'] );
Тоже самое, только укажем параметры в виде строки:
register_sidebars( 2, "before_title=<h1>&after_title=</h1>" )
Заметки
- Смотрите: register_sidebar() The second parameter is documented by register_sidebar() and is the same here.
- Global. Массив. $wp_registered_sidebars The new sidebars are stored in this array by sidebar ID.
Список изменений
С версии 2.2.0 | Введена. |
Код register_sidebars() register sidebars WP 5.6
Cвязанные функции
Из метки: sidebar (widget Виджет)
- dynamic_sidebar()
- is_active_sidebar()
- is_active_widget()
- is_dynamic_sidebar()
- is_registered_sidebar()
- register_sidebar()