Как создать динамические шорткоды с параметрами в WordPress: практическое руководство

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

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

Что такое динамические шорткоды с параметрами и зачем они нужны

Динамические шорткоды — это шорткоды, поддерживающие передачу параметров, например, [wpkit_dynamic param1="value1" param2="value2"]. Параметры позволяют менять поведение шорткода без создания множества отдельных вариантов и дублирования кода.

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

Преимущества динамических шорткодов:

Гибкость и повторное использование одного шорткода для разных случаев.
Упрощение управления контентом без необходимости менять PHP-код.
Возможность создания пользовательских интерфейсов с параметризацией.

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

Создание шорткода с параметрами включает регистрацию функции обратного вызова и обработку входящих атрибутов. Рассмотрим пример создания шорткода [wpkit_dynamic], который выводит список постов из выбранной категории.

Регистрация шорткода и обработка параметров

function wpkit_dynamic_shortcode($atts) {
    // Определяем параметры и их значения по умолчанию
    $atts = shortcode_atts(
        array(
            'category' => '', // slug категории
            'posts' => 5 // число постов
        ), $atts, 'wpkit_dynamic'
    );

    // Если категория не указана, выводим предупреждение
    if (empty($atts['category'])) {
        return '<p>Пожалуйста, укажите параметр category</p>';
    }

    // Получаем посты из указанной категории
    $query = new WP_Query(array(
        'category_name' => sanitize_text_field($atts['category']),
        'posts_per_page' => intval($atts['posts'])
    ));

    if (!$query->have_posts()) {
        return '<p>Посты не найдены</p>';
    }

    $output = '<ul>';
    while ($query->have_posts()) {
        $query->the_post();
        $output .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
    }
    $output .= '</ul>';

    wp_reset_postdata();

    return $output;
}
add_shortcode('wpkit_dynamic', 'wpkit_dynamic_shortcode');

В этом примере:

Функция wpkit_dynamic_shortcode принимает атрибуты, где обязательным считается category.
Используется shortcode_atts для установки значений по умолчанию.
С помощью WP_Query выбираются последние посты указанной категории.
Формируется HTML-список с ссылками на найденные записи.

Расширение функционала: дополнительные параметры и валидация

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

Пример с дополнительными параметрами

function wpkit_dynamic_shortcode_extended($atts) {
    $atts = shortcode_atts(
        array(
            'category' => '',
            'posts' => 5,
            'order' => 'DESC', // ASC или DESC
            'show_thumbnail' => 'no' // yes или no
        ), $atts, 'wpkit_dynamic'
    );

    if (empty($atts['category'])) {
        return '<p>Параметр category обязателен</p>';
    }

    $order = in_array(strtoupper($atts['order']), array('ASC', 'DESC')) ? strtoupper($atts['order']) : 'DESC';
    $show_thumb = ($atts['show_thumbnail'] === 'yes');

    $query = new WP_Query(array(
        'category_name' => sanitize_text_field($atts['category']),
        'posts_per_page' => intval($atts['posts']),
        'order' => $order
    ));

    if (!$query->have_posts()) {
        return '<p>Посты не найдены</p>';
    }

    $output = '<ul class="wpkit-dynamic-list">';
    while ($query->have_posts()) {
        $query->the_post();
        $output .= '<li>';
        if ($show_thumb && has_post_thumbnail()) {
            $output .= get_the_post_thumbnail(get_the_ID(), 'thumbnail');
        }
        $output .= '<a href="' . get_permalink() . '">' . get_the_title() . '</a>';
        $output .= '</li>';
    }
    $output .= '</ul>';

    wp_reset_postdata();

    return $output;
}
add_shortcode('wpkit_dynamic', 'wpkit_dynamic_shortcode_extended');

Такой шорткод позволяет гибко управлять выводом, например:

[wpkit_dynamic category="news" posts="3" order="ASC" show_thumbnail="yes"]

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

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

1. Clearfy Pro

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

2. WPRemark

Позволяет создавать интерактивные элементы с использованием шорткодов, например, отзывы и рейтинги, что можно интегрировать в динамические шорткоды.

3. My Popup

С помощью шорткодов этого плагина можно динамически выводить всплывающие окна с контентом, адаптированным под параметры.

Советы по отладке и безопасности динамических шорткодов

При работе с динамическими шорткодами важно:

Всегда фильтровать и валидировать входящие параметры через функции sanitize_text_field, intval и другие.
Избегать прямого вывода пользовательских данных без экранирования, используйте esc_html и esc_url.
Тестировать шорткод с разными параметрами и сценариями, чтобы избежать ошибок и некорректного отображения.
При необходимости добавлять кеширование результата шорткода для повышения производительности.

Как интегрировать динамические шорткоды в тему или плагин на примере WPKit

Если вы используете тему или плагин WPKit, можно встроить шорткод в функционал с учетом особенностей платформы. Например, для подключения к системе кеширования Clearfy Pro или автоматического логирования вызовов шорткодов в WPKit.

Пример регистрации шорткода в файле функций темы WPKit (functions.php):

require_once get_template_directory() . '/inc/wpkit-shortcodes.php';

add_action('init', function() {
    add_shortcode('wpkit_dynamic', 'wpkit_dynamic_shortcode_extended');
});

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

Для подробных решений и готовых инструментов для оптимизации и управления WordPress рекомендуем посмотреть решения на WPSHOP.ru.

Динамические шорткоды с параметрами в WordPress: создание и применение