Область виджетов

Тема заранее решает, в каких частях страницы допустимо дополнительное содержимое, и даёт каждой такой зоне имя. Владелец сайта в разделе «Внешний вид → Виджеты» видит список этих зон и наполняет их: поиск, свежие записи, текст с контактами, форма подписки. Сколько областей будет и где они окажутся на экране, определяет только тема. Самая привычная из них — боковая область, но бывают и колонки подвала, и места внутри контента.

Регистрация и вывод

// functions.php
add_action( 'widgets_init', function () {
    register_sidebar( [
        'id'            => 'footer-1',
        'name'          => 'Подвал, первая колонка',
        'before_widget' => '<div id="%1$s" class="widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<h3 class="widget-title">',
        'after_title'   => '</h3>',
    ] );
} );

// footer.php
if ( is_active_sidebar( 'footer-1' ) ) {
    dynamic_sidebar( 'footer-1' );
}

Проверка is_active_sidebar() нужна, чтобы не выводить пустую обёртку, когда в области ничего нет. Функция называется «sidebar» по историческим причинам: изначально области были только боковыми.

Блочный редактор виджетов

С версии 5.8 экран виджетов работает на блоках: в область можно поставить любой блок, а старые виджеты остаются доступны как блоки «Устаревший виджет». Состав областей сохраняется в опции sidebars_widgets, а содержимое блоков — в настройках виджетов. Если тема или плагины с новым экраном несовместимы, официальный плагин Classic Widgets возвращает прежний интерфейс.

Куда исчезают виджеты

При смене темы WordPress пытается сопоставить старые области с новыми. То, что не нашло пары, переносится в «Неактивные виджеты» — внизу того же экрана. Настройки там сохраняются, и виджет можно перетащить в новую область. В блочных темах областей виджетов нет: их роль играют части блочного шаблона, которые правят в редакторе сайта.