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

Автор: Степан Захаров | Опубликовано: 09.11.2025

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

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

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

Основные преимущества шорткодов:

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

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

Как создать простой шорткод в WordPress

Создание шорткода сводится к регистрации функции, которая возвращает HTML или другой вывод, и регистрации этой функции в системе WordPress с помощью add_shortcode.

Рассмотрим пример создания шорткода, который выводит текущую дату и время:

function wpdownload_current_datetime_shortcode($atts) {
    $atts = shortcode_atts(array(
        'format' => 'd.m.Y H:i:s'
    ), $atts, 'wpdownload_datetime');
    return date($atts['format']);
}
add_shortcode('wpdownload_datetime', 'wpdownload_current_datetime_shortcode');

Теперь, вставив в редактор [wpdownload_datetime], вы получите текущую дату и время в формате «день.месяц.год часы:минуты:секунды». Можно изменить формат, например: [wpdownload_datetime format="Y-m-d"].

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

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

Пример более сложного шорткода с параметрами:

function wpdownload_button_shortcode($atts) {
    $atts = shortcode_atts(array(
        'url' => '#',
        'text' => 'Нажми меня',
        'color' => 'blue'
    ), $atts, 'wpdownload_button');

    return '<a href="' . esc_url($atts['url']) . '" style="background-color:' . esc_attr($atts['color']) . '; padding:10px 15px; color:#fff; text-decoration:none; border-radius:4px;">' . esc_html($atts['text']) . '</a>';
}
add_shortcode('wpdownload_button', 'wpdownload_button_shortcode');

Использование в редакторе: [wpdownload_button url="https://wpdownload.ru" text="Перейти на WPDownload" color="green"]. Это выведет кнопку с ссылкой и заданным цветом.

Как обрабатывать вложенный контент в шорткодах (шорткоды с контентом)

Шорткоды могут содержать вложенный контент, который передаётся функции в параметре $content. Это полезно, например, для создания контейнеров, стилизованных блоков или элементов, в которые можно обернуть текст или HTML.

Пример шорткода с контентом:

function wpdownload_box_shortcode($atts, $content = null) {
    $atts = shortcode_atts(array(
        'title' => 'Заголовок'
    ), $atts, 'wpdownload_box');

    return '<div style="border:1px solid #ccc; padding:15px; margin:10px 0;"><h3>' . esc_html($atts['title']) . '</h3><div>' . do_shortcode($content) . '</div></div>';
}
add_shortcode('wpdownload_box', 'wpdownload_box_shortcode');

Использование:

[wpdownload_box title="Важное сообщение"]
Это содержимое, которое будет обёрнуто в стилизованный блок.
[/wpdownload_box]

Обратите внимание на вызов do_shortcode($content) — он позволяет обрабатывать вложенные шорткоды внутри контента.

Практические советы для создания шорткодов на WordPress

Безопасность и очистка данных

При работе с пользовательскими данными важно всегда выполнять очистку и экранирование. Используйте функции esc_html(), esc_url(), wp_kses_post() для вывода. Это защитит сайт от XSS-уязвимостей.

Кеширование результатов шорткодов

Если шорткод выполняет дорогостоящие операции (например, запросы к базе данных или API), имеет смысл реализовать кеширование результата с помощью Transients API. Это значительно повысит производительность сайта.

Поддержка вложенных шорткодов

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

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

Иногда нужно вызвать шорткод не в контенте записи, а прямо в PHP-файлах темы. Для этого используется функция do_shortcode(). Например:

echo do_shortcode('[wpdownload_button url="https://wpdownload.ru" text="Перейти на сайт" color="red"]');

Это удобно для вставки элементов в header, footer или другие части шаблона.

Заключение

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

Используйте описанные методы и примеры кода, чтобы легко создавать и настраивать шорткоды под свои задачи на wpdownload.ru.

Как создать и использовать шорткоды в WordPress