Documentation · Guide du Frontend
Alertes de recherche sur le frontend
Cette section documente la fonctionnalité d'agent de recherche (alertes de stock intelligentes) de l'extension ADP Car Market Hub WordPress : comment les visiteurs s'inscrivent aux notifications, comment fonctionne la confirmation par double opt-in et comment fonctionne la désinscription.
Quand utiliser ce document
Lisez ce document si vous configurez la fonctionnalité d'alertes de recherche pour la première fois, si vous aidez un visiteur à comprendre comment s'inscrire et gérer ses alertes, ou si vous dépannez des problèmes d'inscription et de notification.
Aperçu
La fonctionnalité d'agent de recherche permet aux visiteurs d'enregistrer un ensemble de critères de recherche et de recevoir une notification par e-mail chaque fois qu'un nouveau véhicule correspondant à ces critères est importé dans le système. Cette fonctionnalité utilise un flux de travail de double opt-in conforme au RGPD : le visiteur doit cliquer sur un lien de confirmation dans son e-mail avant que les notifications ne soient activées.
Les visiteurs peuvent se désinscrire à tout moment en cliquant sur le lien de désinscription inclus dans chaque e-mail de notification. Aucun compte ni connexion n'est requis.
Configuration requise ou prérequis
- La fonctionnalité d'agent de recherche doit être activée dans les réglages de l'extension (elle est activée par défaut, contrôlée par
FEATURE_SEARCH_AGENT). - Le site WordPress doit être capable d'envoyer des e-mails. Si l'envoi d'e-mails transactionnels n'est pas configuré sur votre hébergement, envisagez d'utiliser une extension SMTP. Sans une distribution d'e-mails fonctionnelle, les e-mails de confirmation et de notification ne seront pas envoyés.
- Le formulaire d'inscription à l'agent de recherche doit être visible sur la page d'archive. L'extension génère le formulaire dans le modèle d'archive lorsque la fonctionnalité est activée.
Instructions étape par étape
Visiteur : s'inscrire aux alertes de recherche
- Ouvrez la page d'archive des véhicules.
- Localisez le formulaire d'Agent de recherche sous ou à côté des filtres de recherche.
- Renseignez au moins un critère de recherche (comme la marque, le modèle, la fourchette de prix ou le kilométrage maximum).
- Saisissez une adresse e-mail dans le champ d'inscription.
- Soumettez le formulaire.
- Un message de réussite apparaît : « Presque terminé ! Veuillez vérifier votre boîte de réception et confirmer votre adresse e-mail. »
- Ouvrez l'e-mail de confirmation et cliquez sur le lien de confirmation.
- Un message de confirmation s'affiche sur le site. L'inscription est désormais active.
À partir de ce moment, le visiteur recevra une notification par e-mail chaque fois qu'un nouveau véhicule correspondant à ses critères enregistrés sera importé.
Visiteur : se désinscrire des alertes
- Ouvrez n'importe quel e-mail de notification reçu du système d'alerte de recherche.
- Cliquez sur le lien de désinscription en bas de l'e-mail.
- Une page de confirmation s'affiche. L'inscription est désactivée immédiatement.
L'action de désinscription est irréversible du côté du visiteur ; le visiteur devra s'inscrire à nouveau pour recevoir de futures alertes.
Référence de configuration
Critères de l'agent de recherche
Le formulaire d'inscription capture les critères suivants. Le visiteur doit en fournir au moins un pour que l'inscription soit acceptée :
| Critère | Description |
|---|---|
make | Marque du véhicule |
model | Modèle du véhicule |
body_type | Silhouette (type de carrosserie) |
drive_type | Transmission |
condition | État : neuf ou d'occasion |
color | Couleur extérieure |
min_price | Prix minimum |
max_price | Prix maximum |
mileage_max | Kilométrage maximum |
status | Filtre d'état (neuf, d'occasion ou tous) |
Tous les critères utilisent la logique ET : un véhicule doit correspondre à chaque critère spécifié pour déclencher une notification. Un critère vide est ignoré.
Statuts d'inscription
Chaque inscription est stockée dans la table personnalisée {prefix}as24ci_search_agents de l'extension et possède l'un des statuts suivants :
| Statut | Signification |
|---|---|
pending | E-mail de double opt-in envoyé ; le visiteur n'a pas encore confirmé |
active | Confirmé ; les notifications sont envoyées pour les véhicules correspondants |
inactive | Désinscrit par le visiteur |
paused | Mis en pause manuellement par un administrateur dans l'administration de l'extension |
Modèles d'e-mails
L'extension envoie automatiquement deux types d'e-mails :
E-mail de confirmation (envoyé lors de l'inscription) :
- Objet : « Veuillez confirmer votre agent de recherche »
- Contient les critères enregistrés du visiteur et le lien de confirmation.
E-mail de notification de correspondance (envoyé lorsqu'un nouveau véhicule correspondant est importé) :
- Objet : « Nouvelle correspondance de véhicule : [titre du véhicule] »
- Contient le titre du véhicule, un lien vers la page de détails du véhicule, les critères enregistrés et un lien de désinscription.
Les deux e-mails sont envoyés au format texte brut en utilisant l'adresse e-mail configurée du site comme expéditeur. Le contenu de l'e-mail n'est actuellement pas configurable depuis l'interface d'administration ; la personnalisation nécessite une intervention au niveau du code via les filtres WordPress.
Activation de la fonctionnalité
| Réglage | Clé d'option | Par défaut | Description |
|---|---|---|---|
| Activer l'agent de recherche | as24ci_feature_search_agent | Activé | Interrupteur principal pour la fonctionnalité d'alerte de recherche |
Notes opérationnelles
- L'extension envoie uniquement des notifications pour les véhicules nouvellement importés. Les véhicules qui se trouvaient déjà dans le système lorsqu'un visiteur s'est inscrit ne déclenchent pas de notification. Les véhicules mis à jour (réimportés) ne déclenchent pas non plus de notifications.
- Le formulaire d'inscription comprend un champ honeypot pour réduire les soumissions de robots. Si le champ masqué est rempli, la soumission est acceptée silencieusement mais aucune inscription n'est créée.
- Les inscriptions sont stockées dans une table de base de données personnalisée dédiée. La table est créée automatiquement lors de l'activation de l'extension et mise à niveau si nécessaire lors du chargement de l'extension.
- Le jeton utilisé pour les liens de confirmation et de désinscription est une chaîne hexadécimale de 64 caractères sécurisée sur le plan cryptographique. Le jeton est intégré dans les URL de confirmation et de désinscription en tant que paramètre GET.
- Les liens de confirmation ont le format :
/?as24ci_sa_action=confirm&token=[token] - Les liens de désinscription ont le format :
/?as24ci_sa_action=unsubscribe&token=[token] - Après une confirmation réussie, le visiteur est redirigé vers la page d'accueil avec
?as24ci_sa_msg=confirmed. - Après s'être désinscrit, le visiteur est redirigé vers la page d'accueil avec
?as24ci_sa_msg=unsubscribed. - Les administrateurs peuvent afficher, modifier, suspendre et supprimer les inscriptions depuis le panneau d'administration de l'extension.
Dépannage
Le formulaire d'inscription n'apparaît pas sur la page d'archive.
- Vérifiez que la fonctionnalité d'agent de recherche est activée dans les réglages de l'extension.
- Vérifiez que le shortcode
[as24ci_archive]ou l'archive CPT native est utilisé. Le formulaire d'agent de recherche fait partie du modèle d'archive. - Si le formulaire est généré mais n'est pas visible, recherchez des surcharges CSS du thème ou une configuration du gestionnaire de mise en page (Layout Manager) qui pourrait masquer le widget.
Le visiteur n'a reçu aucun e-mail de confirmation.
- Vérifiez que WordPress peut envoyer des e-mails. Utilisez une extension telle que WP Mail SMTP pour tester la distribution des e-mails.
- Vérifiez le dossier des courriers indésirables du site ; les e-mails de confirmation de WordPress peuvent parfois être marqués comme spam.
- Confirmez que l'adresse e-mail du visiteur est valide et a été saisie correctement.
Le lien de confirmation ne fonctionne pas.
- Assurez-vous que le lien est ouvert dans un navigateur et n'est pas tronqué par un client de messagerie.
- Vérifiez que les réglages des permaliens du site permettent de traiter les paramètres de requête.
- Si le lien a été cliqué plus d'une fois, le deuxième clic ne mettra pas à jour le statut (la ligne n'est mise à jour de
pendingàactivequ'une seule fois).
Les e-mails de notification ne sont pas envoyés lors de l'importation des véhicules.
- Vérifiez qu'au moins une inscription a le statut
active. - Confirmez que les véhicules importés étaient nouveaux (et non des mises à jour de véhicules existants). L'extension n'envoie pas de notifications pour les véhicules réimportés ou mis à jour.
- Vérifiez que le véhicule correspond aux critères de l'abonné : tous les critères utilisent la logique ET, un véhicule doit donc correspondre à chaque champ spécifié.