Live Search Intelligent — Guide complet
Installer, configurer et exploiter DFLiveSearch : recherche live, suggestions, produits recommandés, statistiques, alertes email et personnalisation pour PrestaShop 8 et 9.
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 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.
Le module s’appuie sur les hooks displayHeader, displayTop, displaySearch, displayBackOfficeHeader et actionOrderStatusPostUpdate. Il crée quatre tables : dflivesearch_stats, dflivesearch_log, dflivesearch_alerts et dflivesearch_popular.
Installation
Installez le module comme n’importe quel module PrestaShop :
- Téléchargez l’archive
dflivesearch.zipdepuis votre compte client. - Dans le back-office, allez dans Modules > Gestionnaire de modules.
- Cliquez sur Installer un module et déposez l’archive.
- 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. 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é applique automatiquement les valeurs par défaut des nouvelles options (couleurs, largeur de la fenêtre, mode des produits recommandés) sans toucher à votre configuration existante. 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 un nombre maximum 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 fenêtre de 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,1200pxou100%.
Ces valeurs sont injectées en CSS sur le front. Pour une fenêtre pleine largeur sur mobile comme sur desktop, saisissez 100% dans le champ de largeur.
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.
Seuls les produits actifs et visibles sont proposés dans le sélecteur. L’ordre des vignettes détermine l’ordre d’apparition dans le carousel.
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. Les résultats sont classés par pertinence (nom exact, puis nom commençant par la requête, puis correspondances partielles).
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.
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.
Si vous saisissez une quantité supérieure au stock disponible d’un produit non commandable hors stock, le module n’ajoute pas le produit et affiche un message indiquant la quantité restante.
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.
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. Ces recherches sans résultat sont une source précieuse pour détecter les lacunes du catalogue ou les fautes de frappe fréquentes.
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 pour purger immédiatement les entrées anciennes.
FAQ et dépannage
La recherche ne renvoie rien pour plusieurs mots
Depuis la version 1.1.9, 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. Assurez-vous d’utiliser la dernière version et videz le cache si l’ancien comportement persiste.
L’ajout au panier ne fonctionne pas sur un panier vide
Ce cas est résolu : le module persiste désormais le panier nouvellement créé. Mettez à jour vers la dernière version puis videz le cache.
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 tables du module. Aucune donnée résiduelle n’est laissée en base.