React / Vue
Guía de instalación · 1.0.0-rc1
Esta es una release candidate. Antes de producción, valide el paquete en un sitio de pruebas con su versión de CMS, tema y token público del proyecto. No se declara certificación de marketplaces.
Antes de instalar
Cree un proyecto Vinalfa, active Trial o una suscripción y autorice el dominio del sitio para el token público del widget. No use aquí un token Bearer de servidor.
Instalación y ubicación
- React: copie VinalfaCatalog.jsx y widget-core.mjs. Vue 3: copie VinalfaCatalog.vue y widget-core.mjs.
- Pase configId, publicToken, searchUrl y language. En Next.js App Router añada 'use client'. La aplicación aporta las dependencias; no hay publicación npm.
Introduzca CONFIG_ID, public widget token, idioma y la URL HTTPS de búsqueda de su tienda con {article}. Configure la misma URL en Vinalfa: el proyecto puede sobrescribir ajustes del adaptador. Verifique la búsqueda OEM/SKU.
<VinalfaCatalog configId="YOUR_CONFIG_ID" publicToken="YOUR_PUBLIC_WIDGET_TOKEN" searchUrl="https://YOUR-STORE.example/search/?q={article}" language="es" />Después de instalar
Pruebe VIN/FRAME → vehículo → diagrama → número OEM → búsqueda de su tienda, recarga, errores de acceso y límites. Recorra el flujo en móviles desde 320 px y revise caché, CSP y optimizadores JavaScript.
Los adaptadores nativos usan rutas hash sin reglas adicionales del servidor. Los componentes de temas, constructores y React/Vue usan iframe: la posición interna no se conserva en la URL de la página principal.
Alcance de la integración
Catálogos, VIN/FRAME, diagramas y enlace a la búsqueda de su tienda. Precios, existencias, carrito y pedidos permanecen en la tienda; no se incluye importación de productos ni sincronización de precios.
Eliminación
Retire primero el catálogo de las páginas y los enlaces del menú. Desactive/desinstale mediante el CMS o elimine solo los archivos añadidos tras una copia de seguridad. Desinstalar el módulo Bitrix conserva el componente y las páginas; su eliminación es independiente.
Verificación de la versión
El plugin se probó en WordPress 6.8.3 con SQLite: activación, ajustes, shortcode y desinstalación. Para otros CMS se verificaron código y escenarios aislados, sin instalación completa. React/Vue y el instalador se probaron con una API simulada, sin consumir VIN.