Recherches Sauvegardées & Alertes Nouveaux Produits — Documentation

Présentation

Le module Recherches Sauvegardées & Alertes (dfsavedsearch) permet à vos clients d’enregistrer une combinaison de critères de recherche — mots-clés, catégorie, fabricant, fourchette de prix, disponibilité — et de recevoir un email automatique dès qu’un nouveau produit correspondant est publié dans votre boutique.

Chaque recherche sauvegardée devient un canal de réengagement : le client revient de lui-même le jour où vous mettez en ligne un produit qui l’intéresse. Un journal anti-doublon garantit qu’il n’est alerté que des produits publiés après l’enregistrement de sa recherche, et jamais deux fois pour le même produit.

Installation

1. Dans votre back-office, ouvrez Modules > Module Manager puis cliquez sur Téléverser un module.
2. Sélectionnez l’archive dfsavedsearch.zip et validez.
3. À l’installation, le module crée ses deux tables SQL, son onglet d’administration et sa configuration par défaut. Un jeton de cron (32 caractères) est généré automatiquement.
4. Le module est actif immédiatement. Aucune dépendance externe n’est requise (ni Composer, ni framework).

Configuration (back-office)

Rendez-vous sur la page de configuration du module (Modules > Module Manager > dfsavedsearch > Configurer). Les réglages disponibles sont :

• Activer le module — active ou suspend l’affichage du bouton et l’envoi des alertes.
• Produits par digest — nombre maximum de produits listés dans un même email d’alerte (12 par défaut).
• Recherches par client — nombre maximum de recherches qu’un client peut enregistrer (20 par défaut).
• Fréquence par défaut — quotidienne ou hebdomadaire, appliquée aux nouvelles recherches.
• Jeton de cron — affiché en clair, avec un bouton de régénération. L’URL complète du cron et la date du dernier passage sont rappelées dans un panneau dédié.

Les valeurs sont stockées dans les variables de configuration DFSAVEDSEARCH_ENABLED, DFSAVEDSEARCH_MAX_PRODUCTS, DFSAVEDSEARCH_MAX_PER_CUST, DFSAVEDSEARCH_DEFAULT_FREQ, DFSAVEDSEARCH_CRON_TOKEN et DFSAVEDSEARCH_LAST_CRON.

Utilisation côté client

Sur la page de résultats de recherche, un bouton « Enregistrer cette recherche » est injecté automatiquement. En cliquant dessus, le client ouvre une fenêtre où il peut :

• nommer sa recherche ;
• préciser ou ajuster ses critères : mots-clés, catégorie (sous-catégories incluses), fabricant, prix minimum et maximum, produits en stock uniquement ;
• activer, s’il le souhaite, l’alerte email et choisir sa fréquence.

L’alerte email repose sur une case d’opt-in explicite, décochée par défaut, accompagnée d’un texte de consentement clair. Un visiteur non connecté est invité à se connecter avant d’enregistrer une recherche.

Espace « Mes recherches »

Une entrée « Mes recherches » est ajoutée dans le compte client. Le client y retrouve toutes ses recherches enregistrées et peut, pour chacune :

• activer ou désactiver l’alerte email ;
• changer la fréquence (quotidienne / hebdomadaire) ;
• supprimer la recherche.

Les critères de chaque recherche sont résumés sous forme de badges lisibles (catégorie, fabricant, fourchette de prix, etc.).

Planification du cron (envoi des alertes)

L’envoi des emails est piloté par une tâche cron sécurisée par jeton. Configurez le planificateur de tâches de votre serveur (ou un service de cron) pour appeler l’URL suivante :

https://votre-boutique.com/index.php?fc=module&module=dfsavedsearch&controller=cron&token=VOTRE_TOKEN

Remplacez VOTRE_TOKEN par le jeton affiché dans la configuration du module.

Le traitement se fait par lots (200 recherches par passage) pour rester léger. La sortie du cron indique le nombre de recherches traitées, d’emails envoyés et d’éventuelles erreurs, journalisées dans les logs PrestaShop.

Conformité RGPD

• Opt-in explicite : l’alerte email n’est jamais activée sans une action volontaire du client (case décochée par défaut).
• Désinscription en un clic : chaque email contient un lien de désinscription signé qui désactive l’alerte sans connexion.
• Export et suppression : le module s’intègre aux hooks RGPD de PrestaShop (psgdpr) pour l’export et la suppression des données personnelles.
• Purge automatique : à la suppression d’un compte client, toutes ses recherches enregistrées sont supprimées.

Compatibilité & conventions techniques

• PrestaShop 8.0 à 9.x, multiboutique, 5 langues.
• Hooks utilisés : displayCustomerAccount, actionFrontControllerSetMedia, displayFooter, actionObjectCustomerDeleteAfter, actionDeleteGDPRCustomer, actionExportGDPRData.
• Onglet d’administration AdminDfSavedSearch sous le menu Clients.
• Aucune dépendance : autoloader PSR-4 manuel, JS vanilla, aucun service externe.

Dépannage

• Aucun email n’est envoyé — vérifiez que le cron est bien appelé (date du dernier passage dans la configuration), que le module est activé et que la configuration email de PrestaShop est fonctionnelle.
• Le bouton n’apparaît pas — il ne s’affiche que sur la page de résultats de recherche ; vérifiez que le module est activé et videz le cache PrestaShop.
• Un client ne reçoit pas d’alerte — assurez-vous que l’alerte est active pour la recherche concernée et que de nouveaux produits correspondants ont bien été publiés après l’enregistrement.