Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Шорткоды (переменные) — вставляйте сложные блоки одним кодом
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
Шорткоды (переменные) — модуль для 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
- Мультисайтовость, мультиязычность — поддерживается.
Скачайте модуль и распакуйте архив.
Скопируйте папку versha.shortcodes в один из каталогов модулей:
- /local/modules/ — рекомендуемый вариант, не потеряется при обновлении Битрикса.
- /bitrix/modules/ — не рекомендуется, папка может быть перезаписана при обновлении ядра.
- /local/modules/ — рекомендуемый вариант, не потеряется при обновлении Битрикса.
Должно получиться: /local/modules/versha.shortcodes/
Откройте админку: Настройки → Настройки продукта → Модули.
Найдите в списке модуль «Шорткоды (переменные)» и нажмите «Установить».
При установке модуль:
- создаёт таблицу b_versha_shortcodes в базе данных;
- регистрирует обработчики событий ядра (для подстановки на страницах и в письмах);
- создаёт раздел VERSHA в главном меню админки;
- создаёт файлы-обёртки versha_shortcodes_list.php и versha_shortcodes_edit.php в /bitrix/admin/;
- устанавливает настройки по умолчанию.
Готово. В главном меню админки появится раздел VERSHA с пунктом «Шорткоды» и подпунктами «Список шорткодов» и «Настройки».
Настройки модуляОткрыть: VERSHA → Шорткоды → Настройки.
- Подставлять шорткоды на страницах сайта — включает подстановку {code} и #CODE# в итоговом HTML страницы (контент, заголовок, мета-теги).
- Подставлять шорткоды в почтовых шаблонах и событиях — включает подстановку в полях почтового события и в собранном письме.
- Выполнять переменные типа «PHP-код» (eval) — по умолчанию выключено. Включайте только если доверяете всем администраторам сайта.
Создание переменной
Откройте VERSHA → Шорткоды → Список шорткодов и нажмите «Добавить переменную».
Заполните поля:
- Активность — снимите галочку, чтобы временно отключить переменную.
- Название — понятное имя, например «Телефон в шапке».
- Код переменной — латиница, цифры, точка, дефис и подчёркивание, до 64 символов. Например: phone, requisites, metrika.
- Тип — текст, HTML-код, изображение, скрипт, PHP-код или дата/время.
- Активность — снимите галочку, чтобы временно отключить переменную.
В зависимости от типа заполните содержимое:
- Текст — HTML как есть. Подходит для ссылок, блоков, разметки.
- HTML-код — редактируется в визуальном редакторе (текст / HTML / WYSIWYG).
- Изображение — загрузите файл, при желании задайте Alt, Title, ширину, высоту и дополнительные атрибуты (data-id="42" loading="eager" и т.п.).
- Скрипт — вставьте код как есть: JS, тег <script>, пиксель аналитики, iframe карты, JSON-LD, HTML-сниппет. Ничего не оборачивается — что ввели, то и вывелось.
- Дата/Время — значение выводится в формате d.m.Y H:i или в своём формате, если указать {code format=d.m.Y}.
При необходимости настройте привязки:
- Внедрить в (для «Скрипт», «HTML-код», «PHP-код») — «На месте шорткода», «В начало <head>», «В конец <head>», «В начало <body>», «В конец <body>». Если выбрано место в шаблоне, шорткод можно не вставлять в контент — код подключится автоматически.
- Сайт — «Все сайты» или конкретный сайт.
- Показывать — «Всем пользователям», «Группам пользователей» или «Конкретным пользователям».
Сохраните переменную кнопкой «Сохранить» или «Применить».
Вставка переменной на сайтеСкопируйте код прямо со страницы редактирования или из списка — по клику на {code} или #CODE# код попадает в буфер обмена. Затем вставьте его в нужное место:
- в контент страницы или элемента инфоблока — через визуальный редактор или HTML-режим;
- в заголовок страницы или мета-теги — в свойствах страницы;
- в шаблон компонента или сайта — в PHP-файле, как обычный текст: <?= versha_shortcodes('{code}') ?> или просто {code} в HTML-шаблоне;
- в почтовый шаблон — синтаксис #CODE#;
- в поле почтового события — синтаксис #CODE#.
Для разработчиков есть PHP-хелпер:
<?= versha_shortcodes($arResult['DETAIL_TEXT']) ?>Обновление модуля
- Скачайте новую версию модуля.
- Замените папку /local/modules/versha.shortcodes/ целиком.
- Откройте любую страницу сайта или админки — модуль сам проверит версию схемы БД и добавит недостающие колонки. Повторная установка не требуется.
Удаление модуля
- Откройте Настройки → Настройки продукта → Модули.
- Напротив модуля «Шорткоды (переменные)» нажмите «Удалить».
- Все настройки, обработчики событий, файлы-обёртки в /bitrix/admin/ и таблица b_versha_shortcodes будут удалены.
Требования
- 1С-Битрикс: Управление сайтом (любая редакция, кроме «Первый сайт» — там нет возможности устанавливать сторонние модули через админку).
- Ядро D7.
- PHP 8.2 или выше.
- Права на запись в /bitrix/admin/ (для создания файлов-обёрток при установке).
Техническая поддержка (разработчик Верша)
График работы: Пн–Пт 10:00–19:00 (МСК).
Время реакции: до 2 рабочих дней.
Контакты:
Telegram (быстрее всего): @versha_bot
Сайт: https://versha.site
Email: arag_on@mail.ru
Решение вопросов: установка, настройка модуля, диагностика ошибок.
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
