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

Автор: Дарья Данилова | Опубликовано: 06.01.2026

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

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

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

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

Создание динамических виджетов расширяет возможности стандартного функционала WordPress и позволяет создавать уникальные решения под конкретные задачи.

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

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

class WPKit_Dynamic_Widget extends WP_Widget {
    public function __construct() {
        parent::__construct(
            'wpkit_dynamic_widget',
            'WPKit Динамический виджет',
            array('description' => 'Виджет с динамическим содержимым')
        );
    }

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

        if (is_front_page()) {
            echo '<p>Добро пожаловать на главную страницу!</p>';
        } elseif (is_category()) {
            $category = get_queried_object();
            echo '<p>Вы находитесь в категории: <strong>' . esc_html($category->name) . '</strong></p>';
            // Можно добавить вывод постов из категории
        } elseif (is_user_logged_in()) {
            $current_user = wp_get_current_user();
            echo '<p>Привет, ' . esc_html($current_user->display_name) . '!</p>';
        } else {
            echo '<p>Добро пожаловать, гость!</p>';
        }

        echo $args['after_widget'];
    }

    public function form($instance) {
        // Здесь можно добавить настройки виджета
        echo '<p>Настроек пока нет.</p>';
    }

    public function update($new_instance, $old_instance) {
        return $old_instance;
    }
}

function wpkit_register_dynamic_widget() {
    register_widget('WPKit_Dynamic_Widget');
}
add_action('widgets_init', 'wpkit_register_dynamic_widget');

Этот код создаст простой виджет, который будет показывать разный текст на главной, в категориях, для авторизованных пользователей и для гостей.

Расширение виджета: добавление настроек и кастомного вывода

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

Обновим методы form и update, а также немного изменим вывод:

class WPKit_Dynamic_Widget extends WP_Widget {
    public function __construct() {
        parent::__construct(
            'wpkit_dynamic_widget',
            'WPKit Динамический виджет',
            array('description' => 'Виджет с динамическим содержимым и настройками')
        );
    }

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

        $guest_text = !empty($instance['guest_text']) ? $instance['guest_text'] : 'Добро пожаловать, гость!';
        $user_text = !empty($instance['user_text']) ? $instance['user_text'] : 'Привет, пользователь!';

        if (is_front_page()) {
            echo '<p>Добро пожаловать на главную страницу!</p>';
        } elseif (is_category()) {
            $category = get_queried_object();
            echo '<p>Вы находитесь в категории: <strong>' . esc_html($category->name) . '</strong></p>';
        } elseif (is_user_logged_in()) {
            $current_user = wp_get_current_user();
            echo '<p>' . esc_html($user_text) . ' ' . esc_html($current_user->display_name) . '!</p>';
        } else {
            echo '<p>' . esc_html($guest_text) . '</p>';
        }

        echo $args['after_widget'];
    }

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

    public function update($new_instance, $old_instance) {
        $instance = array();
        $instance['guest_text'] = (!empty($new_instance['guest_text'])) ? sanitize_text_field($new_instance['guest_text']) : '';
        $instance['user_text'] = (!empty($new_instance['user_text'])) ? sanitize_text_field($new_instance['user_text']) : '';
        return $instance;
    }
}

// Регистрация виджета остается прежней

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

Динамические виджеты с выводом данных из базы и REST API

Часто требуется выводить не просто статичный или предопределённый текст, а данные из базы данных WordPress или из внешних источников через REST API. Рассмотрим пример вывода последних 5 постов текущей категории в виджете.

Для этого в методе widget добавим код для получения постов:

if (is_category()) {
    $category = get_queried_object();
    echo '<p>Последние статьи в категории <strong>' . esc_html($category->name) . '</strong>:</p>';

    $posts = get_posts(array(
        'category' => $category->term_id,
        'numberposts' => 5,
        'post_status' => 'publish'
    ));

    if ($posts) {
        echo '<ul>';
        foreach ($posts as $post) {
            echo '<li><a href="' . get_permalink($post) . '">' . esc_html($post->post_title) . '</a></li>';
        }
        echo '</ul>';
    } else {
        echo '<p>Публикаций нет.</p>';
    }
}

Такой подход полезен для вывода актуальной информации прямо в виджете и позволяет создавать гибкие решения.

Если же нужно получить данные из внешнего REST API, можно использовать функцию wp_remote_get() и обработать JSON-ответ. Например:

$response = wp_remote_get('https://api.example.com/data');
if (is_array($response) && !is_wp_error($response)) {
    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);
    if (!empty($data)) {
        echo '<ul>';
        foreach ($data as $item) {
            echo '<li>' . esc_html($item['title']) . '</li>';
        }
        echo '</ul>';
    }
} else {
    echo '<p>Ошибка загрузки данных</p>';
}

Интеграция с плагином Clearfy Pro для улучшения виджетов

Если вы используете на сайте Clearfy Pro от WPShop, то можете дополнительно оптимизировать работу виджетов:

Отключать ненужные виджеты для повышения скорости загрузки страниц;
Использовать функции Clearfy для скрытия виджетов на определённых страницах без кода;
Применять фильтры производительности, чтобы избежать лишних запросов из виджетов.

Такой подход позволяет комбинировать кастомные решения с готовыми инструментами для достижения максимальной эффективности.

Резюме и рекомендации по созданию динамических виджетов

Создание динамических виджетов в WordPress — это отличный способ расширить функционал сайта и сделать контент более персонализированным и актуальным. Основные шаги:

Создайте класс, наследующий WP_Widget;
Опишите логику вывода в методе widget, учитывая контекст страницы;
Добавьте настройки в методы form и update для удобства управления;
Используйте функции WordPress для получения данных из базы или внешних API;
Тестируйте виджет на разных типах страниц для корректности работы.

Также советуем использовать инструменты оптимизации и кэширования, чтобы динамические виджеты не замедляли сайт. Например, популярный плагин WP Rocket или встроенные возможности Clearfy Pro помогут в этом.