Documentation · Référence de l'administrateur
Référence du mapping
Ce document est une référence pour l'écran Mapping de l'extension ADP Car Market Hub (Car Market Hub → Mapping). Il explique comment les champs entrants d'AutoScout24 sont mappés dans WordPress, ce que vous pouvez personnaliser par champ, et comment exporter ou réinitialiser la configuration.
Quand utiliser ce document
Lisez ceci lorsque vous souhaitez renommer un champ qui apparaît sur le frontend, masquer un champ qui ne doit pas être visible par les visiteurs, ou auditer le mapping entre les champs sources AutoScout24 et les clés méta WordPress utilisées par les modèles de l'extension.
Aperçu
Chaque véhicule importé depuis AutoScout24 est stocké sous forme de publication as24ci_car dans WordPress, avec les champs sources écrits dans des clés post-meta dédiées. L'écran Mapping expose ce mapping sous la forme d'une série de tableaux regroupés. Pour chaque champ, vous pouvez :
- Voir le nom du champ AS24 d'origine et la clé méta WordPress sous-jacente.
- Personnaliser le Libellé que les modèles utilisent pour ce champ.
- Basculer l'état Visible du champ pour le masquer sur le frontend.
Une carte distincte Équipements & fonctionnalités répertorie chaque code d'équipement pris en charge (stocké sous forme de tableau sérialisé dans une seule clé méta) avec les mêmes contrôles de Libellé et de Visibilité. Une carte Exporter & Réinitialiser vous permet de sauvegarder la configuration au format JSON ou CSV, ou de rétablir tous les remplacements aux valeurs par défaut de l'extension.
Configuration requise ou prérequis
- L'autorisation de gérer l'extension (la même habilitation que celle utilisée ailleurs dans Car Market Hub).
- Au moins un véhicule importé, afin que les modifications de libellés et de visibilité soient visibles sur le frontend.
Instructions étape par étape
Personnaliser un libellé de champ ou masquer un champ
- Allez dans Car Market Hub → Mapping.
- Saisissez éventuellement du texte dans Rechercher des champs pour filtrer les lignes de tous les groupes par nom de champ, libellé ou clé méta. À mesure que vous écrivez, la barre de recherche affiche un décompte en direct (N correspondances) des lignes correspondantes.
- Dans le tableau du groupe concerné, modifiez la colonne Libellé pour le champ que vous souhaitez renommer. Les valeurs vides reviennent au libellé traduit par défaut.
- Utilisez le bouton de bascule Visible pour masquer le champ des modèles du frontend.
- Cliquez sur Enregistrer les réglages de mapping en bas de la section. Les modifications s'appliquent immédiatement au prochain chargement de page sur le frontend.
Personnaliser les codes d'équipements / fonctionnalités
- Faites défiler jusqu'à la carte Équipements & fonctionnalités.
- Modifiez la colonne Libellé pour tout code de fonctionnalité que vous souhaitez afficher sous un nom différent.
- Désactivez l'option Visible pour tout code de fonctionnalité qui ne doit pas être affiché.
- Cliquez sur Enregistrer les réglages de mapping.
Exporter le mapping actuel
- Ouvrez la carte Exporter & Réinitialiser.
- Cliquez sur Exporter en JSON ou Exporter en CSV pour télécharger un instantané de la configuration de mapping actuelle, y compris les remplacements de libellés et de visibilité.
Réinitialiser tous les remplacements
- Ouvrez la carte Exporter & Réinitialiser.
- Cliquez sur Réinitialiser aux valeurs par défaut. Tous les libellés personnalisés et les remplacements de visibilité sont supprimés ; chaque champ revient à son libellé par défaut intégré et à son état visible d'origine.
Référence de configuration
Groupes de champs
La carte de champs standard est organisée en groupes logiques suivants (chaque groupe répertorie les champs AS24 qu'il contient et une brève description) :
- Identification & statut — identifiants principaux, références du vendeur, horodatages et indicateurs de statut de l'annonce.
- Base / type de véhicule — marque, modèle, identifiants de version, détails de certification, catégorie de véhicule.
- Carrosserie & dimensions — style de carrosserie, couleur extérieure et intérieure, nombre de sièges, nombre de portes, dimensions physiques y compris les mesures du coffre.
- Moteur & transmission — type de carburant, système de transmission, boîte de vitesses, cylindrée, configuration des cylindres, chiffres de puissance.
- Consommation, émissions & énergie — consommation de carburant et de gaz (urbaine / extra-urbaine / mixte), émissions de CO₂, classe de norme d'émission, étiquette énergétique.
- Électrification & recharge — capacité de la batterie, état de santé, prix de location, autonomie électrique, types de connecteurs de recharge AC/DC, puissances nominales, temps de charge.
- Kilométrage & immatriculation — état du véhicule, date de première immatriculation, lecture du compteur kilométrique, statut de l'inspection.
- Poids, remorquage & charge utile — poids à vide, poids brut du véhicule, capacité de charge utile, limite de remorquage freiné.
- Prix & garantie — prix de vente, prix catalogue du constructeur, détails complets de la garantie (type, durée, couverture kilométrique).
- Description & médias — texte d'accroche de l'annonce, description complète, champs de la galerie d'images.
Contrôles par champ
| Colonne | Notes |
|---|---|
| Champ AS24 | Le nom du champ AutoScout24 d'origine (lecture seule). |
| Libellé | Modifiable. Vide = libellé traduit par défaut. Longueur maximale : 120 caractères. Les lignes avec un remplacement de libellé enregistré affichent un badge personnalisé. |
| Clé méta WordPress | La clé post-meta sous laquelle la valeur est stockée (lecture seule). |
| Visible | Bouton de bascule. Désactivé signifie que les modèles ignorent ce champ même si le véhicule importé contient des données pour celui-ci. |
Exporter & Réinitialiser
| Action | Notes |
|---|---|
| Exporter en JSON | Génère un fichier JSON contenant les remplacements enregistrés. |
| Exporter en CSV | Génère un fichier CSV avec les mêmes données. |
| Réinitialiser aux valeurs par défaut | Supprime l'intégralité de l'option de remplacement ; chaque champ revient à sa valeur par défaut intégrée. |
Notes opérationnelles
- Tous les remplacements sont stockés dans une seule option WordPress, et non dans les métadonnées individuelles des publications. Cela signifie que les modifications s'appliquent instantanément à tous les véhicules importés sans qu'il soit nécessaire de réimporter les données.
- L'enregistrement du formulaire stocke l'état visible de chaque champ connu. Tout ce qui n'est pas présent dans le formulaire est traité comme visible par défaut.
- Les libellés des champs sont prêts pour la traduction. Si votre site est dans une langue autre que l'anglais, la colonne Libellé affiche la valeur par défaut traduite jusqu'à ce que vous définissiez un remplacement.
- L'écran de mapping ne modifie pas la façon dont les données sont importées ; il contrôle uniquement la manière dont les données stockées sont étiquetées et si elles apparaissent sur le frontend. Pour modifier les images ou les données téléchargées, consultez la Référence des importations et des limites.
- Masquer un champ ici affecte également la visibilité du champ configurée par zone dans le Gestionnaire de mise en page, car les deux couches doivent autoriser un champ pour qu'il puisse s'afficher.
Dépannage
- Un changement de libellé n'apparaît pas. Confirmez que vous avez cliqué sur Enregistrer les réglages de mapping dans la même carte et que tout cache frontend ou CDN a été vidé.
- Un champ est toujours masqué après l'avoir activé. Vérifiez le Gestionnaire de mise en page — le bloc ou la zone correspondante doit également inclure ce champ.
- Le téléchargement de l'exportation est vide ou échoue. Assurez-vous qu'aucune autre extension n'intercepte les requêtes
admin-post.phpet que l'utilisateur dispose des droits de gestion. Le chemin CSV utilise le fluxphp://outputde PHP ; certains hébergeurs restrictifs peuvent le bloquer. Vérifiez dans la version actuelle de l'extension avant de publier. - La réinitialisation aux valeurs par défaut n'a rien fait. La réinitialisation supprime uniquement les remplacements. Si les libellés apparaissent toujours personnalisés, vous avez peut-être un fichier de traduction actif qui remplace le libellé par défaut.
- Les modifications de libellés d'équipements ne s'affichent pas sur un véhicule. Ce véhicule a peut-être été importé avant que le champ d'équipement ne soit renseigné, ou le code de fonctionnalité est masqué dans Équipements & fonctionnalités. Vérifiez à nouveau le bouton de bascule Visible et réimportez le véhicule si nécessaire (voir la Référence de l'importateur de véhicules).