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

MODX Revolution
MODX Revolution 2.8 / 3.x, PHP 7.4+.

1. Copy assets/components/vinalfa/Catalog.php into your site assets/ directory.
2. Create a snippet named VinalfaCatalog. Paste elements/snippet.vinalfa.php WITHOUT its opening <?php line.
3. On a full-width Resource use the uncached call:
[[!VinalfaCatalog? &config_id=`YOUR_CONFIG_ID` &public_token=`YOUR_PUBLIC_WIDGET_TOKEN` &search_url=`https://YOUR-STORE.example/search/?q={article}` &language=`ru`]]
4. Configure the same search URL in Vinalfa, clear resource cache and check content filtering.
This is a ready PHP snippet/component, not a MODX .transport.zip package. Removal: delete the snippet call, snippet and assets/components/vinalfa/ after backing up.

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