1С-Битрикс · vinalfa.catalog / 1С-Битрикс · vinalfa:catalog
Инструкция · 1.0.0-rc1
Это release candidate. До боевого запуска проверьте выбранный пакет на тестовом сайте с вашей версией CMS, темой и публичным токеном проекта. Сертификация маркетплейсов не заявляется.
Скачать ZIP — 1С-Битрикс · vinalfa.catalog · Скачать ZIP — 1С-Битрикс · vinalfa:catalog
Перед установкой
Создайте проект Vinalfa, активируйте Trial или подписку и разрешите домен сайта для публичного токена виджета. Серверный Bearer-токен сюда не вставляется.
Установка и размещение
- Модуль: распакуйте local/modules/vinalfa.catalog/ в корень сайта и установите через список модулей Битрикса.
- Альтернатива: скопируйте local/components/vinalfa/catalog/ без установки модуля. Разместите vinalfa:catalog на отдельной странице; параметры задаются в компоненте. Выберите один способ установки.
Укажите CONFIG_ID, public widget token, язык и HTTPS-ссылку поиска вашего магазина с {article}. Ту же ссылку задайте в проекте Vinalfa: настройки проекта могут переопределить параметры адаптера. Проверьте, что магазин ищет по OEM/SKU.
<?php
$APPLICATION->IncludeComponent('vinalfa:catalog', '', [
'config_id' => 'YOUR_CONFIG_ID',
'public_token' => 'YOUR_PUBLIC_WIDGET_TOKEN',
'search_url' => 'https://YOUR-STORE.example/search/?q={article}',
'language' => 'ru',
'CACHE_TYPE' => 'N'
]);После установки
Проверьте VIN/FRAME → автомобиль → схема → OEM-номер → поиск вашего магазина, обновление страницы, ошибки доступа и лимиты. Пройдите весь путь на телефоне при ширине от 320 px. Проверьте кеш, CSP и оптимизаторы JavaScript.
Нативные адаптеры используют hash-навигацию без дополнительных серверных правил. Компоненты для тем, конструкторов и React/Vue работают в iframe: внутренняя позиция каталога не сохраняется в адресе родительской страницы.
Что входит в подключение
Каталог, VIN/FRAME, схемы и переход к поиску магазина. Цены, остатки, корзина и заказы остаются в магазине; импорт товаров и синхронизация цен не включены.
Удаление
Сначала уберите каталог со страниц и из меню. Затем отключите и удалите пакет штатными средствами CMS либо удалите только добавленные файлы после резервного копирования. Удаление модуля Битрикса сохраняет компонент и страницы; полное удаление выполняется отдельно.
Проверки сборки
Плагин проверен на WordPress 6.8.3 с SQLite: активация, настройки, шорткод и деинсталляция. Для остальных CMS проверены код и отдельные сценарии адаптеров, без полной установки CMS. Компоненты React/Vue и установщик проверены с имитацией API, без расходования VIN.