DF Fitment Finder — Recherche par véhicule et compatibilité produit

DF Fitment Finder ajoute à votre boutique PrestaShop une recherche par compatibilité : le client sélectionne son véhicule (ou son appareil) et le catalogue ne lui montre plus que les produits qui lui vont. Cette documentation couvre l’installation, la configuration, l’alimentation du référentiel véhicules et l’affichage en front.

Installation

1. Rendez-vous dans Modules > Gestionnaire de modules, puis cliquez sur Installer un module.
2. Déposez le fichier dffitmentfinder.zip et lancez l’installation.
3. Cliquez sur Configurer pour accéder aux réglages.

L’installation crée trois tables (référentiel véhicules, correspondances produits, garages clients), enregistre les hooks nécessaires et ajoute l’onglet Véhicules sous le menu Catalogue. Aucun override du cœur n’est posé, aucune dépendance Composer n’est requise.

Configuration

Niveaux de recherche

Le sélecteur repose sur quatre niveaux : Marque, Modèle, Année et Motorisation. Les deux premiers sont toujours actifs ; les deux derniers s’activent ou se désactivent selon votre catalogue.

• Utiliser l’année : à désactiver pour un catalogue sans notion d’année (cartouches d’imprimante, coques de téléphone, pièces d’électroménager).
• Utiliser la motorisation : à désactiver si le niveau le plus fin de votre référentiel est le modèle.

La recherche reste possible dès que la marque et le modèle sont renseignés : le client n’est jamais obligé d’aller jusqu’au niveau le plus fin.

Libellés des niveaux

Chaque niveau porte un libellé modifiable par langue. Par défaut : Marque, Modèle, Année, Motorisation. Adaptez-les à votre secteur :

• Pièces auto : Marque / Modèle / Année / Motorisation
• Cartouches d’imprimante : Marque / Série / — / Référence
• Coques de téléphone : Marque / Modèle
• Électroménager : Fabricant / Gamme / Année / Référence

Zones d’affichage

• Afficher en en-tête : le sélecteur apparaît en haut de toutes les pages.
• Afficher en page d’accueil : le sélecteur apparaît dans le contenu de la page d’accueil.
• Widget : placez le sélecteur où vous voulez dans votre thème avec le tag Smarty {widget name='dffitmentfinder'}.

Fiche produit

• Vérification de compatibilité : affiche sous le prix un bandeau vert (le produit va sur le véhicule courant), rouge (il n’y va pas) ou neutre (aucun véhicule sélectionné).
• Tableau de correspondances : affiche en bas de fiche la liste complète des véhicules compatibles, groupée par marque et repliable.

Résultats par page

Nombre de produits affichés par page sur la page de résultats. Valeur par défaut : 12.

Alimenter le référentiel véhicules

Saisie manuelle

Rendez-vous dans Catalogue > Véhicules. Le bouton Ajouter ouvre le formulaire d’un véhicule :

• Marque et Modèle : obligatoires.
• Année de début et Année de fin : facultatives. Laissées vides, le véhicule est considéré comme valable pour toutes les années. Renseignées, elles définissent une plage : un véhicule 2012–2019 apparaîtra pour chacune des années de la plage dans le sélecteur.
• Motorisation : facultative, c’est le niveau le plus fin (par exemple « 1.2 PureTech »).
• Actif : un véhicule inactif n’apparaît plus dans le sélecteur mais conserve ses correspondances.

Rattacher des produits à un véhicule

Une fois le véhicule enregistré, un panneau Produits compatibles apparaît en bas de son formulaire. Tapez au moins deux caractères (nom ou référence) dans le champ de recherche, cliquez sur un résultat, et le produit est rattaché immédiatement. Le champ Note, facultatif, permet de préciser la portée de la compatibilité : « essieu avant uniquement », « boîte manuelle », « à partir du châssis n° 12000 »… Cette note s’affiche dans le tableau de correspondances en fiche produit.

Import CSV

Pour les référentiels volumineux, l’import CSV est la voie recommandée. Le fichier attendu comporte six colonnes :

make;model;year_from;year_to;variant;references

Exemple :

Peugeot;208;2012;2019;1.2 PureTech;BRK-P208-F|FLT-P208
Peugeot;208;2012;2019;1.6 BlueHDi;BRK-P208-F
HP;LaserJet Pro M404;;;;TNR-59A|TNR-59X

• Le séparateur, point-virgule ou virgule, est détecté automatiquement.
• La colonne references contient les références produit compatibles, séparées par une barre verticale.
• Les colonnes d’années et de motorisation peuvent rester vides.
• Un véhicule déjà présent dans le référentiel n’est pas dupliqué : ses correspondances sont simplement complétées.
• À la fin de l’import, un rapport indique le nombre de véhicules créés, de correspondances ajoutées et de lignes en erreur.

Export CSV

Le bouton Exporter en CSV, sur la page de configuration du module, télécharge l’intégralité du référentiel au même format. Pratique pour retravailler les données dans un tableur puis les réimporter.

Le parcours client

Sélection du véhicule

Le client choisit sa marque, puis son modèle, puis (si les niveaux sont actifs) son année et sa motorisation. Chaque menu se remplit à partir du précédent, sans rechargement de page. Le bouton Rechercher ouvre la page de résultats, qui affiche les produits compatibles avec les miniatures natives de votre thème.

Le véhicule sélectionné est ensuite mémorisé et rappelé sur toutes les pages, jusqu’à ce que le client en change ou l’efface.

Mon garage

Le bouton Ajouter à mon garage enregistre le véhicule courant. La page Mon garage, accessible depuis l’espace client, liste les véhicules enregistrés et permet de :

• désigner un véhicule comme véhicule courant ;
• voir directement les produits compatibles avec un véhicule ;
• supprimer un véhicule du garage.

Le garage fonctionne aussi pour les visiteurs non connectés : leurs véhicules sont conservés et rattachés automatiquement à leur compte dès qu’ils se connectent ou créent un compte.

Sur la fiche produit

Si la vérification de compatibilité est activée et qu’un véhicule courant est sélectionné, un bandeau apparaît sous le prix : vert si le produit est compatible, rouge sinon. En l’absence de véhicule sélectionné, un message neutre invite le client à en choisir un.

Si le tableau de correspondances est activé, la fiche affiche en bas la liste complète des véhicules compatibles, groupée par marque et repliable, avec la note éventuelle de chaque correspondance.

Questions fréquentes

Puis-je utiliser le module sans notion de véhicule ?

Oui. Désactivez les niveaux Année et Motorisation, renommez les libellés, et le module devient un sélecteur Marque / Série adapté aux cartouches, aux coques, aux pièces d’électroménager ou à tout catalogue où la compatibilité conditionne l’achat.

Que devient une correspondance quand je supprime un produit ?

Elle est supprimée automatiquement. Le référentiel ne conserve pas de lignes orphelines.

Le sélecteur ralentit-il mon site ?

Non. Les menus sont remplis en AJAX à la demande, en JavaScript natif et sans dépendance jQuery : seule la liste des marques est chargée au premier affichage.

Le module est-il compatible multiboutique ?

Oui. Les correspondances produit et les garages clients respectent le contexte boutique.