1С-Битрикс · vinalfa.catalog / 1С-Битрикс · vinalfa:catalog
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 — 1С-Битрикс · vinalfa.catalog · Scarica ZIP — 1С-Битрикс · vinalfa:catalog
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
- Modulo: estrai local/modules/vinalfa.catalog/ nella radice del sito e installa dall’elenco moduli Bitrix.
- In alternativa copia local/components/vinalfa/catalog/ senza modulo. Inserisci vinalfa:catalog su una pagina dedicata e configura i parametri. Scegli un solo metodo.
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.
<?php
$APPLICATION->IncludeComponent('vinalfa:catalog', '', [
'config_id' => 'YOUR_CONFIG_ID',
'public_token' => 'YOUR_PUBLIC_WIDGET_TOKEN',
'search_url' => 'https://YOUR-STORE.example/search/?q={article}',
'language' => 'it',
'CACHE_TYPE' => 'N'
]);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.