VINALFA CMS INTEGRATIONS — 1.0.0-rc1 — 23.10.2026

RU: Первый комплект адаптеров виджета. Установочные архивы и исходники готовы; это release candidate, не сертификация маркетплейсов. Полные лицензированные/облачные CMS-стенды не входят в локальные проверки. До установки в production пройдите приёмку на staging вашей версии CMS и темы с отдельным public widget token. Не используйте серверный Bearer-токен в этих формах или компонентах.
EN: Installable/source widget adapters, release candidate. No marketplace certification is claimed. Validate on a staging site with your CMS version, theme, own project, allowed origin and a public widget token before production. These adapters do not provide product import, stock/price sync, cart integration or server-side catalog UI.

All adapters support widget language ru/en/de/zh/tr/es/ja/it/fr/ko. The site’s project configuration may override language/search: set the same values in the Vinalfa account. Prices, stock, cart and order handling stay in the store. Search by OEM/SKU must already work in the store or be implemented separately.
CONFIG_ID and public widget token: copy from your project account. The server Bearer token belongs only in private backend environment variables. No live account credentials are bundled.
Routing: native CMS adapters use the widget’s hash router (data-router="hash"). No catch-all rewrite is needed. The builder/React/Vue/Shopify components isolate it in an iframe; inner route is not reflected in the parent URL.

Demo https://vinalfa.com/widget
API https://vinalfa.com/ru/api
Setup https://vinalfa.com/ru/getting-started
Partners https://vinalfa.com/ru/partners

Localized guides: https://vinalfa.com/cms-modules

1С-Битрикс / Bitrix
Коробочный «1С-Битрикс: Управление сайтом», PHP 7.4+. Не облачные Сайты24/Bitrix24.

Вариант А — устанавливаемый модуль (рекомендуется):
1. Сделайте резервную копию. Распакуйте vinalfa-bitrix-module.zip в корень тестового сайта: появится /local/modules/vinalfa.catalog/.
2. Настройки → Настройки продукта → Модули / Marketplace → Установленные решения: установите Vinalfa OEM Catalog. Модуль установит компонент vinalfa:catalog. Если компонент уже существует, установка остановится: сохраните его и выберите один способ установки.
3. Создайте отдельную страницу и вызовите $APPLICATION->IncludeComponent('vinalfa:catalog', '', ['config_id'=>'...', 'public_token'=>'...', 'search_url'=>'https://YOUR-STORE.example/search/?q={article}', 'language'=>'ru', 'CACHE_TYPE'=>'N']);
4. Полный пример страницы находится в example-page.php архива компонента и в папке исходников bitrix/. Меняйте только публичный токен проекта, не серверный Bearer.
5. Либо вставьте компонент через визуальный редактор: раздел Vinalfa → Vinalfa OEM Catalog. Заполните четыре параметра компонента.

Вариант Б — компонент без модуля:
Распакуйте vinalfa-bitrix-component.zip в корень сайта. Каталог должен лежать в /local/components/vinalfa/catalog/. Регистрация модуля для этого варианта не нужна. Не устанавливайте оба варианта одновременно.

Проверьте ширину шаблона (полная область контента), композитный кеш и отложенные скрипты; после изменения настроек сбросьте кеш страницы. Хеш-навигация не требует urlrewrite.php. Переход к цене — через поиск вашего магазина; адаптация поиска по OEM/SKU выполняется в магазине отдельно.
Удаление модуля снимает его регистрацию, но сохраняет компонент и страницы, чтобы не уничтожить доработки. Для полного удаления сначала уберите вызовы со страниц, затем вручную удалите /local/components/vinalfa/catalog/ и /local/modules/vinalfa.catalog/ после резервного копирования.
Полная установка на лицензированном экземпляре Битрикса в этой сборке не выполнялась; обязательна проверка на вашем staging.

Acceptance: see ACCEPTANCE.txt in the complete kit. No real credential is included.
