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

Автор: Георгий Попов | Опубликовано: 02.11.2025

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

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

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

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

Регистрация динамического шорткода: базовый пример

Для начала создадим простой шорткод, который принимает атрибуты и выводит динамический контент. В WordPress шорткод регистрируется с помощью функции add_shortcode(). В качестве примера сделаем шорткод [wpco_greeting], который выводит приветствие с именем, переданным в атрибуте.

function wpco_greeting_shortcode($atts) {
    $atts = shortcode_atts(
        array(
            'name' => 'Гость',
        ), $atts, 'wpco_greeting'
    );
    return 'Привет, ' . esc_html($atts['name']) . '! Добро пожаловать на наш сайт.';
}
add_shortcode('wpco_greeting', 'wpco_greeting_shortcode');

Теперь в любом месте сайта можно вставить [wpco_greeting name="Иван"], и пользователь увидит «Привет, Иван! Добро пожаловать на наш сайт.».

Объяснение кода

Функция wpco_greeting_shortcode сначала обрабатывает атрибуты через shortcode_atts, задавая значение по умолчанию. Затем возвращает строку с безопасным выводом через esc_html для защиты от XSS.

Пример: динамический список последних записей по категории

Частая задача — вывести список последних записей из определённой категории, заданной в атрибуте шорткода. Сделаем шорткод [wpco_latest_posts category="news" count="5"]:

function wpco_latest_posts_shortcode($atts) {
    $atts = shortcode_atts(
        array(
            'category' => '',
            'count' => 5,
        ), $atts, 'wpco_latest_posts'
    );

    $args = array(
        'posts_per_page' => intval($atts['count']),
        'category_name' => sanitize_text_field($atts['category']),
        'post_status' => 'publish',
    );

    $query = new WP_Query($args);
    if (!$query->have_posts()) {
        return 'Нет записей для отображения.';
    }

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

    return $output;
}
add_shortcode('wpco_latest_posts', 'wpco_latest_posts_shortcode');

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

Шорткод с условной логикой и использованием пользовательских данных

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

function wpco_user_greeting_shortcode() {
    if (is_user_logged_in()) {
        $current_user = wp_get_current_user();
        return 'Привет, ' . esc_html($current_user->display_name) . '! Спасибо, что вернулись.';
    } else {
        return 'Здравствуйте, гость! Пожалуйста, войдите или зарегистрируйтесь.';
    }
}
add_shortcode('wpco_user_greeting', 'wpco_user_greeting_shortcode');

Такой шорткод адаптируется под контекст, улучшая взаимодействие с пользователем.

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

Если хочется упростить создание и управление шорткодами, можно использовать готовые плагины:

Shortcodes Ultimate — один из самых популярных плагинов с множеством готовых шорткодов и удобным визуальным редактором;
WP Shortcode by MyThemeShop — предлагает набор полезных шорткодов и простой интерфейс;
Custom Content Shortcode — позволяет создавать собственные шорткоды без написания кода;
Shortcoder — для создания и вставки сложных HTML, CSS и JavaScript блоков через шорткоды.

Эти инструменты помогут ускорить разработку и упростить управление динамическим контентом.

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

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

Всегда фильтруйте и экранируйте входящие параметры через sanitize_text_field, intval, esc_html и другие функции безопасности;
Избегайте выполнения тяжелых запросов в шорткодах, чтобы не замедлять загрузку страниц;
Используйте wp_cache или transient API для кэширования динамического контента, если он не меняется слишком часто;
Не забывайте сбрасывать глобальные переменные после пользовательских циклов (wp_reset_postdata()), чтобы избежать конфликтов с другими частями темы или плагинов;
Тестируйте шорткоды на разных устройствах и с разными пользователями, чтобы убедиться в корректном выводе.

Пример кэширования результата шорткода с использованием transient API

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

function wpco_latest_posts_cached_shortcode($atts) {
    $atts = shortcode_atts(
        array(
            'category' => '',
            'count' => 5,
        ), $atts, 'wpco_latest_posts_cached'
    );

    $cache_key = 'wpco_latest_posts_' . md5($atts['category'] . '_' . $atts['count']);
    $cached_output = get_transient($cache_key);

    if ($cached_output !== false) {
        return $cached_output;
    }

    $args = array(
        'posts_per_page' => intval($atts['count']),
        'category_name' => sanitize_text_field($atts['category']),
        'post_status' => 'publish',
    );

    $query = new WP_Query($args);
    if (!$query->have_posts()) {
        return 'Нет записей для отображения.';
    }

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

    set_transient($cache_key, $output, 12 * HOUR_IN_SECONDS); // Кэшируем на 12 часов

    return $output;
}
add_shortcode('wpco_latest_posts_cached', 'wpco_latest_posts_cached_shortcode');

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

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