Référence des shortcodes

Ce document est une référence complète pour tous les shortcodes WordPress fournis par l'extension ADP Car Market Hub WordPress.

Quand utiliser ce document

Utilisez ce document lorsque vous devez intégrer le rendu de l'extension sur une page WordPress et que vous souhaitez connaître la syntaxe exacte du shortcode, les attributs pris en charge et le comportement attendu pour chaque shortcode.

Aperçu

L'extension enregistre les shortcodes suivants :

---

[as24ci_archive]

Affiche l'archive complète des véhicules, y compris le formulaire de filtre de recherche, la grille ou la liste de résultats, les onglets d'état, les contrôles de tri, les contrôles par page et la pagination. Produit le même rendu que l'URL d'archive native du type de publication personnalisé (CPT).

Attributs

Tous les attributs sont facultatifs. Si un paramètre GET du même nom est présent dans l'URL, il remplace l'attribut du shortcode.

Exemples

Afficher tous les véhicules :

[as24ci_archive]

Afficher uniquement les SUV diesel triés par prix croissant :

[as24ci_archive fuel="diesel" body="suv" order_by="price" order="asc"]

Afficher les véhicules dans une fourchette de prix avec 12 résultats par page :

[as24ci_archive price_min="10000" price_max="50000" per_page="12"]

Notes

• Les visiteurs peuvent interagir avec le formulaire de filtre après le chargement de la page. Toute sélection de filtre par le visiteur remplace les attributs de pré-filtrage du shortcode via les paramètres GET.
• La pagination utilise le paramètre GET paged ou page.
• Le shortcode utilise l'URL propre de la page comme action du formulaire de filtre. Assurez-vous que la page dispose d'une URL propre et accessible.

---

[as24ci_search_filter]

Affiche uniquement le formulaire de filtre de recherche, sans les résultats de véhicules. Utilisez-le sur une page d'accueil ou une page de destination pour permettre aux visiteurs de définir leurs critères avant d'être redirigés vers la page des résultats.

Attributs

Exemples

Formulaire de filtre qui redirige vers l'archive CPT par défaut :

[as24ci_search_filter]

Formulaire de filtre qui redirige vers une page de résultats personnalisée :

[as24ci_search_filter results_url="/car-inventory/"]

Notes

• Le formulaire de filtre s'affiche avec les mêmes champs et la même configuration du Layout Manager que le filtre de la page d'archive.
• Tous les paramètres GET déjà présents sur la page actuelle sont reflétés dans les valeurs pré-sélectionnées du formulaire de filtre.
• Lorsque des permaliens simples (non réécrits) sont utilisés, l'URL d'archive du CPT peut ne pas être accessible. Dans ce cas, définissez explicitement results_url sur une page contenant le shortcode [as24ci_archive].

---

[as24ci_compare]

Affiche le tableau de comparaison des véhicules. Charge les ID de véhicules à partir du paramètre GET ids (une liste d'ID de publications séparés par des virgules) et affiche chaque véhicule sous forme de colonne dans un tableau comparatif côte à côte.

Attributs

Ce shortcode n'a pas d'attributs configurables. Les ID de véhicules sont transmis via l'URL.

Format d'URL

/compare-page/?ids=123,456,789

Le JavaScript de comparaison construit cette URL automatiquement lorsque le visiteur clique sur le bouton Comparer.

Exemple

[as24ci_compare]

Placez ce shortcode sur une page dédiée « Comparer les véhicules ». Les réglages de l'extension doivent référencer l'ID de cette page comme page de comparaison.

Notes

• Le tableau de comparaison affiche uniquement les véhicules publiés du type de publication personnalisé de l'extension.
• Un maximum de 4 véhicules est affiché, quel que soit le nombre d'ID transmis. Les ID au-delà des 4 premiers sont ignorés silencieusement.
• Si aucun paramètre ids n'est présent ou si tous les ID spécifiés sont invalides, la page affiche « Aucun véhicule sélectionné pour la comparaison. »
• Les champs affichés dans chaque colonne sont configurés dans le Layout Manager → zone Comparer.

---

[as24ci_favorites]

Affiche la liste des favoris enregistrés par le visiteur. La liste est alimentée dynamiquement par JavaScript à l'aide des ID de véhicules stockés dans le localStorage du navigateur. L'extension appelle un point de terminaison REST interne pour récupérer les données de véhicule actuelles pour chaque ID enregistré.

Attributs

Ce shortcode n'a pas d'attributs configurables.

Exemple

[as24ci_favorites]

Placez ce shortcode sur une page dédiée « Mes favoris ».

Notes

• La page nécessite JavaScript pour fonctionner. Sans JavaScript, la liste ne peut pas être alimentée.
• Si aucun véhicule n'est enregistré dans le navigateur du visiteur, la page affiche « Vous n'avez pas encore de favoris enregistrés. »
• L'API REST doit être accessible publiquement. Les extensions de sécurité qui bloquent les points de terminaison REST publics empêcheront le chargement de la liste des favoris.
• Les champs affichés sur chaque carte de favoris sont configurés dans le Layout Manager → zone Favoris.
• Jusqu'à 50 ID de véhicules enregistrés sont récupérés par requête.

---

[as24ci_location_box]

Affiche l'encadré de l'adresse de l'emplacement du concessionnaire pour un véhicule. L'encadré affiche le nom du concessionnaire, le téléphone, l'adresse et éventuellement un bouton « Visiter le site » si une URL de site web est configurée.

L'emplacement est résolu en faisant correspondre le Seller ID AutoScout24 du véhicule avec les emplacements configurés de l'extension.

Attributs

Exemples

Encadré d'emplacement pour un véhicule spécifique :

[as24ci_location_box post_id="456"]

Encadré d'emplacement pour la publication actuelle (lorsqu'il est utilisé dans un modèle de page de véhicule) :

[as24ci_location_box]

Notes

• Renvoie un résultat vide si le véhicule n'a pas de Seller ID, ou si aucun emplacement configuré ne correspond au Seller ID.
• Sur les pages de détails des véhicules, ces informations sont également affichées automatiquement sous le formulaire de contact, de sorte que l'utilisation manuelle du shortcode sur la même page entraînerait un doublon.

---

[as24ci_hours_box]

Affiche l'encadré des heures d'ouverture du concessionnaire pour un véhicule. L'encadré affiche une colonne par catégorie d'heures configurée, chacune contenant des lignes de plages de jours et de plages horaires.

L'emplacement est résolu en faisant correspondre le Seller ID AutoScout24 du véhicule avec les emplacements configurés de l'extension.

Attributs

Exemples

Encadré des heures pour un véhicule spécifique :

[as24ci_hours_box post_id="456"]

Encadré des heures pour la publication actuelle :

[as24ci_hours_box]

Notes

• Renvoie un résultat vide si le véhicule n'a pas de Seller ID, si aucun emplacement correspondant n'est trouvé, ou si l'emplacement correspondant n'a pas d'heures d'ouverture configurées.
• Sur les pages de détails des véhicules, ces informations sont également affichées automatiquement sous le formulaire de contact.

---

Documents connexes

• Archive des véhicules
• Pages de détails des véhicules
• Comparer
• Favoris
• Emplacement et heures d'ouverture