Flux de travail d'utilisation du frontend

Ce document décrit comment les visiteurs interagissent avec l'inventaire des véhicules sur la partie publique (frontend) d'un site WordPress propulsé par l'extension ADP Car Market Hub. Il couvre la page d'archive des véhicules, les pages de détails, les contrôles de filtrage, les Favoris, le Comparateur, les formulaires de contact et de demande d'essai routier, le calculateur de financement, le partage social, la fiche technique PDF et les alertes de recherche.

Quand utiliser ce document

Lisez ce document si vous :

• Souhaitez comprendre ce que les visiteurs voient et quelles actions ils peuvent effectuer sur le frontend.
• Configurez ou testez des fonctionnalités frontend (filtres, favoris, comparateur, formulaires, etc.).
• Devez vérifier que le frontend affiche correctement l'inventaire après une importation.
• Intégrez des shortcodes dans des pages WordPress.

Pour la configuration de ces fonctionnalités par l'administrateur, consultez le Manuel de l'administrateur.

---

Aperçu

L'extension affiche l'inventaire des véhicules sur le frontend WordPress en utilisant un type de publication personnalisé dédié (as24ci_car) et un ensemble de modèles intégrés. Les principales zones du frontend sont :

• Page d'archive des véhicules — une grille paginée de toutes les fiches de véhicules publiées.
• Page de détails du véhicule — les informations complètes d'un seul véhicule.
• Page de comparaison — comparaison côte à côte des véhicules sélectionnés.
• Page des favoris — une liste des véhicules que le visiteur a sauvegardés.

Ces pages peuvent être desservies via l'URL d'archive du CPT WordPress, les URL d'archive de taxonomie natives ou des pages WordPress contenant des shortcodes de l'extension.

---

Configuration requise ou prérequis

• Au moins un véhicule doit être importé et publié (statut de publication : publish) avant que quoi que ce soit n'apparaisse sur le frontend.
• Les pages d'archive de véhicules et de comparaison/favoris doivent être des pages WordPress publiées contenant les shortcodes appropriés, ou l'archive du CPT WordPress doit être accessible via votre structure de permaliens.
• Les fonctionnalités telles que les Favoris, le Comparateur, le Calculateur de financement, la Demande d'essai, le Partage social et les Alertes de recherche doivent être activées avant d'apparaître sur le frontend. Les options d'activation des Favoris et du Comparateur se trouvent sur l'onglet Settings (et dans l'assistant de configuration) ; le Partage social est configuré sous Design & Styles ; les Alertes de recherche sont gérées sur l'onglet dédié Search Alerts ; la réservation de Demande d'essai et le Calculateur de financement sont configurés respectivement sur l'onglet Leads et dans la section des réglages de financement. Vérifiez l'emplacement actuel dans la version installée de l'extension, car la disposition de l'administration peut évoluer entre les versions.
• Pour la fonctionnalité de Demande d'essai, les jours de la semaine disponibles, la plage horaire, la durée des créneaux et (facultativement) les dates d'exclusion doivent être configurés dans l'onglet Leads.

---

Page d'archive des véhicules

Affichage

La page d'archive affiche les véhicules publiés sous forme de grille de fiches. Chaque fiche présente :

• L'image du véhicule (miniature).
• Le badge d'état (Neuf, D'occasion, En promotion ou Offre vedette — configurable dans Design & Styles).
• Le titre du véhicule (marque, modèle, variante).
• Les caractéristiques clés (année, kilométrage, type de carburant, puissance).
• Le prix.
• Le bouton cœur des Favoris (si la fonctionnalité Favoris est activée).
• Le bouton Comparer (si la fonctionnalité Comparateur est activée).
• Le lien vers la page de détails du véhicule.

Le nombre de véhicules par page est configurable (12, 24, 48, 72 ou tous) et peut être modifié via le sélecteur par page dans la barre latérale de filtrage ou la barre d'outils.

Shortcode

L'archive peut être intégrée sur n'importe quelle page WordPress en utilisant :

[as24ci_archive]

Le shortcode prend en charge des attributs de surcharge de filtre facultatifs, par exemple :

[as24ci_archive make="BMW" per_page="12"]

Tri

Lorsque le filtre de tri est activé, les visiteurs peuvent trier les véhicules par :

• Les plus récents en premier (par défaut : par date d'importation/publication, décroissante)
• Prix : du moins cher au plus cher
• Prix : du plus cher au moins cher
• Kilométrage : du plus bas au plus élevé
• Année : la plus récente en premier
• Année : la plus ancienne en premier

Vérifiez les options de tri exactes disponibles dans votre version de l'extension.

---

Filtres d'archive

La barre latérale de filtrage sur la page d'archive permet aux visiteurs d'affiner la liste des véhicules. Chaque filtre peut être activé ou désactivé individuellement dans ADP Car Market Hub → Référence du gestionnaire de mise en page.

Filtres standards

Filtres avancés

Application des filtres

Les filtres sont appliqués via des paramètres de requête URL. La sélection d'une option de filtre recharge ou actualise l'archive avec les résultats filtrés. Plusieurs filtres peuvent être combinés. L'effacement d'un filtre le supprime de la requête.

---

Page de détails du véhicule

Une page de détails de véhicule est la vue unique du véhicule affichant toutes les informations de l'annonce.

Sections de contenu

Les champs spécifiques affichés dans le tableau des caractéristiques sont contrôlés par les réglages de l'onglet Mapping où chaque champ peut être affiché ou masqué et son libellé personnalisé.

---

Formulaire de contact

Le formulaire de contact intégré est affiché sur chaque page de détails de véhicule et permet aux visiteurs d'envoyer une demande de renseignements sur le véhicule.

Champs

• Nom — requis.
• E-mail — requis. Doit être une adresse e-mail valide.
• Téléphone — facultatif (à activer/désactiver dans les réglages des Leads).
• Message — facultatif (à activer/désactiver dans les réglages des Leads).
• Case à cocher de consentement — facultative (à activer et configurer dans les réglages des Leads). Lorsqu'elle est activée, le visiteur doit cocher la case avant de soumettre le formulaire.

Anti-spam et limitation du débit

• Honeypot : un champ masqué est inclus dans le formulaire. Les robots automatisés le remplissent généralement ; lorsqu'il est rempli, la soumission est rejetée silencieusement sans créer de lead ni envoyer d'e-mail.
• Limitation du débit : jusqu'à 5 soumissions par adresse IP par période de 5 minutes sont acceptées. Les soumissions au-delà de ce seuil reçoivent une réponse d'erreur.

Après la soumission

• Le visiteur est redirigé vers l'ancre #as24ci-contact sur la page du véhicule avec un indicateur de succès ou d'erreur.
• Un message de succès confirme que la demande a bien été reçue.
• Un message d'erreur s'affiche si la soumission a échoué (par exemple, si un champ obligatoire est manquant ou si la limite de débit a été dépassée).

Les messages de succès et d'erreur sont configurables dans les réglages des Leads.

---

Fiche de contact CMH Team

Lorsqu'un contact commercial de la concession est configuré dans CMH Team, la page de détails du véhicule affiche cette personne comme contact pour l'annonce.

• La fiche affiche le nom du contact et (le cas échéant) sa photo, son adresse e-mail et son numéro de téléphone, avec des liens cliquables pour envoyer un e-mail ou passer un appel.
• Le contact affiché est celui résolu pour le véhicule spécifique : un contact attribué directement à la voiture est prioritaire, puis le contact défini pour l'emplacement de la voiture, puis le contact par défaut global.
• Si aucun contact CMH Team ne s'applique, la page se rabat sur les détails du profil du vendeur de l'auteur du véhicule.
• Ce même contact résolu est également utilisé comme destinataire privilégié pour les demandes soumises via le formulaire de contact (voir Flux de travail de gestion des leads).

Les administrateurs gèrent ces contacts sous le menu CMH Team ; voir le Manuel de l'administrateur.

---

Réservation de demande d'essai

Lorsque la fonctionnalité de Demande d'essai est activée, un formulaire de réservation de demande d'essai est disponible sur chaque page de détails de véhicule (souvent affiché sous forme d'onglet à côté du formulaire de contact).

Comment ça fonctionne

1. Le visiteur sélectionne une date à l'aide d'un sélecteur de date. Les dates passées et les dates qui tombent sur un jour non configuré comme disponible ne peuvent pas être sélectionnées.
2. En fonction de la date sélectionnée, les créneaux horaires disponibles sont chargés dynamiquement. Les créneaux sont générés à partir de l'heure de début, de l'heure de fin et de la durée de créneau configurées (par exemple, de 09h00 à 17h00 par intervalles de 30 minutes).
3. Le visiteur sélectionne un créneau horaire et renseigne son nom, son e-mail et son numéro de téléphone facultatif.
4. Lors de la soumission, une demande d'essai routier est créée en tant que lead avec is_test_drive = 1 et le champ appointment_date renseigné.
5. Les notifications par e-mail standard sont envoyées (avec la mention "Demande d'essai routier" indiquée dans l'objet et le corps du message).

Configuration (pour les administrateurs)

• Jours de la semaine disponibles — quels jours de la semaine permettent les essais routiers (du lundi au dimanche).
• Heure de début / Heure de fin — la plage horaire quotidienne pour les créneaux (par exemple, 08h00–18h00).
• Durée du créneau — durée de chaque créneau horaire en minutes (minimum 5 minutes).
• Dates d'exclusion — dates spécifiques (saisies sous la forme YYYY-MM-DD, une par ligne) auxquelles aucun essai routier n'est disponible, quel que soit le réglage du jour de la semaine.

---

Calculateur de financement

Lorsque la fonctionnalité Calculateur de financement est activée, un estimateur interactif de mensualité est affiché sur les pages de détails des véhicules.

Le calculateur utilise :

• Le prix du véhicule issu de l'annonce importée.
• Le taux d'intérêt — valeur par défaut configurable (onglet Loans dans les réglages des fonctionnalités).
• La durée du prêt — durée par défaut configurable en mois (12, 24, 36, 48, 60, 72 ou 84 mois).
• L'apport personnel — valeur par défaut configurable en pourcentage du prix du véhicule.

Les visiteurs peuvent ajuster le taux, la durée et l'apport personnel pour voir différentes estimations de paiement. Le résultat est un montant de mensualité calculé affiché sur la page. Ce calculateur est fourni à titre indicatif uniquement ; les conditions de financement réelles dépendent de l'organisme financier du client.

---

---

Favoris (Liste d'envies)

Lorsque la fonctionnalité Favoris est activée, les visiteurs peuvent enregistrer des véhicules dans une liste d'envies personnelle.

Comment ça fonctionne

• Un bouton icône de cœur apparaît sur chaque carte de véhicule dans l'archive et sur la page de détail du véhicule.
• Cliquer sur le cœur ajoute le véhicule aux favoris du visiteur. Cliquer à nouveau le retire.
• Les favoris sont stockés dans le navigateur du visiteur (localStorage). Aucun compte ni connexion n'est requis.
• Les favoris sont spécifiques à l'appareil et au navigateur — ils ne se synchronisent pas entre les appareils ou les navigateurs, et sont effacés si le visiteur vide le stockage de son navigateur.
• Un maximum de 50 véhicules peut être stocké dans les favoris en même temps.

Page des favoris

Intégrez la page des favoris sur n'importe quelle page WordPress en utilisant le shortcode :

[as24ci_favorites]

La page récupère les données des véhicules pour les identifiants stockés via un point de terminaison de l'API REST et affiche une liste avec les champs configurés. Les champs visibles sont configurables dans le Référence du gestionnaire de mise en page (zone Favoris).

---

Comparateur de véhicules

Lorsque la fonctionnalité Comparer est activée, les visiteurs peuvent sélectionner plusieurs véhicules pour une comparaison côte à côte.

Comment ça fonctionne

• Un bouton Comparer apparaît sur les cartes d'archive et sur la barre d'action flottante de la page de détail du véhicule.
• Cliquer sur le bouton bascule le véhicule dans ou hors de la sélection de comparaison.
• Les véhicules sélectionnés sont stockés dans localStorage. Aucune connexion n'est requise.
• Le nombre maximum de véhicules pouvant être comparés à la fois est configurable (par défaut : 4). Lorsque le maximum est atteint, un message en informe le visiteur.
• Une barre flottante ou un indicateur montre généralement combien de véhicules sont sélectionnés et fournit un lien vers la page de comparaison.

Page de comparaison

La page de comparaison est générée par le shortcode :

[as24ci_compare]

Cette page affiche les véhicules sélectionnés dans un tableau côte à côte pour une comparaison facile des spécifications. Si aucun véhicule n'est sélectionné, un message d'instruction s'affiche.

---

Partage social

Lorsque le Partage social est activé, une rangée de boutons de partage apparaît sur les pages de détail des véhicules. Aucun SDK JavaScript externe n'est chargé — tous les boutons sont des liens standard basés sur des URL.

Réseaux pris en charge

• WhatsApp — ouvre la boîte de dialogue de partage WhatsApp.
• Facebook — ouvre la boîte de dialogue de partage Facebook.
• Instagram — Instagram ne prend pas en charge le partage web direct basé sur des URL ; le comportement du bouton pour Instagram peut varier. À vérifier dans la version actuelle de l'extension.
• X (anciennement Twitter) — ouvre la fenêtre de rédaction de X/Twitter avec l'URL du véhicule pré-remplie.
• E-mail — ouvre le client de messagerie par défaut du visiteur avec un objet et un corps de message pré-rédigés.
• Copier le lien — copie l'URL du véhicule dans le presse-papiers du visiteur.

Les réseaux individuels peuvent être activés ou désactivés dans les réglages des Fonctionnalités. L'emplacement (au-dessus ou en dessous de la description, par exemple) est également configurable.

---

Fiche technique PDF

Lorsque la fonctionnalité Fiche technique PDF est activée, les visiteurs peuvent ouvrir une page HTML optimisée pour l'impression pour n'importe quel véhicule, puis utiliser la fonction Imprimer → Enregistrer au format PDF de leur navigateur pour créer un document PDF.

La page de la fiche technique est accessible en ajoutant le paramètre de requête ?as24ci_pdf={post_id} à l'URL du véhicule. Un bouton ou un lien pour déclencher cela est généralement inclus sur la page de détail du véhicule lorsque la fonctionnalité est activée.

Champs configurables

Les champs suivants peuvent être inclus ou exclus de la fiche technique (configurables par les administrateurs) :

Titre du véhicule, prix, kilométrage, première immatriculation, type de carburant, transmission, puissance, type de carrosserie, couleur extérieure, portes, sièges, classe d'émission, valeurs de CO2, consommation d'énergie, liste des équipements, description, emplacement et coordonnées de contact.

---

Alertes de recherche (Smart Stock Alerts)

Lorsque la fonctionnalité Alertes de recherche est activée, les visiteurs peuvent s'abonner à une recherche enregistrée et recevoir une notification par e-mail lorsqu'un véhicule correspondant est importé.

Comment ça fonctionne pour les visiteurs

1. Sur la page d'archive, après avoir appliqué un ou plusieurs filtres, un formulaire Enregistrer la recherche / S'abonner aux alertes s'affiche.
2. Le visiteur saisit son adresse e-mail et soumet le formulaire.
3. Un e-mail de confirmation Double-Opt-In conforme au RGPD est envoyé. L'abonnement reste en statut En attente jusqu'à ce que le visiteur clique sur le lien de confirmation dans l'e-mail.
4. Après confirmation, l'abonnement devient Actif. À partir de ce moment, le visiteur reçoit une notification par e-mail chaque fois qu'un véhicule correspondant à ses critères de filtrage enregistrés est importé.
5. Chaque e-mail de notification comprend un lien de désabonnement. Cliquer dessus passe l'abonnement en statut Inactif (désabonné).

Déclencheur de notification

Les notifications sont envoyées automatiquement sur le hook d'action as24ci_vehicle_imported, qui se déclenche chaque fois qu'un véhicule est créé ou mis à jour lors d'une exécution d'importation. L'extension vérifie tous les abonnements actifs et envoie des e-mails aux abonnés correspondants.

Vue administrateur

Les abonnements actifs, en attente, mis en pause et désabonnés sont répertoriés dans l'onglet d'administration Référence des alertes de recherche. Les administrateurs peuvent filtrer, afficher et supprimer les abonnements.

---

Notes opérationnelles

• Les filtres sont implémentés sous forme de paramètres de requête URL. Les visiteurs peuvent enregistrer des vues filtrées dans leurs favoris ou partager des URL avec des filtres appliqués.
• Les Favoris et le Comparateur utilisent le localStorage du navigateur. Vider le stockage du navigateur ou utiliser un autre appareil/navigateur entraîne la perte de la sélection enregistrée.
• Le formulaire de contact renvoie vers la page actuelle avec un paramètre de requête de succès ou d'erreur. JavaScript n'est pas requis pour la soumission du formulaire ; le formulaire fonctionne avec un POST HTML standard.
• Le calculateur de financement est purement illustratif. Les résultats sont calculés dans le navigateur à partir des valeurs par défaut configurées. Ils ne représentent pas une offre de crédit contraignante.
• La disponibilité des essais routiers est évaluée côté serveur. Les dates et créneaux disponibles sont dérivés des réglages configurés au moment du chargement de la page.
• Les liens de partage social sont de simples ancres HTML. Aucun cookie de suivi ni script tiers n'est chargé. Le suivi des clics n'est pas intégré.
• La fiche technique PDF est une page d'impression générée par le navigateur, et non un fichier PDF généré par le serveur. La qualité d'impression et la mise en page dépendent du navigateur et du système d'exploitation du visiteur.
• Les e-mails d'alerte de recherche sont envoyés via WordPress wp_mail(), qui utilise la configuration de messagerie du serveur. Si la distribution des e-mails n'est pas fiable, envisagez de configurer le SMTP.

---

Dépannage

---

Documents connexes

• Manuel de l'utilisateur
• Flux de travail de gestion des leads
• Flux de travail d'importation de véhicules
• Manuel de l'administrateur