Как создать динамический виджет в WordPress с примером кода

Автор: Ярослав Быков | Опубликовано: 20.11.2025

Что такое динамический виджет и зачем он нужен в WordPress

Динамический виджет — это виджет, который меняет своё содержимое в зависимости от контекста страницы, времени, пользователя или других условий. В отличие от статических виджетов, которые показывают один и тот же контент на всех страницах, динамические виджеты позволяют улучшить взаимодействие с посетителем и повысить удобство сайта. Например, можно показывать разные новости, акции или контакты в зависимости от категории, где находится пользователь.

В WordPress стандартно можно создавать виджеты через административную панель, но для динамики потребуется либо готовый плагин с расширенными функциями, либо написать собственный виджет на PHP. Это особенно полезно, когда нужно тонко настроить отображение и логику.

В этой статье мы рассмотрим, как создать динамический виджет с помощью собственного кода, а также познакомимся с полезными плагинами, которые помогут в этом без программирования.

Использование плагинов для динамических виджетов: плюсы и минусы

Наиболее популярные плагины для создания динамических виджетов:

Widget Logic — позволяет добавлять условия отображения виджетов с помощью PHP-кода прямо в админке.
Dynamic Widgets — расширяет стандартный функционал виджетов, добавляя условия по ролям пользователя, страницам, времени и т.д.
Content Aware Sidebars — даёт возможность создавать разные сайдбары для разных страниц, что тоже можно использовать для динамического показа.

Преимущества использования плагинов очевидны: нет необходимости писать код, достаточно настроить условия через интерфейс. Но есть и недостатки — ограниченная гибкость и возможные конфликты с другими плагинами или темой.

Если нужны точные настройки и высокая производительность, лучше написать собственный виджет.

Создание собственного динамического виджета в WordPress: пошаговое руководство

1. Регистрация нового виджета

Создаём класс виджета, наследуемый от WP_Widget. В конструкторе задаём имя и описание.

class WPKPI_Dynamic_Widget extends WP_Widget {
    public function __construct() {
        parent::__construct(
            'wpkpi_dynamic_widget',
            __( 'Динамический виджет WPKPI', 'wpkpi' ),
            array( 'description' => __( 'Виджет с динамическим контентом', 'wpkpi' ) )
        );
    }

2. Вывод виджета с учетом условий

В методе widget мы можем проверять, на какой странице мы находимся, и выводить разный HTML.

public function widget( $args, $instance ) {
    echo $args['before_widget'];

    if ( is_home() ) {
        echo '<p>Это главный блоговый виджет для главной страницы.</p>';
    } elseif ( is_category() ) {
        $category = get_queried_object();
        echo '<p>Вы находитесь в категории: ' . esc_html( $category->name ) . '</p>';
    } else {
        echo '<p>Привет, посетитель! Это виджет для всех остальных страниц.</p>';
    }

    echo $args['after_widget'];
}

3. Добавление настроек виджета в админке

Чтобы администратор мог менять параметры, например текст для главной, добавим методы form и update:

public function form( $instance ) {
    $home_text = ! empty( $instance['home_text'] ) ? $instance['home_text'] : '';
    ?>
    <p>
        <label for="<?php echo esc_attr( $this->get_field_id( 'home_text' ) ); ?>">Текст для главной страницы:</label>
        <input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'home_text' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'home_text' ) ); ?>" type="text" value="<?php echo esc_attr( $home_text ); ?>" />
    </p>
    <?php
}

public function update( $new_instance, $old_instance ) {
    $instance = array();
    $instance['home_text'] = sanitize_text_field( $new_instance['home_text'] );
    return $instance;
}

4. Использование настроек в выводе

В методе widget можно вывести пользовательский текст из настроек:

public function widget( $args, $instance ) {
    echo $args['before_widget'];

    $home_text = ! empty( $instance['home_text'] ) ? $instance['home_text'] : 'Добро пожаловать на главную страницу!';

    if ( is_home() ) {
        echo '<p>' . esc_html( $home_text ) . '</p>';
    } else {
        echo '<p>Это виджет для остальных страниц.</p>';
    }

    echo $args['after_widget'];
}

5. Регистрация виджета в WordPress

Последний шаг — зарегистрировать виджет в функции хука widgets_init:

function wpkpi_register_dynamic_widget() {
    register_widget( 'WPKPI_Dynamic_Widget' );
}
add_action( 'widgets_init', 'wpkpi_register_dynamic_widget' );

Примеры использования динамических виджетов в реальных задачах

Отображение разных баннеров в зависимости от категории

Если у вас интернет-магазин или блог с несколькими тематиками, полезно показывать баннеры с акциями, релевантные текущей категории. Например, в методе widget можно получить ID категории и вывести разный баннер:

if ( is_category() ) {
    $cat_id = get_queried_object_id();
    switch ( $cat_id ) {
        case 10:
            echo '<img src="/banners/sale-10.jpg" alt="Акция для категории 10" />';
            break;
        case 15:
            echo '<img src="/banners/sale-15.jpg" alt="Акция для категории 15" />';
            break;
        default:
            echo '<img src="/banners/sale-default.jpg" alt="Общая акция" />';
    }
}

Показ приветствия зарегистрированному пользователю

Динамический виджет можно настроить так, чтобы он менял сообщение для авторизованных пользователей:

if ( is_user_logged_in() ) {
    $current_user = wp_get_current_user();
    echo '<p>Привет, ' . esc_html( $current_user->display_name ) . '! Спасибо, что вернулись.</p>';
} else {
    echo '<p>Добро пожаловать, гость!</p>';
}

Вывод последних записей с определённой таксономией

Ещё одна распространённая задача — показывать последние посты, относящиеся к определённой категории или метке, чтобы привлечь внимание к свежему контенту:

$recent_posts = new WP_Query( array(
    'posts_per_page' => 5,
    'category_name' => 'novosti',
) );

if ( $recent_posts->have_posts() ) {
    echo '<ul>';
    while ( $recent_posts->have_posts() ) {
        $recent_posts->the_post();
        echo '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
    }
    echo '</ul>';
    wp_reset_postdata();
} else {
    echo '<p>Нет новых записей в категории новостей.</p>';
}

Советы по оптимизации и безопасности динамических виджетов

При создании динамических виджетов важно помнить:

Используйте функции экранирования esc_html, esc_attr, wp_kses_post для вывода данных, чтобы избежать XSS-уязвимостей.
Минимизируйте количество запросов к базе данных. Используйте кэширование результатов, если виджет выполняет сложные запросы.
Избегайте тяжелой логики в методе widget, чтобы не замедлять загрузку страниц.
Проверяйте права пользователя при отображении персонализированного контента.

Следуя этим правилам, вы сделаете виджеты не только удобными, но и безопасными для сайта.

Заключение по теме создания динамического виджета

Создание динамического виджета в WordPress даёт мощный инструмент для персонализации и улучшения UX. Вы можете использовать готовые плагины для простых условий или написать собственный код, чтобы получить максимум гибкости. Важно учитывать производительность и безопасность. Приведённый пример с классом виджета на PHP — отличная база для дальнейших доработок под любые задачи.