Documentation · Référence de l'administrateur
Référence des shortcodes et des widgets
Ce document est une référence pour l'écran Shortcodes & Widgets de l'extension ADP Car Market Hub (Car Market Hub → Shortcodes & Widgets). Il documente chaque shortcode enregistré par l'extension, les attributs et paramètres d'URL pris en charge, les intégrations avec les éditeurs et constructeurs de pages, ainsi que les widgets de tableau de bord fournis avec l'extension.
Quand utiliser ce document
Lisez ceci si vous êtes un éditeur, un concepteur de site ou un développeur et que vous devez :
- Intégrer des listes de véhicules, des formulaires de recherche, des tableaux de comparaison, des favoris, des encadrés de localisation ou des horaires d'ouverture sur une page.
- Pré-filtrer l'inventaire au moment de l'insertion à l'aide des attributs de shortcode.
- Envoyer du trafic pré-filtré vers la page d'inventaire à l'aide de paramètres d'URL.
- Surcharger un modèle de l'extension dans votre thème actif.
- Comprendre quels widgets de tableau de bord l'extension fournit.
Aperçu
L'extension enregistre six shortcodes publics :
| Shortcode | Objectif |
|---|---|
[as24ci_archive] | Inventaire complet des véhicules avec filtres, tri et pagination. |
[as24ci_search_filter] | Formulaire de recherche autonome, destiné aux pages d'atterrissage ou d'accueil. |
[as24ci_compare] | Tableau de comparaison de véhicules pour les véhicules sélectionnés par le visiteur. |
[as24ci_favorites] | Page des favoris du visiteur (les entrées sont stockées côté client dans localStorage). |
[as24ci_location_box] | Carte de contact pour la succursale du concessionnaire liée à un véhicule. |
[as24ci_hours_box] | Carte des horaires d'ouverture pour la succursale du concessionnaire liée à un véhicule. |
Chaque shortcode est également répertorié sur l'écran sous forme d'entrée propre avec un bouton Copier dédié et une section extensible Attributs & exemples qui présente les attributs pris en charge et des exemples prêts à l'emploi pour ce shortcode.
En haut de l'écran, cinq tuiles d'indicateurs clés de performance (KPI) résument en un coup d'œil l'utilisation des shortcodes :
| Tuile KPI | Affiche |
|---|---|
| Shortcodes disponibles | Le nombre de shortcodes publics enregistrés par l'extension. |
| Shortcodes utilisés | Le nombre total d'occurrences de shortcodes trouvées sur les pages et articles analysés. |
| Intégrations de constructeurs | Le nombre de familles d'intégrations d'éditeurs / constructeurs de pages prises en charge et disponibles. |
| Pages utilisant l'extension | Le nombre de pages et d'articles publiés qui contiennent au moins un shortcode de l'extension. |
| Surcharges de modèles | Le nombre de modèles de l'extension actuellement surchargés par votre thème actif. |
Sous les tuiles, une carte d'introduction propose des boutons de copie rapide en un clic pour les quatre shortcodes les plus utilisés — [as24ci_archive], [as24ci_search_filter], [as24ci_compare] et [as24ci_favorites] — afin que vous puissiez les copier dans le presse-papiers sans avoir à les saisir.
L'écran affiche également un tableau d'Aperçu de l'utilisation des shortcodes qui liste les pages et articles publiés contenant un shortcode de l'extension (jusqu'aux 100 résultats les plus récents), ainsi qu'une carte de Notes de développement documentant les surcharges de modèles et les paramètres d'URL pris en charge.
Exigences ou prérequis
- Un utilisateur disposant d'un rôle lui permettant de modifier des pages ou des articles.
- Pour
[as24ci_compare]et[as24ci_favorites], l'option correspondante doit être activée dansCar Market Hub → Settings. Lorsqu'une fonctionnalité est désactivée, l'écran marque le shortcode avec un badge Désactivé. - Pour
[as24ci_location_box]et[as24ci_hours_box], au moins un emplacement doit être configuré dans Locations et les Seller IDs doivent correspondre au véhicule.
Instructions étape par étape
Intégrer un shortcode dans une page
- Ouvrez la page ou l'article dans votre éditeur.
- Insérez le shortcode à l'aide du contrôle natif de l'éditeur : - Éditeur de blocs (Gutenberg) : ajoutez un bloc Shortcode. - Elementor : ajoutez un widget Shortcode. - Divi, Beaver Builder, WPBakery : utilisez le module shortcode ou texte. - Éditeur classique : saisissez directement le shortcode dans le contenu.
- Collez le shortcode souhaité (avec des attributs si nécessaire).
- Enregistrez et prévisualisez.
L'extension charge ses propres styles et scripts uniquement sur les pages qui contiennent un shortcode de l'extension, de sorte que les pages non concernées ne sont pas affectées.
Pré-filtrer l'archive au moment de l'insertion
Utilisez des attributs de shortcode sur [as24ci_archive], par exemple :
[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]
[as24ci_archive fuel="electric" body="suv" per_page="12"]Piloter le filtrage dynamique depuis des liens ou des formulaires externes
Ajoutez des paramètres GET à l'URL de l'archive (les paramètres d'URL surchargent les attributs de shortcode) :
/inventory/?make=BMW&max_price=20000
/inventory/?condition=new&sort=price_ascRéférence de configuration
Attributs de [as24ci_archive]
Tous les attributs sont facultatifs. Les paramètres d'URL surchargent les attributs de shortcode.
| Attribut | Description | Exemple |
|---|---|---|
make | Pré-filtrer par marque. | make="BMW" |
model | Pré-filtrer par modèle (à utiliser avec make). | model="3 Series" |
price_min | Prix minimum (numérique). | price_min="10000" |
price_max | Prix maximum (numérique). | price_max="40000" |
fuel | Type de carburant, par exemple petrol, diesel, electric. | fuel="electric" |
body | Type de carrosserie, par exemple suv, sedan, coupe. | body="suv" |
order_by | Champ de tri : price, mileage, ou date (par défaut). | order_by="price" |
order | Direction du tri : asc (par défaut) ou desc. | order="asc" |
per_page | Éléments par page : 12, 24 (par défaut), 48, 72, all. | per_page="12" |
Attributs de [as24ci_search_filter]
| Attribut | Description | Exemple |
|---|---|---|
results_url | URL de la page de résultats. Par défaut, l'URL de l'archive des véhicules de l'extension. | results_url="/inventory/" |
[as24ci_compare]
Aucun attribut. À placer sur une page de comparaison dédiée. L'écran des réglages peut créer cette page automatiquement.
[as24ci_favorites]
Aucun attribut. À placer sur une page dédiée aux favoris ou à la liste d'envies. Les favoris sont stockés dans le navigateur du visiteur via localStorage — aucun compte n'est requis et aucune donnée n'est envoyée au serveur.
Attributs de [as24ci_location_box] et [as24ci_hours_box]
| Attribut | Description | Exemple |
|---|---|---|
post_id | ID de l'article de véhicule. Par défaut, l'article actuel dans la boucle. | post_id="123" |
La succursale liée au véhicule est résolue par le Seller ID AutoScout24. Si aucune correspondance n'est trouvée, le premier emplacement (par défaut) de Locations est utilisé.
Paramètres d'URL pris en charge
Ces paramètres peuvent être ajoutés à l'URL de l'archive. Les paramètres d'URL surchargent les attributs de shortcode.
| Paramètre | Description | Exemple |
|---|---|---|
make | Filtrer par marque. | ?make=BMW |
model | Filtrer par modèle (nécessite make). | ?model=3+Series |
min_price / max_price | Filtrer par plage de prix. | ?min_price=5000&max_price=20000 |
mileage_max | Kilométrage maximum. | ?mileage_max=80000 |
condition | all, new, ou used. | ?condition=new |
sort | price_asc, price_desc, mileage_asc, mileage_desc. | ?sort=price_asc |
per_page | Éléments par page (12, 24, 48, 72, all). | ?per_page=12 |
q | Recherche par mot-clé. | ?q=diesel |
Prise en charge des constructeurs et éditeurs
Contrôles de shortcode natifs dans l'Éditeur de blocs (Gutenberg), Elementor, Divi / Beaver Builder / WPBakery, et l'Éditeur classique. Le bandeau KPI sur l'écran indique quatre familles d'intégrations prises en charge.
Widgets du tableau de bord
L'extension ajoute les widgets suivants au tableau de bord standard de WordPress :
| Widget | Contenu |
|---|---|
| CMH – Company Overview | Nombre de véhicules, calendrier d'importation, totaux des leads et valeur du portefeuille. |
| CMH – AI and SEO Monitor | File d'attente des textes IA, file d'attente du SEO des images et état de la connexion API. |
| CMH – Current Leads | Activité récente des leads entrants pour vos véhicules. |
| CMH – Car Performance | Véhicules les plus consultés et engagement en un coup d'œil. |
| CMH – Price Information | Aperçu des données de tarification pour votre inventaire. |
Tableau d'aperçu de l'utilisation des shortcodes
Le tableau d'aperçu de l'utilisation liste chaque page ou article publié contenant un shortcode de l'extension, avec les colonnes suivantes :
| Colonne | Affiche |
|---|---|
| Titre du contenu | Titre de la page ou de l'article. |
| Type de contenu | Indique s'il s'agit d'une page ou d'un article. |
| Shortcodes utilisés | Le ou les shortcodes de l'extension que contient le contenu. |
| Nombre | Le nombre d'occurrences de shortcodes de l'extension dans ce contenu. |
| Dernière mise à jour | Date de la dernière modification de la page ou de l'article. |
| Actions | Un lien Modifier qui ouvre la page ou l'article dans l'éditeur. |
Surcharges de modèles
Le rendu des shortcodes utilise les mêmes modèles que le CPT de véhicule natif. Pour surcharger un modèle, copiez le fichier à la racine de votre thème actif ; WordPress chargera automatiquement votre version.
| Modèle | Utilisé pour |
|---|---|
archive-as24ci_car.php | Rendu de l'archive des véhicules et de la liste des shortcodes. |
single-as24ci_car.php | Page de détail d'un véhicule individuel. |
page-as24ci_compare.php | Page de comparaison de véhicules. |
Notes opérationnelles
- L'Aperçu de l'utilisation des shortcodes analyse jusqu'aux 100 pages et articles publiés les plus récemment modifiés qui contiennent un shortcode de l'extension. Les types de publication personnalisés (CPT) ne sont pas inclus par défaut.
- La tuile KPI Shortcodes utilisés comptabilise le nombre total d'occurrences sur cette même analyse.
- La tuile KPI Surcharges de modèles compte les modèles de l'extension actuellement surchargés par votre thème actif.
- Désactiver la comparaison ou les favoris dans les Settings ne supprime pas le shortcode de votre contenu ; cela le marque simplement comme désactivé dans cette référence et peut masquer son affichage sur le site public. Réactivez la fonctionnalité pour rendre à nouveau le shortcode actif.
Dépannage
- Un shortcode s'affiche en texte brut. WordPress n'a pas exécuté l'analyse du shortcode sur ce champ. Placez le shortcode dans le contenu principal de la page ou de l'article, dans un bloc Shortcode, ou dans un module de constructeur prenant en charge les shortcodes.
- L'archive affiche tout malgré un attribut. Un paramètre d'URL surcharge les attributs de shortcode. Supprimez le paramètre d'URL ou alignez-le avec le filtre souhaité.
[as24ci_compare]ou[as24ci_favorites]apparaît vide. Vérifiez que la fonctionnalité correspondante est activée dans les Settings. L'écran affiche également un badge Désactivé dans ce cas.- L'emplacement et les horaires se rabattent sur la succursale par défaut. Le Seller ID du véhicule n'est attribué à aucun emplacement ; ajoutez-le dans Locations.
- Une surcharge de thème n'est pas prise en compte. Le fichier doit se trouver à la racine du répertoire du thème actif (ou enfant) et doit utiliser le nom de fichier exact indiqué ci-dessus.