Documentation · Guide du Frontend

Favoris

Ce document couvre la fonctionnalité de favoris (liste de souhaits) de l'extension ADP Car Market Hub WordPress : comment les visiteurs sauvegardent les véhicules, comment fonctionne la page des favoris, quelles données sont affichées et quelles limites s'appliquent.

Quand utiliser ce document

Lisez ce document si vous configurez la fonctionnalité de favoris pour la première fois, si vous configurez les détails du véhicule qui apparaissent sur la page des favoris, ou si vous aidez un visiteur à comprendre comment sauvegarder et retrouver des véhicules.

Aperçu

La fonctionnalité de favoris permet aux visiteurs de sauvegarder les véhicules qui les intéressent et de les consulter plus tard sur une page de favoris dédiée. Les ID des véhicules sauvegardés sont stockés dans le localStorage du navigateur. Aucun compte ni connexion n'est requis.

Lorsqu'un visiteur ouvre la page des favoris, l'extension récupère les données actuelles du véhicule pour tous les ID sauvegardés à partir d'un point de terminaison de l'API REST et génère la liste de manière dynamique. Cela signifie que la page des favoris reflète toujours l'état actuel de la liste des véhicules, y compris les changements de prix ou les véhicules qui ont été retirés depuis qu'ils ont été sauvegardés.

Configuration requise ou prérequis

La fonctionnalité de favoris doit être activée dans les réglages de l'extension (elle est activée par défaut).
Une page de favoris doit exister dans WordPress avec le shortcode [as24ci_favorites] dans son contenu.
L'API REST de WordPress doit être accessible publiquement pour que la page des favoris puisse charger les données des véhicules.

Instructions étape par étape

Configurer la page des favoris

Dans l'administration de WordPress, allez dans Pages → Ajouter nouvelle.
Donnez un titre à la page, tel que « Mes favoris » ou « Véhicules sauvegardés ».
Dans le contenu de la page, ajoutez le shortcode [as24ci_favorites].
Publiez la page.

La page des favoris génère un conteneur qui est alimenté par JavaScript lors du chargement de la page. Aucune configuration supplémentaire du shortcode n'est requise.

Sauvegarder un véhicule en tant que visiteur

Sur l'archive des véhicules, localisez une carte de véhicule. Un bouton de favoris (icône de cœur) apparaît sur la carte lorsque la fonctionnalité de favoris et l'élément favorite_btn sont tous deux activés.
Cliquez sur le bouton de cœur pour ajouter le véhicule à vos favoris. Le bouton change d'état pour indiquer que le véhicule est sauvegardé.
Cliquez à nouveau sur le bouton pour retirer le véhicule de vos favoris.

Le même bouton de favoris est disponible sur les pages de détails des véhicules individuels dans la barre d'action flottante collante.

Consulter les favoris sauvegardés

Naviguez vers la page des favoris.
La page se charge et appelle le point de terminaison REST de l'extension pour récupérer les données actuelles de tous les ID de véhicules sauvegardés.
Chaque véhicule sauvegardé est affiché sous forme de carte avec sa photo, son titre, son prix et les champs de spécification configurés.
Cliquez sur « Plus de détails » sur une carte pour ouvrir la page de détails complète du véhicule.

Si aucun véhicule n'est sauvegardé, la page affiche « Vous n'avez pas encore de favoris sauvegardés. »

Référence de configuration

Réglages des favoris

Réglage	Emplacement	Description
Activer les favoris	Réglages de l'extension → Réglages (ou Assistant de configuration)	Active ou désactive l'ensemble de la fonctionnalité de favoris
Champs des favoris	Référence du gestionnaire de mise en page → Favoris	Quels champs de véhicule sont affichés sur chaque carte de favoris

Champs de la page des favoris

Les champs de véhicule affichés sur chaque carte de favoris sont contrôlés par la zone Référence du gestionnaire de mise en page → Favoris. Les champs suivants sont pris en charge et peuvent être activés ou désactivés individuellement :

ID du champ	Description
`price`	Prix de vente (formaté avec la devise)
`mileage`	Kilométrage en km
`firstRegistrationYear`	Année d'immatriculation
`fuelType`	Type de carburant
`transmissionType`	Transmission
`bodyType`	Type de carrosserie
`conditionType`	État (neuf ou d'occasion)
`horsePower`	Puissance en ch
`bodyColorText`	Couleur extérieure
`doors`	Nombre de portes
`seats`	Nombre de sièges
`driveType`	Type de transmission
`co2Emission`	Émissions de CO₂ en g/km
`consumptionCombined`	Consommation de carburant mixte en l/100 km
`energyLabel`	Étiquette énergétique
`firstRegistrationDate`	Date de première immatriculation (formatée)
`warrantyType`	Type de garantie

Les champs sans valeur pour un véhicule, ou les champs numériques ayant une valeur de zéro, sont omis de la carte de ce véhicule. L'ordre des champs suit la configuration de la zone.

Bouton de favoris de la carte d'archive

Le bouton de favoris apparaît sur les cartes d'archive de véhicules lorsque :

La fonctionnalité de favoris est activée dans les réglages de l'extension (FEATURE_FAVORITES).
L'élément favorite_btn est activé dans la zone Référence du gestionnaire de mise en page → Cartes d'archive.

Le bouton affiche une icône de cœur et bascule l'état de sauvegarde lors du clic.

Notes opérationnelles

Les ID de véhicules sont stockés dans le localStorage du navigateur. Les favoris persistent lors de la navigation entre les pages et survivent aux rechargements de page au sein du même navigateur. Effacer les données du navigateur (cookies et stockage local) supprime tous les favoris sauvegardés.
Les favoris ne sont pas partagés entre différents appareils ou navigateurs. Il n'y a pas de stockage de compte côté serveur pour les favoris.
La page des favoris récupère les données des véhicules depuis le point de terminaison REST POST /wp-json/as24ci/v1/favorites à chaque chargement de page. Le corps de la requête contient un tableau d'ID de publications.
Le point de terminaison REST impose une limite maximale de 50 véhicules par requête. Si plus de 50 véhicules sont stockés dans localStorage, seuls les 50 premiers sont récupérés.
Seuls les véhicules publiés du bon type de publication sont renvoyés par le point de terminaison REST. Les véhicules qui ont été dépubliés ou supprimés depuis qu'ils ont été sauvegardés sont discrètement exclus de la réponse.
L'année d'immatriculation est résolue à l'aide d'une chaîne de priorité : d'abord à partir de la clé méta mappée pour firstRegistrationYear, puis à partir de la clé méta héritée _as24ci_year, et enfin à partir du résolveur de champs de véhicule qui vérifie la table personnalisée et les colonnes de données brutes.
Les dates (date de première immatriculation) sont formatées à l'aide du réglage de format de date du site WordPress.
Les champs numériques tels que la puissance et la consommation de carburant sont omis si leur valeur est nulle ou vide, afin que la carte n'affiche pas « 0 ch » ou « 0.0 l/100 km ».
Le fichier JavaScript des favoris est mis en file d'attente sur les pages d'archive de véhicules, les pages de véhicule unique et les pages contenant le shortcode [as24ci_favorites] ou [as24ci_archive].
Le CSS des favoris et tous les styles en ligne de design configurés sont mis en file d'attente aux côtés du JavaScript.

Dépannage

Le bouton de favoris n'apparaît pas sur les cartes de véhicules.

Vérifiez que la fonctionnalité de favoris est activée dans les réglages de l'extension.
Vérifiez la zone Référence du gestionnaire de mise en page → Cartes d'archive et confirmez que favorite_btn est activé.

La page des favoris affiche « Chargement des favoris… » et ne se met pas à jour.

Vérifiez que l'API REST de WordPress est accessible. De nombreuses extensions de sécurité ou configurations de serveur bloquent l'accès à l'API REST pour les utilisateurs non connectés.
Ouvrez la console de développement du navigateur et recherchez des erreurs JavaScript ou des requêtes réseau ayant échoué.
Confirmez que la page contient le shortcode [as24ci_favorites].

La page des favoris affiche « Impossible de charger les favoris. »

La requête REST vers /wp-json/as24ci/v1/favorites a échoué ou a renvoyé une erreur. Vérifiez que l'API REST fonctionne correctement.
Vérifiez que les réglages des permaliens du site permettent de résoudre les URL de l'API REST.

Les véhicules sauvegardés disparaissent après un redémarrage du navigateur.

Le localStorage persiste après les redémarrages du navigateur dans tous les navigateurs modernes. Si les favoris disparaissent, il se peut que le navigateur soit configuré pour effacer le stockage à la fermeture, ou qu'un mode de navigation privée soit utilisé.

Un véhicule qui a été sauvegardé n'est plus affiché sur la page des favoris.

Le véhicule a peut-être été dépublié ou supprimé de l'administration de WordPress après avoir été sauvegardé. Le point de terminaison REST ne renvoie que les véhicules publiés.

La page des favoris n'affiche qu'une partie des véhicules sauvegardés.

Le point de terminaison REST renvoie un maximum de 50 véhicules. Si plus de 50 véhicules sont sauvegardés dans localStorage, seuls les 50 premiers sont récupérés.