Документация

Начало

После установки модуля выполните три шага. На странице появится кнопка, а таблица откроется по нажатию в центре экрана.

1. Создайте таблицу

Нажмите «Добавить запись». Для первого примера заполните:

• Название — Таблица размеров.
• Символьный код — size_guide. Раскройте «Дополнительные настройки» и укажите код свойства SIZE.
• Сайт — ваш сайт. Активность включена; инфоблок, раздел и значение оставьте «Любой», свойство из списка не выбирайте.

На вкладке «Данные» заполните колонки и строки, затем сохраните запись.

Для привязки к каталогу выберите инфоблок, свойство и нужное значение по названию. Значения подгружаются автоматически; искать ID не нужно. «Любое значение» подходит для общей таблицы свойства.

Кнопка на сайте

Откройте сохранённую запись → вкладку «Вставка». Там два готовых фрагмента:

1. Скрипт — подключите один раз в общем шаблоне страницы, вне кешируемого компонента.
2. HTML-кнопка — вставьте там, где нужна таблица. Надпись и CSS-класс кнопки можно менять.

По нажатию таблица загружается отдельно: кеш страницы или компонента не хранит её содержимое. Одним скриптом можно обслуживать несколько кнопок. При вставке через визуальный редактор используйте режим HTML.

$APPLICATION->IncludeComponent('qwelp:propertydata.trigger', '', [
    'PROPERTY_CODE' => 'SIZE',
    'DATA_CODE' => 'size_guide',
    'BUTTON_TEXT' => 'Таблица размеров',
]);

Таблица на странице

Используйте этот код вместо вызова кнопки:

$APPLICATION->IncludeComponent('qwelp:propertydata.view', '', [
    'PROPERTY_CODE' => 'SIZE',
    'DATA_CODE' => 'size_guide',
]);

Оформление

Текст и строки меняются в записи на вкладке «Данные». Цвета, размер шрифта и скругление окна — в CSS вашего сайта:

1. Откройте файл стилей активного шаблона сайта, обычно /local/templates/ИМЯ_ШАБЛОНА/template_styles.css.
2. Добавьте пример ниже в конец файла. Замените цвета и числа на свои.
3. Очистите кеш страницы/компонента и Композит, если включён. Перезагрузите страницу и откройте таблицу.

body .sl-propertydata-trigger {
    color: #6750a4;
}
.sl-propertydata-modal .sl-propertydata-modal__panel {
    width: min(760px, 100%);
    border-radius: 16px;
    background: #ffffff;
    color: #222222;
}
.sl-propertydata-modal .sl-propertydata-modal__table {
    font-size: 15px;
}
.sl-propertydata-modal .sl-propertydata-modal__table th {
    background: #f0ebfa;
}

Пример меняет стандартное оформление всех всплывающих таблиц на этом сайте. Он подходит и для HTML-кнопки, и для PHP-компонента. Надпись и CSS-класс HTML-кнопки можно менять прямо во вставленном коде; в PHP-компоненте — через параметры кнопки.

Для своего дизайна скопируйте готовый шаблон. В копии будут разметка, стили и скрипт; обновления модуля её не перезапишут.

data-popup-template="/local/templates/ИМЯ_ШАБЛОНА/qwelp/propertydata/brand/"

Проверка

Откройте страницу и нажмите кнопку. Таблица должна открыться по центру; крестик и Escape закрывают окно. Дальше меняйте содержимое во вкладке «Данные» — код на сайте менять не нужно.

Проверка после подключения

1. Откройте страницу как посетитель: таблица соответствует записи, кнопка открывает окно, крестик и Escape закрывают его.
2. Проверьте экран 320×568, 375×667, 390×844 и горизонтальный режим: закрытие доступно, широкая таблица прокручивается внутри окна.
3. В режиме правки сохраните параметры без изменений, затем измените один допустимый параметр и сохраните снова. После каждого сохранения проверьте страницу в обычном режиме.
4. Измените одну ячейку записи и проверьте обновление страницы. Модуль очищает свой тег кеша и планирует очистку публичного кеша; пользовательское кеширование интегратора требует отдельной проверки. После изменения шаблона очистите кеш компонента, родительского компонента и Композит.
5. Если сайтов несколько, создайте отличающиеся таблицы с явными привязками к сайтам и проверьте каждый домен. Записи «Все сайты» общие намеренно.

Если таблица не появилась, проверьте установку модуля, активность записи, сайт, ID инфоблока, код/ID свойства, код записи, значение и цепочку разделов. Временно выберите HIDE_IF_EMPTY=N, чтобы отличить отсутствие данных от отсутствия компонента. Если дизайн не изменился — проверьте, какой шаблон и какая вложенная копия действительно выбраны Bitrix.

Для разработчика

Установка модуля

1. Подготовьте сайт на «1С-Битрикс: Управление сайтом» в UTF-8 с PHP 8.2 или выше и MySQL 8.0 или выше. Проверка установщика допускает main от 23.0.0; для новой установки используйте актуальную стабильную платформу. Для выбора реальных свойств и разделов нужен модуль «Информационные блоки».
2. Загрузите решение штатными средствами Marketplace и установите его в административном разделе. Для ручного теста распакуйте предоставленный разработчиком пакет так, чтобы файл install/index.php находился внутри /bitrix/modules/qwelp.propertydata/, затем откройте «Настройки → Настройки продукта → Модули» и нажмите «Установить». ZIP с папкой .last_version — формат передачи в Marketplace: в каталог модуля переносится содержимое этой папки.
3. Откройте «Квэлп → Квэлп: Данные свойств». Модуль сам создаёт раздел «Квэлп» и работает без других модулей Qwelp. Здесь доступны «Все записи», «Добавить запись» и «Документация».
4. При необходимости настройте права доступа: D — доступ закрыт, R — просмотр списка и документации, W — создание, изменение и удаление. Эти права общие для модуля; они не разделяют редакторов по сайтам.

Установщик создаёт собственную таблицу БД, административные страницы, два компонента в /bitrix/components/qwelp/ и расширения в /bitrix/js/qwelp/propertydata/. Шаблон сайта, товары и init.php менять для установки не требуется. Автоматического добавления таблиц во все карточки товаров нет: место вывода выбирает интегратор. Платные внешние сервисы, Bootstrap, jQuery и другие модули Qwelp для обычного вывода не нужны. Первая вставка PHP в шаблон требует навыков разработки Bitrix.

Параметры компонентов

Сайт компонент берёт из текущего SITE_ID; отдельного сохраняемого параметра сайта нет. Для параметров, которыми управляет визуальный редактор, используйте строки, числа и массивы примитивных значений. Динамическую передачу раздела и значения из родительского каталога должен настроить интегратор с проверкой сохранения в редакторе.

Как выбирается запись

Выбирается одна активная запись, подходящая контексту. Общие записи могут служить запасным вариантом. Более конкретные совпадения получают суммарный приоритет: сайт +40, инфоблок +30, ID свойства +30, код свойства +20, XML_ID значения +50, ID значения +35, точный раздел без наследования +90, раздел с наследованием +60 и глубина раздела в переданной цепочке. При одинаковой сумме выигрывает меньшая «Сортировка», затем меньший ID записи. Применение к подразделам работает только при передаче цепочки разделов.

Ограничения текущей версии: таблица — до 40 колонок и 200 строк; заголовок колонки — до 255 символов, ячейка — до 1000. Превышения обрезаются при сохранении. Список администрирования загружает максимум 500 записей; поиск вывода рассматривает до 100 кандидатов на контекст, предварительно упорядоченных по сортировке и ID. Не создавайте сотни пересекающихся правил для одного свойства. Поддерживается текстовая таблица, без исполнения HTML в ячейках. Публично размещённые таблицы доступны посетителям; не храните в них закрытые сведения.

Изменение HTML-разметки PHP-компонента

Для PHP-вызова скопируйте целиком /bitrix/components/qwelp/propertydata.trigger/templates/.default/ в /local/templates/ИМЯ_ШАБЛОНА/components/qwelp/propertydata.trigger/.default/. Если компонент установлен в /local/components/, копируйте его фактически используемый шаблон оттуда. Для таблицы внутри страницы аналогично используйте propertydata.view. Именованную копию, например brand, укажите вторым аргументом вызова компонента. На HTML-кнопку с отдельным скриптом эта копия не влияет.

В trigger копируются template.php, папка parts/, style.css, script.js, .parameters.php и lang/. Bitrix сам подключает CSS и JS выбранного шаблона. Сохраняйте data-атрибуты, связь кнопки и окна, клавиатурное закрытие, ограничения visualViewport, safe-area и внутреннюю прокрутку. Пользовательские копии не обновляются автоматически; перенос исправлений в них выполняет интегратор. Подробности есть в README модуля.

Удаление и повторная установка

Удаление доступно администратору в списке модулей. По умолчанию таблицы с данными сохраняются и могут использоваться после повторной установки. Флажок «Удалить таблицы и данные модуля» удаляет их для всей установки, включая записи всех сайтов. Перед этим сделайте резервную копию и подтвердите необходимость удаления.

Модуль управляет только файлами, принадлежащими ему по установочному манифесту; изменённые или чужие файлы могут остановить безопасное удаление. Копии оформления в /local/templates/ и добавленные интегратором вызовы на страницах остаются: их нужно убрать вручную перед удалением компонентов. Для обращения в поддержку используйте контакты и регламент в карточке приобретённого решения, приложите версии PHP/Bitrix, текст ошибки и параметры компонента без паролей и лицензионных ключей.