Шорткоды (переменные) — вставляйте сложные блоки одним кодом
Шорткоды (переменные) — модуль для 1С-Битрикс, который позволяет один раз создать любой блок (текст, HTML, изображение, скрипт, дату) и вставлять его в любое место сайта одним коротким кодом: {code} или #CODE#.
Больше не нужно редактировать десятки страниц, чтобы поменять телефон, адрес, реквизиты, счётчик аналитики или баннер. Изменили значение переменной один раз — оно автоматически обновилось везде: в контенте страниц, мета-тегах, шаблонах компонентов, письмах и даже в шапке и подвале сайта.
Возможности- Семь типов переменных — текст, HTML-код (с визуальным редактором), изображение, скрипт, дата/время.
- Два синтаксиса вставки — {code} для страниц и шаблонов, #CODE# для почтовых шаблонов и полей.
- Подстановка на страницах сайта — в контенте, заголовке страницы, мета-тегах Title / Description / Keywords и названиях элементов.
- Подстановка в письмах — в полях почтового события и в собранном теле письма (тема + содержимое) перед отправкой.
- Тип «Скрипт» — для кодов карт (Яндекс.Карты, Google Maps), аналитики (Яндекс.Метрика, Google Analytics, Google Tag Manager, VK Pixel), «ловцов лидов» (Roistat, Callibri, Envybox), чатов (Битрикс24, Jivo), видео (YouTube, VK), Schema.org в JSON и любых других скриптов.
- Тип «HTML-код» — редактируется в стандартном визуальном редакторе Битрикса: удобно верстать баннеры, блоки, сниппеты без знания HTML.
- Внедрение в шаблон — для типов «Скрипт», «HTML-код» и «PHP-код» можно указать место вставки: начало/конец <head> или <body>. Тогда шорткод вообще не нужно вставлять в контент — он подставится автоматически на всех страницах.
- Привязка к сайту — переменная может показываться на всех сайтах или на конкретном (мультисайтовость).
- Привязка к пользователям — показывать всем, конкретным группам или конкретным пользователям. Удобно для скрытых акций, внутренних блоков, тестовых скриптов.
- Изображения — с полями Alt, Title, шириной, высотой и дополнительными атрибутами (data-*, loading, referrerpolicy и т.п.).
- Кеширование — тегированный кеш Битрикса, сбрасывается автоматически при любом изменении переменной. Сайт работает быстро.
- Копирование кода в один клик — в списке и на странице редактирования код {code} и #CODE# копируется в буфер обмена по клику.
- Активность и сортировка — каждую переменную можно временно отключить, не удаляя.
- Отдельный раздел в админке — «VERSHA → Шорткоды» с раскрывающимся подменю «Список шорткодов» и «Настройки».
- Русский и английский интерфейс — языковые файлы в комплекте.
Кому подходит
- Контент-менеджерам — менять телефоны, адреса, реквизиты, баннеры без правки каждой страницы.
- Маркетологам — управлять счётчиками, пикселями и «ловцами лидов» из одного места.
- Разработчикам — быстро выносить часто повторяющиеся блоки и куски кода в переменные, не плодя компоненты.
- Агентствам — упростить поддержку и снизить количество правок в шаблонах у клиента.
Примеры использования
- Телефон и адрес в шапке и подвале. Одна переменная — правится в одном месте, обновляется на всём сайте.
- Код Яндекс.Метрики. Тип «Скрипт», место вставки — конец <head>. Счётчик подключится на всех страницах, даже если шаблон вы не меняли.
- Баннер акции. Тип «HTML-код», содержимое собирается в визуальном редакторе, вставляется на нужные страницы одним кодом.
- Реквизиты в письме. Тип «Текст» с кодом #REQUISITES# — подставляется во все почтовые шаблоны.
- Блок «только для оптовых клиентов». Тип «Текст», доступ — конкретной группе пользователей.
Безопасность
- Управление переменными доступно только администраторам сайта.
- Файлы модуля не изменяют системные файлы Битрикса, кроме создания двух обёрток в /bitrix/admin/ (стандартная практика для модулей с публичной частью).
Совместимость
- 1С-Битрикс: Управление сайтом — редакции «Старт», «Стандарт», «Малый бизнес», «Бизнес», «Энтерпрайз».
- Ядро D7 (обязательно).
- PHP 8.2
- Мультисайтовость, мультиязычность — поддерживается.