🔷 Блок: Shortcode / Шорткод
📌 Что это
Shortcode — это виджет-блок Gutenberg для вставки короткого кода, который WordPress или плагин потом превращает в готовый элемент на сайте.
Шорткод обычно выглядит так:
[gallery]или так:
[contact-form-7 id="123" title="Contact form"]Простыми словами:
Shortcode = короткая команда, которая вставляет готовую функцию на страницу.
⚙️ Функции
Блок позволяет:
вставить shortcode от плагина;
вывести форму;
вывести галерею;
вывести слайдер;
вывести календарь;
вывести таблицу;
вывести каталог;
вывести виджет бронирования;
вывести кастомный элемент темы или плагина;
использовать старые функции WordPress, которые ещё работают через shortcodes.
🎯 Зачем нужен
Чтобы вставить на страницу элемент, который создаётся не обычным Gutenberg-блоком, а через плагин или специальную функцию.
Например, ты установил плагин формы, а он даёт тебе код:
[contact-form-7 id="456" title="Feedback form"]Ты вставляешь этот код в блок Shortcode, и на сайте появляется форма.
📍 Где используется чаще всего
страницы контактов;
формы обратной связи;
квиз-формы;
галереи;
слайдеры;
таблицы;
каталоги;
календарь событий;
бронирование;
платёжные формы;
старые плагины;
кастомные функции сайта.
⚠️ Важно
Shortcode сам по себе ничего не создаёт.
Он работает только если WordPress, тема или плагин знают, что этот shortcode означает.
Например:
[contact-form-7 id="123"]сработает только если установлен и активен плагин Contact Form 7.
Если плагина нет, на странице может просто отобразиться сам текст:
[contact-form-7 id="123"]⚠️ Shortcode или Custom HTML
Они похожи тем, что оба могут вставлять внешние или нестандартные элементы, но логика разная.
Custom HTML — ты вставляешь HTML-код:
<iframe src="https://example.com"></iframe>Shortcode — ты вставляешь короткую команду:
[my_form id="123"]Простыми словами:
Custom HTML = вставка HTML-кода
Shortcode = вставка команды от WordPress/плагина⚠️ Когда использовать Shortcode
Используй Shortcode, если плагин прямо дал тебе код в квадратных скобках.
Например:
[form id="1"]
[slider id="home"]
[events_calendar]
[products category="shoes"]В таком случае правильный блок:
Shortcode⚠️ Когда лучше не использовать
Если для нужной функции уже есть нормальный Gutenberg-блок, лучше использовать его.
Например, если плагин формы даёт и блок, и shortcode, лучше выбрать блок, потому что его удобнее настраивать визуально.
То есть:
Есть готовый Gutenberg-блок → лучше использовать блок
Есть только shortcode → используем Shortcode⚠️ Шорткоды — это немного старый подход
До Gutenberg shortcodes использовались очень часто.
Сейчас многие плагины уже делают свои полноценные блоки для редактора.
Но shortcodes всё ещё активно используются, особенно в старых или универсальных плагинах.
Поэтому знать их нужно.
⚠️ Тема и плагины могут влиять
Shortcode зависит не столько от темы, сколько от плагина или функции, которая его создала.
Если shortcode не работает, возможные причины:
плагин отключён;
плагин удалён;
shortcode написан с ошибкой;
id элемента неправильный;
тема или безопасность сайта блокирует часть вывода;
shortcode нельзя использовать в этом месте.
🧠 Простыми словами
Shortcode — это блок для вставки короткой команды в квадратных скобках.
Если плагин дал тебе код типа:
[что-то id="123"]ты вставляешь его в блок Shortcode, и WordPress превращает его в нужный элемент.
Для HTML-кода — Custom HTML.
Для кода в квадратных скобках — Shortcode.