InSales
Guide d’installation · 1.0.0-rc1
Il s’agit d’une release candidate. Avant la mise en production, validez le package sur un site de test avec votre version du CMS, votre thème et le jeton public du projet. Aucune certification de marketplace n’est annoncée.
Avant l’installation
Créez un projet Vinalfa, activez le Trial ou un abonnement et autorisez le domaine du site pour le jeton public du widget. N’utilisez jamais ici le jeton Bearer du serveur.
Installation et placement
- Ajoutez snippets/vinalfa-catalog.liquid à une copie du thème et remplacez les valeurs fictives du projet.
- Incluez-le seulement sur la page catalogue via le Liquid include du thème. Vérifiez la page publiée et les limites du forfait. Composant de thème, pas application.
Renseignez CONFIG_ID, public widget token, la langue et l’URL HTTPS de recherche de votre boutique contenant {article}. Configurez la même URL dans Vinalfa : le projet peut remplacer les paramètres de l’adaptateur. Vérifiez la recherche OEM/SKU de la boutique.
Après l’installation
Testez VIN/FRAME → véhicule → schéma → numéro OEM → recherche de la boutique, le rechargement, les erreurs d’accès et les limites. Vérifiez tout le parcours sur mobile dès 320 px, ainsi que le cache, la CSP et les optimisations JavaScript.
Les adaptateurs natifs utilisent des routes avec hash sans règle serveur supplémentaire. Les composants de thème, de constructeur et React/Vue utilisent un iframe : la position interne n’est pas conservée dans l’URL de la page parente.
Périmètre de l’intégration
Catalogues, VIN/FRAME, schémas et lien vers la recherche de la boutique. Les prix, stocks, paniers et commandes restent dans la boutique. L’import des produits et la synchronisation des prix ne sont pas inclus.
Suppression
Retirez d’abord les blocs du catalogue et les liens du menu. Désactivez/désinstallez ensuite via le CMS ou supprimez uniquement les fichiers ajoutés après sauvegarde. La désinstallation du module Bitrix conserve le composant et les pages ; leur suppression est séparée.
Vérifications de la version
Le plugin a été testé sous WordPress 6.8.3 avec SQLite : activation, paramètres, shortcode et désinstallation. Pour les autres CMS, le code et des scénarios isolés ont été vérifiés sans installation complète. React/Vue et l’installateur ont été testés avec une API simulée, sans consommer de VIN.