Emplacement et horaires d'ouverture

Cette section documente la fonctionnalité d'emplacement et d'horaires d'ouverture de l'extension ADP Car Market Hub WordPress : comment les emplacements des concessionnaires sont affichés sur les pages de détails des véhicules, comment les shortcodes peuvent intégrer les données d'emplacement ailleurs, et comment cette fonctionnalité est configurée.

Quand utiliser ce document

Lisez ce document si vous configurez des emplacements pour la première fois, si vous ajoutez des horaires d'ouverture à la page de détails du véhicule, ou si vous utilisez les shortcodes d'emplacement et d'horaires sur d'autres pages.

Aperçu

L'extension comprend une fonctionnalité d'emplacements (Locations) qui stocke les données d'emplacement du concessionnaire ou de la succursale (adresse, téléphone, emplacement Google Maps et horaires d'ouverture) associées à un ou plusieurs Seller ID d'AutoScout24. Lorsqu'un Seller ID de véhicule correspond à un emplacement configuré, l'extension affiche automatiquement l'encadré d'adresse de l'emplacement et l'encadré des horaires d'ouverture correspondants après le formulaire de contact sur la page de détails du véhicule.

Ces mêmes informations peuvent également être affichées sur n'importe quelle page WordPress à l'aide de shortcodes dédiés.

Configuration requise ou prérequis

• Au moins un emplacement doit être configuré dans l'administration de l'extension (réglages de l'extension → onglet Locations).
• Chaque emplacement doit être associé à au moins un Seller ID qui correspond à la valeur de méta de publication _as24ci_seller_id stockée sur les publications de véhicules.
• Pour que l'emplacement et les horaires apparaissent automatiquement sur les pages de détails des véhicules, l'extension doit être active et le Seller ID du véhicule doit être défini.

Instructions étape par étape

Configurer un emplacement

1. Dans l'administration de WordPress, ouvrez les réglages de l'extension et accédez à l'onglet Locations.
2. Cliquez sur Add Location ou modifiez un emplacement existant.
3. Renseignez les détails de l'emplacement : - Name : Le nom du concessionnaire ou de la succursale. - Street : L'adresse (rue). - ZIP code : Le code postal. - City : La ville. - Phone : Le numéro de téléphone de contact. - Google Maps Location : URL Google Maps facultative pour un bouton « Calculer l'itinéraire ». Générée automatiquement à partir du nom et de l'adresse de l'emplacement si elle est vide. Vous pouvez également coller une URL Google Maps personnalisée. - Seller IDs : Un ou plusieurs Seller ID d'AutoScout24 associés à cet emplacement. - Opening hours : Une ou plusieurs catégories, chacune contenant des lignes de paires de plages de jours et de plages horaires.
4. Enregistrez l'emplacement.

Une fois enregistré, l'adresse et les horaires de l'emplacement apparaîtront automatiquement sur la page de détails de tout véhicule dont le Seller ID correspond à l'un des Seller ID configurés pour cet emplacement.

Intégrer des informations d'emplacement sur n'importe quelle page à l'aide de shortcodes

1. Ouvrez la page ou la publication WordPress sur laquelle vous souhaitez afficher les informations d'emplacement.
2. Ajoutez l'un des shortcodes suivants dans l'éditeur de contenu :

• Encadré d'emplacement (adresse, téléphone, bouton de calcul d'itinéraire) :

  [as24ci_location_box post_id="123"]

• Encadré des horaires d'ouverture :

  [as24ci_hours_box post_id="123"]

Remplacez 123 par l'ID de publication WordPress du véhicule dont vous souhaitez afficher l'emplacement associé.

1. Si vous omettez l'attribut post_id, le shortcode utilise l'ID de la publication actuelle dans la boucle. Cela est utile pour placer le shortcode à l'intérieur d'un modèle de publication de véhicule.

Référence de configuration

Champs d'emplacement

Chaque emplacement est stocké sous forme d'entrée dans l'option d'emplacements de l'extension (as24ci_locations). Les champs suivants sont pris en charge :

Structure des horaires d'ouverture

Les horaires d'ouverture sont organisés sous forme de liste de catégories. Chaque catégorie possède un libellé et une ou plusieurs lignes :

Exemple de structure pour une seule catégorie :

Category: Sales
  Row 1: Mon–Fri / 08:00–18:00
  Row 2: Sat / 09:00–16:00

Les champs days et time sont tous deux des chaînes de texte libre. L'extension ne valide pas et n'analyse pas leur contenu.

Shortcodes

Les deux shortcodes acceptent un attribut post_id. S'il est omis, l'ID de la publication actuelle dans la boucle est utilisé. Si aucun emplacement correspondant n'est trouvé pour le Seller ID du véhicule, le shortcode renvoie un résultat vide.

Notes opérationnelles

• La recherche d'emplacement est effectuée en faisant correspondre la valeur de méta de publication _as24ci_seller_id du véhicule avec le tableau seller_ids de chaque emplacement configuré. Le premier emplacement correspondant est utilisé.
• Les encadrés d'emplacement et d'horaires sont générés après la section du formulaire de contact via le hook d'action as24ci_after_contact_form. Les deux encadrés sont enveloppés dans un div conteneur (as24ci-location-hours-wrapper). Si aucun des deux n'a de contenu, rien n'est affiché.
• L'encadré des horaires d'ouverture n'est généré que lorsque l'emplacement correspondant possède au moins une catégorie d'horaires non vide.
• Les données d'emplacement sont stockées sous forme de tableau sérialisé dans la table des options de WordPress avec le chargement automatique (autoload) désactivé. Elles ne sont chargées que sur les pages de détails des véhicules et dans l'administration de l'extension, et non à chaque requête de page.
• L'encadré d'emplacement comprend un bouton « Calculer l'itinéraire » chaque fois qu'une URL Google Maps est disponible — soit parce que le champ url est renseigné, soit parce qu'elle peut être générée automatiquement à partir du nom et de l'adresse de l'emplacement. Aucun appel d'API externe n'est effectué ; l'URL générée automatiquement utilise le format simple https://www.google.com/maps/search/?api=1&query=….
• Si un véhicule n'a pas de valeur de méta _as24ci_seller_id, ni l'encadré d'emplacement ni l'encadré des horaires ne sont affichés.

Dépannage

L'encadré d'emplacement n'apparaît pas sur la page de détails d'un véhicule.

• Vérifiez que le véhicule possède une valeur de méta _as24ci_seller_id. Celle-ci est définie lors de l'importation. Ouvrez le véhicule dans l'administration de WordPress et vérifiez les champs de méta du véhicule.
• Confirmez qu'un emplacement est configuré dans les réglages de l'extension avec un Seller ID correspondant.
• Vérifiez que le formulaire de contact est visible sur la page. Les encadrés d'emplacement et d'horaires sont générés après la section du formulaire de contact via un hook sur as24ci_after_contact_form. Si le bloc du formulaire de contact est désactivé dans le Layout Manager, le hook peut ne pas se déclencher.

L'encadré des horaires d'ouverture n'apparaît pas alors qu'un emplacement est configuré.

• Confirmez que l'emplacement possède au moins une catégorie d'horaires d'ouverture avec au moins une ligne.
• Si la catégorie et les lignes sont présentes mais que l'encadré n'apparaît toujours pas, vérifiez que les données sont correctement enregistrées dans l'onglet d'administration Locations.

Le shortcode renvoie un résultat vide.

• Vérifiez que l'attribut post_id pointe vers un véhicule publié avec un _as24ci_seller_id valide.
• Confirmez qu'il existe un emplacement dans les réglages de l'extension avec un Seller ID correspondant.
• Le shortcode renvoie un résultat vide lorsqu'aucun emplacement correspondant n'est trouvé ou lorsque le véhicule n'a pas de Seller ID. C'est le comportement attendu.

Le bouton « Calculer l'itinéraire » n'apparaît pas.

• Le bouton s'affiche chaque fois que l'emplacement dispose d'une URL Google Maps ou de suffisamment de données d'adresse (nom, rue, code postal, ville) pour en générer une automatiquement. Si aucune de ces informations n'est disponible, renseignez le champ Google Maps Location ou les champs d'adresse dans l'onglet d'administration Locations.

Documents connexes

• Pages de détails des véhicules
• Référence des shortcodes