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

Magento Open Source / Adobe Commerce
Magento Open Source / Adobe Commerce 2.4.x; PHP version required by your release. Standard storefront layout.

1. Copy app/code/Vinalfa/Catalog/ into your Magento application. Back up first; deploy to staging before production.
2. As the Magento filesystem owner run: bin/magento module:enable Vinalfa_Catalog; bin/magento setup:upgrade; bin/magento cache:clean. Use your normal DI compilation/static deployment process in production mode.
3. Stores → Configuration → Vinalfa → OEM Catalog: enter the four public widget settings at the correct store scope. An administrator needs Vinalfa_Catalog::config permission.
4. Open https://YOUR-STORE.example/vinalfa/catalog/index (include the store code if applicable) and add this link to your navigation.
5. Search example: https://YOUR-STORE.example/catalogsearch/result/?q={article}. Verify search by OEM/SKU and set the same URL in Vinalfa.
6. The page uses 1column layout. Hyvä/headless themes may require their own template placement. Strict Magento CSP can block the external loader and its dynamic assets: review actual browser CSP reports and narrowly allow the required Vinalfa origins via your deployment’s CSP configuration; do not disable CSP globally.
Removal: remove navigation links, disable the module through the normal Magento deployment procedure and clean caches. No custom tables are created; configuration values can be removed using the normal admin/config process.

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