Live Search Intelligent — Guide complet

Présentation et prérequis

DFLiveSearch remplace la recherche native de PrestaShop par un moteur live en AJAX : un panneau de résultats s’ouvre dès les premiers caractères, avec l’image, le nom, le prix et les badges promotionnels de chaque produit. Le module ajoute aussi un moteur de recherche intelligent (synonymes, tolérance aux fautes de frappe, pertinence pondérée), des carousels de suggestions (recherches populaires et produits recommandés), un tableau de bord analytique complet et des alertes email sur les recherches sans résultat.

• Compatible PrestaShop 8.0 à 9.x, thème Classic et thèmes dérivés.
• PHP 8.1 et supérieur.
• Multiboutique et multilingue (FR/EN/ES/DE/IT).
• Aucune surcharge de fichiers : uniquement des hooks natifs.

Installation

Installez le module comme n’importe quel module PrestaShop :

1. Téléchargez l’archive dflivesearch.zip depuis votre compte client.
2. Dans le back-office, allez dans Modules > Gestionnaire de modules.
3. Cliquez sur Installer un module et déposez l’archive.
4. Une fois installé, cliquez sur Configurer.

À l’installation, le module enregistre ses hooks, crée ses tables et pré-remplit un texte d’invite (placeholder) traduit dans les cinq langues. Quelques groupes de synonymes courants sont également pré-remplis et le dictionnaire de correction des fautes est construit à partir de votre catalogue. Le champ de recherche live est immédiatement actif sur votre boutique.

Mise à jour

La mise à jour s’effectue normalement depuis le Gestionnaire de modules. Le script d’upgrade intégré crée les nouvelles tables, applique les valeurs par défaut des nouvelles options (synonymes, pertinence, tolérance aux fautes, apparence de la barre) sans toucher à votre configuration existante, puis reconstruit le dictionnaire de correction. Aucune action manuelle n’est requise. Après mise à jour, videz le cache PrestaShop et régénérez les assets pour purger l’ancien JavaScript.

Configuration générale

La page de configuration regroupe les réglages du comportement de la recherche :

• Activer le module : active ou désactive le champ de recherche live sur la boutique.
• Texte d’invite (placeholder) : texte affiché dans le champ, traduisible par langue.
• Nombre de caractères minimum : seuil de déclenchement de la recherche (2 par défaut).
• Nombre maximum de produits : limite de résultats affichés dans le panneau.
• Recherches populaires et recherches récentes : affichage des carousels de suggestions avant la frappe.
• Autocomplétion : suggestions de termes (produits, catégories, recherches populaires) pendant la saisie, avec navigation au clavier (flèches haut/bas, Entrée, Échap) et surlignage du terme saisi. Le nombre maximum de suggestions est configurable.
• Ajout rapide au panier et sélecteur de quantité : options permettant d’ajouter un produit directement depuis les résultats.
• Produits personnalisés : prend en compte l’historique du client connecté pour les recommandations automatiques.

Apparence

La section Apparence permet d’adapter la recherche à votre charte graphique :

• Couleur principale : couleur des boutons et accents (par défaut #2196F3).
• Couleur principale (survol) : couleur au survol des boutons (par défaut #1976D2).
• Largeur max de la fenêtre : largeur maximale du panneau de recherche. Accepte une valeur CSS comme 900px, 1200px ou 100%.
• Taille de la barre de recherche (depuis la version 1.4.0) : Small, Medium ou Large. Ajuste la hauteur, la taille du texte et celle de l’icône de la barre affichée dans votre en-tête.
• Largeur de la barre de recherche : largeur maximale de la barre elle-même (400px, 50%, 30rem…). Laissez le champ vide pour occuper toute la largeur du conteneur du thème.
• Arrondi des angles de la barre : de 0 (angles droits) à 50 px (forme pilule).
• Raccourci clavier : ouvre la recherche avec Ctrl+K (Cmd+K sur Mac) ou la touche / depuis n’importe où sur la page. Un badge indicatif (« Ctrl K » ou « ⌘K ») s’affiche dans la barre sur desktop. L’option est désactivable.

Depuis la version 1.4.0, la fenêtre de recherche est entièrement accessible au clavier : la barre est focusable et s’ouvre avec Entrée ou Espace, le focus reste dans la fenêtre pendant la navigation Tab, Échap ferme la fenêtre et le focus revient sur la barre. Un bouton d’effacement apparaît dans le champ dès qu’un texte est saisi, et les animations respectent la préférence système prefers-reduced-motion.

Produits recommandés

Les produits recommandés s’affichent en carousel dès l’ouverture du champ de recherche. Deux modes sont disponibles via le réglage Source des produits recommandés :

• Automatique : le module sélectionne les meilleures ventes (et tient compte de l’historique client si l’option « Produits personnalisés » est activée).
• Manuel : vous choisissez précisément les produits mis en avant.

En mode manuel, un sélecteur dédié apparaît : recherchez un produit par nom ou référence, cliquez pour l’ajouter, puis réorganisez les vignettes par glisser-déposer. L’ordre défini est respecté à l’affichage côté boutique.

Comportement de la recherche

Recherche par mots

La recherche fonctionne par mots : chaque mot saisi doit être trouvé (dans le nom, la référence, le code EAN ou la description courte), dans n’importe quel ordre. Une requête comme « stéthoscope simple pavillon » trouve donc le produit même si ces mots ne se suivent pas dans le nom. Depuis la version 1.2.0, chaque mot est aussi étendu à ses synonymes et la recherche couvre les références de déclinaisons (voir la section « Recherche intelligente »).

Produits à déclinaisons

Pour un produit comportant des déclinaisons, le bouton d’ajout au panier est remplacé par un bouton « Voir les options » qui renvoie vers la fiche produit, afin que le client choisisse sa déclinaison avant l’ajout. Lorsque le client a recherché la référence exacte d’une déclinaison, ce bouton mène directement à la variante concernée.

Disponibilité et stock

Les produits en rupture restent affichés dans les résultats et portent un badge « Rupture de stock ». Ce badge n’apparaît pas pour les produits dont la commande hors stock est autorisée (réglage « Accepter les commandes » de PrestaShop) : ceux-ci restent ajoutables au panier.

Recherche intelligente : synonymes, fautes de frappe et pertinence

Depuis la version 1.2.0, DFLiveSearch intègre un moteur de recherche intelligent. Tous ces réglages se trouvent dans la section Recherche intelligente de la page de configuration.

Synonymes

Le dictionnaire de synonymes relie des termes équivalents : un client qui cherche « tv » trouve aussi les produits nommés « télévision » ou « téléviseur ». L’éditeur est multilingue (un onglet par langue). Saisissez un groupe par ligne, les termes étant séparés par des virgules :

tv, télé, télévision, téléviseur
ordinateur, pc, laptop, ordi
casque, écouteurs, headphones

Tous les termes d’une même ligne sont considérés comme équivalents : rechercher l’un d’eux étend automatiquement la requête aux autres. Activez ou désactivez la fonctionnalité via l’option Activer les synonymes. Quelques groupes courants sont pré-remplis à l’installation ; adaptez-les à votre catalogue.

Tolérance aux fautes de frappe

Lorsqu’une recherche ne renvoie aucun résultat, le module tente automatiquement de corriger la faute à partir d’un dictionnaire construit depuis votre catalogue (noms de produits, références, catégories). Si la correction donne des résultats, ils sont affichés directement avec la mention « Résultats pour… » et un lien permettant de revenir à l’orthographe d’origine.

• Tolérance aux fautes de frappe : active ou désactive la correction automatique.
• Distance de correction max : nombre maximum de caractères différents toléré (1 à 3 ; 2 recommandé). Une valeur plus élevée corrige davantage de fautes mais augmente le risque de faux positifs.
• Afficher « Vouliez-vous dire ? » : affiche le bandeau de correction. Désactivée, la correction s’applique silencieusement.

La correction repose sur une présélection phonétique (SOUNDEX) suivie d’un calcul de distance de Levenshtein : elle retrouve par exemple « téléviseur » à partir de « televiseir ». Les mots de moins de trois caractères ne sont pas corrigés ; les équivalences courtes (comme « tv ») relèvent des synonymes.

Dictionnaire de correction

Le dictionnaire de correction (table dflivesearch_lexicon) est construit à l’installation, puis peut être reconstruit à tout moment via le bouton Reconstruire le dictionnaire de la page de configuration. La zone d’information affiche le nombre de mots indexés et la date de dernière reconstruction.

Pertinence des résultats

Les résultats sont classés par un score de pertinence pondéré : correspondance exacte du nom (score le plus élevé), nom commençant par la requête, requête contenue dans le nom, puis référence et EAN. Deux boosts complètent ce classement :

• Boost produits en stock : à pertinence comparable, les produits disponibles remontent en haut de liste.
• Boost meilleures ventes : favorise les produits les plus vendus, à partir des statistiques de ventes PrestaShop.

Ces deux options sont activables indépendamment dans la section Recherche intelligente.

Recherche par référence de déclinaison

La recherche couvre désormais les identifiants propres aux déclinaisons : référence, EAN, UPC et référence fournisseur de chaque variante. Taper la référence ou le code-barres d’une déclinaison remonte donc le produit parent. Lorsque la requête ressemble à un code, le résultat pointe directement sur la bonne déclinaison (lien vers la variante exacte) et la carte affiche la référence et le prix de cette variante.

Tableau de bord et statistiques

Le module enregistre chaque recherche (terme saisi, nombre de résultats, clic éventuel sur un produit, conversion en commande). Le tableau de bord du back-office présente :

• le total des recherches et le nombre de recherches uniques ;
• les taux de succès, de clic et de conversion ;
• un graphique d’évolution des recherches par jour ;
• le top 20 des recherches avec clics et conversions ;
• le top 20 des recherches sans résultat ;
• un export CSV de l’ensemble des données.

Le suivi des conversions s’effectue via le hook actionOrderStatusPostUpdate : une commande passée après un clic dans les résultats de recherche est comptabilisée comme convertie. Depuis la version 1.3.0, chaque commande n’est comptabilisée qu’une seule fois, quels que soient les changements de statut ultérieurs.

Alertes email

Le système d’alerte surveille les termes qui ne renvoient aucun résultat. Dès qu’un terme dépasse le seuil configurable (5 par défaut), une alerte email est envoyée à l’adresse de votre choix et une notification apparaît dans l’en-tête du back-office. Chaque alerte peut être marquée comme lue ou supprimée. Les templates d’email sont fournis dans les cinq langues (FR/EN/ES/DE/IT) et le sujet est envoyé dans la langue par défaut de la boutique. Ces recherches sans résultat sont une source précieuse pour détecter les lacunes du catalogue, les fautes de frappe fréquentes ou les synonymes manquants à ajouter.

Rétention des données

Les logs de recherche sont conservés 90 jours par défaut (durée configurable). Un bouton de nettoyage manuel est disponible dans le back-office, et depuis la version 1.3.0 une purge automatique s’applique en continu selon la durée de rétention configurée.

FAQ et dépannage

Comment configurer les synonymes ?

Dans la section « Recherche intelligente » de la configuration, saisissez un groupe de synonymes par ligne (termes séparés par des virgules) dans l’onglet de chaque langue, puis enregistrez. Vérifiez que l’option « Activer les synonymes » est active.

Comment changer la taille ou la forme de la barre de recherche ?

Dans la section « Apparence », choisissez la taille (Small / Medium / Large), la largeur maximale et l’arrondi des angles de la barre. Un arrondi de 50 donne une barre en forme de pilule. Ces réglages ne concernent que la barre affichée dans l’en-tête ; la fenêtre de résultats se règle via « Largeur max de la fenêtre ».

Comment désactiver le raccourci Ctrl+K ?

Dans la section « Apparence », passez l’option « Raccourci clavier » sur Non. Le badge disparaît de la barre et les touches Ctrl+K, Cmd+K et / ne déclenchent plus l’ouverture de la recherche.

Une recherche avec une faute renvoie une page vide

Vérifiez que l’option « Tolérance aux fautes de frappe » est activée et que le dictionnaire de correction contient des mots (zone d’information de la configuration). Après un import important, cliquez sur « Reconstruire le dictionnaire ». Vous pouvez aussi augmenter la « Distance de correction max ».

La recherche ne trouve pas une référence de déclinaison

La recherche par référence de variante (réf, EAN, UPC, réf fournisseur) est disponible depuis la version 1.2.0. Mettez à jour, videz le cache et régénérez les assets. Pour obtenir le lien direct vers la variante exacte, la requête doit ressembler à un code (contenir au moins un chiffre).

La recherche ne renvoie rien pour plusieurs mots

La recherche fonctionne par mots indépendants de l’ordre. Si vous venez de mettre à jour, videz le cache PrestaShop et régénérez les assets pour charger le nouveau JavaScript.

Le panneau d’autocomplétion masque les résultats

L’autocomplétion se ferme automatiquement lorsque le champ perd le focus ou avec la touche Échap. Assurez-vous d’utiliser la dernière version et videz le cache si l’ancien comportement persiste.

Un badge « rupture de stock » apparaît sur un produit commandable

Le module lit le réglage « Accepter les commandes » dans Quantités de la fiche produit (stocké côté StockAvailable sur PrestaShop 8). Vérifiez ce réglage : s’il autorise la commande, aucun badge ne sera affiché.

Que se passe-t-il à la désinstallation ?

La désinstallation supprime proprement les hooks, les variables de configuration et les six tables du module. Aucune donnée résiduelle n’est laissée en base.