Magento / Adobe Commerce
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.
Scarica ZIP — Magento / Adobe Commerce
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
- Copia app/code/Vinalfa/Catalog/. Attiva Vinalfa_Catalog, esegui setup:upgrade e svuota la cache con la procedura abituale.
- Stores → Configuration → Vinalfa: inserisci i parametri. Pagina: /vinalfa/catalog/index. Verifica tema e CSP; non disattivare globalmente le protezioni.
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.
bin/magento module:enable Vinalfa_Catalog
bin/magento setup:upgrade
bin/magento cache:cleanDopo 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.