MODX Revolution
Инструкция · 1.0.0-rc1
Это release candidate. До боевого запуска проверьте выбранный пакет на тестовом сайте с вашей версией CMS, темой и публичным токеном проекта. Сертификация маркетплейсов не заявляется.
Перед установкой
Создайте проект Vinalfa, активируйте Trial или подписку и разрешите домен сайта для публичного токена виджета. Серверный Bearer-токен сюда не вставляется.
Установка и размещение
- Скопируйте assets/components/vinalfa/Catalog.php. Создайте сниппет VinalfaCatalog из elements/snippet.vinalfa.php без открывающего тега PHP.
- Вызовите [[!VinalfaCatalog]] на отдельном ресурсе, передав параметры config_id, public_token, search_url и language. Это исходник сниппета, не .transport.zip.
Укажите CONFIG_ID, public widget token, язык и HTTPS-ссылку поиска вашего магазина с {article}. Ту же ссылку задайте в проекте Vinalfa: настройки проекта могут переопределить параметры адаптера. Проверьте, что магазин ищет по OEM/SKU.
[[!VinalfaCatalog? &config_id=`YOUR_CONFIG_ID` &public_token=`YOUR_PUBLIC_WIDGET_TOKEN` &search_url=`https://YOUR-STORE.example/search/?q={article}` &language=`ru`]]После установки
Проверьте 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.