Работа со сниппетами визуального редактора

Сниппеты — это готовые фрагменты HTML, которые вставляются в страницу одним кликом из панели визуального редактора. Они экономят время при верстке типовых блоков: цитат, кнопок, карточек, таблиц.

Что такое сниппеты и зачем они нужны

Сниппет — это заранее подготовленный кусок HTML-кода с оформлением, который хранится в системе и доступен для повторной вставки. В отличие от компонентов, сниппет не связан с логикой на PHP: это статичная разметка, которую вы правите прямо на странице после вставки.

Типичные сценарии использования:

• вставка одинаково оформленных блоков (акции, врезки, предупреждения) на десятки страниц;
• быстрая верстка таблиц и карточек без ручного набора тегов;
• единый стиль контента, когда над сайтом работают несколько контент-менеджеров.

Сниппеты работают только в визуальном режиме редактора. В режиме исходного кода панель сниппетов недоступна.

Где хранятся файлы сниппетов

Стандартные сниппеты 1С-Битрикс лежат в каталоге модуля визуального редактора:

/bitrix/modules/fileman/snippets/

Пользовательские сниппеты рекомендуется размещать не в каталоге модуля (он перезаписывается при обновлениях), а в папке сайта:

/bitrix/snippets/

Каждый сниппет — это отдельный HTML-файл. Подпапки внутри каталога отображаются в панели как группы (категории). Структура файлов выглядит так:

Путь	Назначение
/bitrix/snippets/blocks/	Группа «blocks» в панели сниппетов
/bitrix/snippets/blocks/quote.html	Сниппет «quote» внутри группы
/bitrix/snippets/.description.php	Названия и описания групп/сниппетов на русском

Как вставить сниппет на страницу

Порядок действий при редактировании страницы в визуальном редакторе:

1. Откройте страницу на редактирование: в публичной части нажмите «Изменить страницу» либо через Контент → Структура сайта → Файлы и папки выберите файл и действие «Править как HTML».
2. Установите курсор в то место контента, куда нужно вставить блок.
3. На верхней панели редактора нажмите кнопку «Сниппеты» — справа откроется панель со списком групп.
4. Раскройте нужную группу и дважды кликните по сниппету (или перетащите его мышью в область контента).
5. Отредактируйте вставленный блок прямо на странице: замените текст, ссылки, изображения.
6. Сохраните страницу.

Вставленный сниппет становится обычным HTML в теле страницы — дальнейшая правка стандартными инструментами (Ctrl+B, стили, ссылки).

Создание собственного сниппета

Есть два способа: через интерфейс редактора и вручную через файлы.

Через визуальный редактор

1. Выделите на странице готовый оформленный блок.
2. В панели «Сниппеты» нажмите кнопку добавления (иконка «плюс» или «Создать сниппет»).
3. Укажите название, группу и, при необходимости, картинку-иконку.
4. Сохраните — сниппет появится в списке и станет доступен на любой странице.

Вручную через файлы

1. Создайте папку группы в /bitrix/snippets/, например /bitrix/snippets/my/.
2. Положите туда HTML-файл с разметкой блока, например callout.html.
3. В файле .description.php задайте читаемые названия групп и сниппетов.

После обновления страницы редактора новый сниппет появится в панели без перезапуска системы.

Управление группами и порядком

Группы сниппетов формируются структурой подпапок. Чтобы навести порядок:

• объединяйте однотипные сниппеты в тематические папки (кнопки, таблицы, врезки);
• используйте .description.php для русскоязычных названий — без него в панели видны технические имена файлов;
• удаляйте неиспользуемые стандартные сниппеты не из каталога модуля, а скрывайте их через настройки редактора, чтобы правки пережили обновление.

Права на добавление и редактирование сниппетов через интерфейс есть у пользователей с доступом к модулю управления структурой (обычно администраторы и контент-менеджеры с соответствующей ролью).

Частые ошибки

• Сниппеты пропали после обновления. Причина — они лежали в /bitrix/modules/fileman/snippets/, который перезаписывается. Храните пользовательские сниппеты в /bitrix/snippets/.
• Кнопки «Сниппеты» нет на панели. Редактор открыт в режиме исходного кода либо кнопка отключена в настройках визуального редактора. Переключитесь в визуальный режим.
• В панели видны технические имена файлов. Не заполнен .description.php — добавьте названия групп и сниппетов на русском.
• Вставленный блок «поехал». Сниппет ссылается на CSS-классы шаблона, которых нет на текущем сайте. Пропишите инлайн-стили или подключите нужные классы в шаблоне.
• Изменение сниппета не отражается на старых страницах. Это нормально: сниппет копируется в контент при вставке и живет независимо. Правка исходного файла на уже вставленные блоки не влияет.

Итог

Сниппеты — простой способ ускорить верстку типового контента без программирования. Ключевые правила: храните пользовательские сниппеты в /bitrix/snippets/, задавайте русские названия через .description.php и помните, что вставленный блок становится независимой копией. Для сложной логики со сквозными данными используйте компоненты, а не сниппеты.