Pages de détails des véhicules

Ce document couvre la page de détails du véhicule de l'extension ADP Car Market Hub WordPress : sa structure de contenu, sa galerie, ses spécifications, l'affichage des prix, les actions de contact et le comportement du modèle.

Quand utiliser ce document

Lisez ce document si vous avez besoin de comprendre ce qui est affiché sur la page d'un seul véhicule, comment la mise en page est configurée, comment les visiteurs interagissent avec le formulaire de contact ou comment le modèle peut être personnalisé par un développeur de thème.

Aperçu

Chaque véhicule publié possède sa propre page de détails. La page présente le véhicule au visiteur dans une mise en page structurée avec une galerie, des spécifications clés, des données techniques, une liste d'équipements, les tarifs, un formulaire de contact et des fonctionnalités optionnelles telles qu'un simulateur de financement, le téléchargement de PDF datasheet, le partage sur les réseaux sociaux et les demandes d'essai routier.

La page de détails du véhicule est générée par le modèle intégré de l'extension (single-as24ci_car-classic.php). La mise en page est divisée en trois zones configurables gérées via le Layout Manager :

• Contenu principal (colonne de gauche) : galerie, description, spécifications, données énergétiques, équipements et blocs supplémentaires optionnels.
• Barre latérale (colonne de droite) : encadré de prix, faits marquants et simulateur de financement.
• Section inférieure : formulaire de contact, informations sur le concessionnaire et véhicules similaires.

Le thème actif peut surcharger le modèle en plaçant un fichier single-as24ci_car.php dans le répertoire du thème. L'extension vérifie la présence de cette surcharge avant de charger son propre modèle.

Configuration requise ou prérequis

• L'extension doit être installée et activée.
• Au moins un véhicule doit avoir été importé et publié.
• Les permaliens personnalisés doivent être activés dans WordPress (Réglages → Permaliens) pour que le format d'URL par défaut d'un seul véhicule fonctionne. Sans permaliens personnalisés, les pages de détails des véhicules individuels peuvent ne pas être accessibles via la structure d'URL attendue.

Instructions étape par étape

Naviguer vers une page de détails de véhicule

1. Depuis l'archive des véhicules, cliquez sur n'importe quelle carte de véhicule. Le lien mène à la page de détails de ce véhicule.
2. Alternativement, allez dans l'administration de WordPress, ouvrez Véhicules, puis cliquez sur Afficher sous le titre d'un véhicule pour ouvrir sa page de détails côté public.

Configurer la mise en page d'un véhicule individuel

1. Dans l'administration de l'extension, ouvrez le Layout Manager.
2. Sélectionnez la zone Single Vehicle – Main Content, Single Vehicle – Sidebar ou Single Vehicle – Bottom.
3. Glissez-déposez les blocs pour les réorganiser, ou basculez leur visibilité.
4. Enregistrez la configuration.

Les modifications s'appliquent immédiatement à toutes les pages de détails des véhicules sans nécessiter de réimportation.

---

Référence de configuration

Zones de mise en page et blocs disponibles

Les blocs suivants sont disponibles dans chaque zone. La configuration par défaut est présentée sous chaque zone ; le Layout Manager permet de modifier l'ordre ou de désactiver des blocs individuels.

Véhicule unique – Contenu principal (ordre par défaut) :

1. gallery – Galerie d'images
2. description – Texte de description du véhicule
3. specs – Tableau des spécifications techniques
4. energy – Données sur l'énergie et les émissions
5. equipment – Listes des équipements de série et en option
6. warranty – Informations sur la garantie

Véhicule unique – Barre latérale (ordre par défaut) :

1. price_box – Affichage du prix avec prix catalogue et badge d'économie
2. key_facts – Grille des caractéristiques clés (marque, modèle, kilométrage, année, type de carburant, etc.)
3. financing_calc – Calculateur de financement (si activé)

Véhicule unique – Bas (ordre par défaut) :

1. contact_form – Formulaire de contact pour demande d'information avec informations sur le vendeur
2. dealer_info – Carte d'informations sur le concessionnaire (autonome)
3. similar_vehicles – Véhicules similaires de la même marque et du même modèle

Des blocs supplémentaires issus de ces listes peuvent être placés dans d'autres zones si le Layout Manager le permet, à l'exception du calculateur de financement qui s'affiche dans une zone au maximum (la barre latérale est prioritaire sur le contenu principal, le contenu principal est prioritaire sur le bas).

Galerie

La galerie affiche toutes les images associées au véhicule. Les images sont assemblées à partir de deux sources : les images importées (_as24ci_image_ids) et les images téléchargées manuellement (_as24ci_manual_image_ids). Les images téléchargées manuellement apparaissent en premier.

Options d'affichage de la galerie :

Si aucune image n'est disponible, la section de la galerie n'affiche pas d'image de remplacement par défaut pour l'image principale.

Affichage du prix

L'encadré du prix dans la barre latérale affiche :

• Prix de vente : le prix du véhicule importé ou défini manuellement, formaté avec la devise configurée.
• Prix catalogue (si disponible et supérieur au prix de vente) : affiché barré, avec la différence d'économie calculée automatiquement.
• Devise : utilise le champ de devise propre au véhicule, ou se rabat sur la devise par défaut configurée dans les réglages de l'extension.

Barre latérale des caractéristiques clés

Le bloc des caractéristiques clés affiche une grille de spécifications importantes. Les champs visibles et leur ordre sont contrôlés par la configuration du bloc Field Registry → Key Facts. Les champs suivants sont pris en charge :

Les champs qui n'ont pas de valeur pour le véhicule actuel sont automatiquement masqués.

Spécifications techniques

Le bloc specs dans la zone de contenu principal affiche une liste détaillée de champs techniques. Les champs affichés dépendent des données du véhicule et de ce qui a été importé. Les unités sont appliquées automatiquement :

• Kilométrage : km
• Puissance du moteur : CH / kW
• Cylindrée du moteur : cm³
• Émissions de CO₂ : g/km
• Consommation de carburant : l/100 km (urbain, extra-urbain, mixte) ou kg/100 km pour le GNC
• Consommation d'énergie électrique : kWh/100 km
• Capacité de la batterie : kWh
• Autonomie : km
• Poids : kg
• Dimensions (hauteur, largeur, longueur, empattement) : mm
• Volume du coffre : l
• Puissance de charge : kW
• Temps de charge : min

Les valeurs sont lues à partir de la table de base de données personnalisée des véhicules de l'extension lorsqu'elle est disponible, avec un repli sur les métadonnées de l'article (post meta) pour les véhicules importés avant la structure de table actuelle.

Équipement

Le bloc equipment génère deux listes :

• Équipement de série : fonctionnalités incluses de série.
• Équipement en option : fonctionnalités disponibles en option.

Les deux listes sont importées depuis la source de données du véhicule et stockées dans la table personnalisée des véhicules. Les listes d'équipements ne sont affichées que lorsqu'elles contiennent au moins un élément.

Fil d'Ariane

La page de détails du véhicule comprend un fil d'Ariane : Accueil → Voitures → Marque → Modèle. Les liens de Marque et de Modèle pré-filtrent l'archive par cette marque ou ce modèle. Le lien "Voitures" pointe vers la page d'archive configurée.

Partage social

Si la fonctionnalité de partage social est activée, des boutons de partage sont affichés sur la page de détails. Les réseaux pris en charge sont WhatsApp, Facebook, Instagram, X (anciennement Twitter), Email et Copier le lien (l'ensemble visible est configurable). L'emplacement est configurable — Sous la galerie, Barre latérale droite collante ou Fin de page :

• Sous la galerie et Fin de page affichent une rangée horizontale de boutons (sous la galerie, ou en bas de la page sous la section de contact) et sont visibles sur toutes les tailles d'écran.
• Barre latérale droite collante est une barre fixe sur le bord droit de l'écran qui contient également les boutons rapides Favoris, Comparer et PDF datasheet (lorsque ces fonctionnalités sont activées). Elle est masquée sur les écrans de taille téléphone (≤ 600 px), donc sur les téléphones, utilisez Sous la galerie ou Fin de page pour maintenir le partage visible.

L'emplacement et les réseaux visibles sont configurés sous Design & Styles → Social sharing buttons ; voir la Référence du design et des styles.

Formulaire de contact

Le formulaire de contact permet aux visiteurs d'envoyer une demande d'information sur le véhicule. Le formulaire est soumis via une requête HTML POST standard.

Champs du formulaire de contact :

La case à cocher de consentement à la confidentialité affiche un texte de consentement configurable. Si une URL de politique de confidentialité est configurée dans les réglages de l'extension, le texte "politique de confidentialité" au sein du texte de consentement est automatiquement converti en lien.

Les messages de succès et d'erreur après la soumission du formulaire sont configurables dans les réglages de l'extension.

Demande d'essai routier

Si la fonctionnalité d'essai routier est activée, le formulaire de contact comprend une case à cocher facultative "Intéressé par un essai routier ?". Lorsqu'elle est cochée, des champs de date et d'heure apparaissent et permettent au visiteur de demander un créneau d'essai routier spécifique. Vérifiez la configuration de l'essai routier dans les réglages de votre extension avant de publier cette fonctionnalité.

Informations sur le vendeur / concessionnaire

La section du formulaire de contact comprend un panneau d'information sur le vendeur affichant :

• Nom du vendeur
• Intitulé du poste
• Adresse
• Adresse e-mail (sous forme de lien mailto: cliquable)
• Numéro de téléphone (sous forme de lien tel: cliquable)
• Photo de profil
• Liens vers les profils sociaux (Facebook, Instagram, X, LinkedIn)

Le contact affiché dans ce panneau est résolu par le routage des contacts de CMH Team. L'extension recherche d'abord un contact CMH Team pour le véhicule — une attribution par véhicule, le contact par défaut pour la succursale du véhicule, ou le contact par défaut global — et se rabat sur le contact général de la concession lorsque cela est configuré. Un membre de l'équipe défini sur "aucun contact visible" masque le panneau, et un membre inactif n'est jamais affiché. Ce n'est que lorsque CMH Team ne s'applique pas que le panneau se rabat sur le profil de vendeur hérité (les métadonnées utilisateur WordPress déterminées par le champ de métadonnées de l'article _as24ci_seller_user_id, ou l'auteur de l'article). Voir CMH Team et routage des contacts.

Boutons de favoris et de comparaison

Lorsque l'emplacement Barre latérale droite collante du partage social est sélectionné, la barre fixe sur le bord droit de la page de détails comprend également :

• Bouton Favoris (icône de cœur) : ajoute ou supprime le véhicule des favoris enregistrés du visiteur. Affiché lorsque la fonctionnalité de favoris est activée.
• Bouton Comparer : ajoute ou supprime le véhicule de la sélection de comparaison. Affiché lorsque la fonctionnalité de comparaison est activée.
• Bouton PDF datasheet : affiché lorsque la fonctionnalité de PDF datasheet est activée.

Cette barre latérale droite est masquée sur les écrans de taille téléphone (≤ 600 px). Avec les autres emplacements de partage (Sous la galerie / Fin de page), ces boutons rapides ne sont pas regroupés dans une barre latérale. Indépendamment de l'emplacement, la fonctionnalité de comparaison affiche sa propre barre de comparaison flottante une fois que le visiteur a sélectionné des véhicules à comparer.

Véhicules similaires

Le bloc similar_vehicles affiche jusqu'à quatre autres véhicules publiés de la même marque et du même modèle. Chaque carte affiche la miniature, le titre, le prix, le type de carburant, la transmission, l'année et le kilométrage. Un lien "Afficher tous les véhicules" renvoie le visiteur vers l'archive complète.

PDF datasheet

Si la fonctionnalité de PDF datasheet est activée, un bouton de téléchargement est disponible sur la page de détails. Vérifiez que cette fonctionnalité est activée et configurée dans les réglages de votre extension avant de la publier.

Notes opérationnelles

• Le modèle de véhicule unique est chargé via le filtre single_template de WordPress. L'extension vérifie s'il existe une surcharge de thème (single-as24ci_car.php dans le thème actif) avant de charger son propre modèle. Si les deux existent, le fichier du thème est prioritaire.
• Les données du véhicule sont lues à partir de la table de base de données personnalisée {prefix}as24_vehicles de l'extension lorsqu'elle est disponible. Pour les véhicules importés avant l'existence de cette table, les données se rabattent sur les champs de métadonnées d'article WordPress.
• La galerie combine les images téléchargées manuellement et les images importées, les images téléchargées manuellement apparaissant toujours en premier.
• Le calculateur de financement s'affiche dans une zone au maximum. S'il est placé à la fois dans la barre latérale et dans le contenu principal, seule l'instance de la barre latérale s'affiche.
• Le crochet d'action as24ci_after_contact_form se déclenche après la section du formulaire de contact, permettant aux intégrations d'injecter du contenu supplémentaire.

Dépannage

La page de détails du véhicule affiche une erreur 404.

• Vérifiez que les permaliens personnalisés sont activés (Réglages → Permaliens dans l'administration de WordPress). Après avoir modifié les réglages des permaliens, enregistrez-les une fois pour vider les règles de réécriture.
• Confirmez que le véhicule est publié et qu'il n'est pas à l'état de brouillon ou privé.

La galerie n'affiche pas d'images.

• Vérifiez que les images ont été importées correctement. Dans l'administration, ouvrez la page de modification du véhicule et vérifiez que les images de la galerie sont associées.
• Si les images ont été téléchargées manuellement, confirmez qu'elles sont enregistrées sous le champ des identifiants d'images manuelles.

Aucun prix ne s'affiche.

• L'encadré du prix n'affiche un prix que si le véhicule a une valeur de prix supérieure à zéro. Vérifiez les données du véhicule importé.

Le formulaire de contact n'envoie pas de messages.

• Vérifiez que votre site WordPress peut envoyer des e-mails. De nombreux environnements d'hébergement nécessitent une extension SMTP ou une configuration de messagerie supplémentaire.
• Vérifiez la configuration des leads de l'extension pour détecter d'éventuels champs obligatoires ou restrictions.

Le calculateur de financement n'apparaît pas.

• Confirmez que la fonctionnalité de financement est activée dans les réglages de l'extension (elle est désactivée par défaut).
• Confirmez qu'elle est active dans la zone du Layout Manager pour la page de véhicule unique.

Les caractéristiques clés affichent des valeurs nulles ou vides.

• Certains champs dépendent de la table personnalisée des véhicules. Si un véhicule a été importé avant la création de la table, réimporter le véhicule peut résoudre les valeurs manquantes.

---

Documents connexes

• Archive des véhicules
• Comparer
• Favoris
• Calculateur de financement
• PDF datasheet
• Demandes d'essai routier