React / Vue
Guida all’installazione · 1.0.0-rc1
Questa è una release candidate. Prima della produzione, verifica il pacchetto su un sito di prova con la tua versione del CMS, il tema e il token pubblico del progetto. Non si dichiara alcuna certificazione marketplace.
Prima dell’installazione
Crea un progetto Vinalfa, attiva Trial o un abbonamento e autorizza il dominio del sito per il token pubblico del widget. Non inserire qui un token Bearer del server.
Installazione e posizionamento
- React: copia VinalfaCatalog.jsx e widget-core.mjs. Vue 3: copia VinalfaCatalog.vue e widget-core.mjs.
- Passa configId, publicToken, searchUrl e language. In Next.js App Router aggiungi 'use client'. L’applicazione fornisce le dipendenze; nessun pacchetto npm è pubblicato.
Inserisci CONFIG_ID, public widget token, lingua e URL HTTPS della ricerca del negozio con {article}. Imposta lo stesso URL nel progetto Vinalfa: il progetto può sovrascrivere i parametri dell’adattatore. Verifica la ricerca OEM/SKU.
<VinalfaCatalog configId="YOUR_CONFIG_ID" publicToken="YOUR_PUBLIC_WIDGET_TOKEN" searchUrl="https://YOUR-STORE.example/search/?q={article}" language="it" />Dopo l’installazione
Verifica VIN/FRAME → veicolo → schema → numero OEM → ricerca del negozio, ricaricamento, errori di accesso e limiti. Prova il percorso su telefoni da 320 px e controlla cache, CSP e ottimizzatori JavaScript.
Gli adattatori nativi usano percorsi hash senza regole server aggiuntive. I componenti per temi, builder e React/Vue usano un iframe: la posizione interna non viene conservata nell’URL della pagina principale.
Ambito dell’integrazione
Cataloghi, VIN/FRAME, schemi e collegamento alla ricerca del negozio. Prezzi, disponibilità, carrello e ordini restano nel negozio; importazione prodotti e sincronizzazione prezzi non sono incluse.
Rimozione
Rimuovi prima il catalogo dalle pagine e i collegamenti di menu. Poi disattiva/disinstalla tramite CMS o elimina solo i file aggiunti dopo un backup. La disinstallazione del modulo Bitrix conserva componente e pagine; la rimozione completa è separata.
Verifiche della versione
Il plugin è stato provato con WordPress 6.8.3 e SQLite: attivazione, impostazioni, shortcode e disinstallazione. Per gli altri CMS sono stati verificati codice e scenari isolati senza installazione completa. React/Vue e l’installer sono stati provati con API simulata senza consumo di VIN.