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

Автор: Лев Титов | Опубликовано: 27.11.2025

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

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

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

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

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

Как зарегистрировать свой шорткод в WordPress – пошаговая инструкция

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

function wordpressa_custom_shortcode($atts) {
    return '<div>Привет, это мой шорткод!</div>';
}
add_shortcode('wordpressa_hello', 'wordpressa_custom_shortcode');

В данном примере шорткод [wordpressa_hello] выведет простой блок с текстом. Добавьте этот код в файл functions.php вашей темы или в свой плагин.

Важно использовать префикс, связанный с вашим сайтом или плагином (здесь wordpressa_), чтобы избежать конфликтов с другими шорткодами.

Передача параметров в шорткод и их обработка

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

function wordpressa_custom_shortcode($atts) {
    $atts = shortcode_atts(array(
        'text' => 'Привет, мир!',
        'color' => 'blue'
    ), $atts, 'wordpressa_hello');

    return '<div style="color:' . esc_attr($atts['color']) . ';">' . esc_html($atts['text']) . '</div>';
}
add_shortcode('wordpressa_hello', 'wordpressa_custom_shortcode');

Теперь вызов [wordpressa_hello text="Привет WordPress!" color="red"] выведет красный текст «Привет WordPress!». Это простой способ делать шорткод универсальным.

Пример сложного шорткода: вывод списка последних записей с настройками

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

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

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

    if (!empty($atts['category'])) {
        $args['category_name'] = sanitize_text_field($atts['category']);
    }

    $query = new WP_Query($args);

    if (!$query->have_posts()) {
        return '<p>Записей не найдено.</p>';
    }

    $output = '<ul class="wordpressa-latest-posts">';
    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('wordpressa_latest_posts', 'wordpressa_latest_posts_shortcode');

Пример использования: [wordpressa_latest_posts count="3" category="novosti"] выведет 3 последних поста из категории «novosti».

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

Иногда нужно вывести результат шорткода прямо в коде шаблона PHP. Для этого используется функция do_shortcode.

echo do_shortcode('[wordpressa_hello text="Привет из шаблона" color="green"]');

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

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

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

Shortcodes Ultimate — набор из более чем 50 готовых шорткодов с визуальным редактором.
Custom Content Shortcode — позволяет создавать шорткоды для вывода произвольного контента.
Shortcoder — простой плагин для создания собственных шорткодов с HTML, Javascript или PHP.

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

Заключение

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

Как создать собственный шорткод в WordPress