Documentation · Annexes

Référence des shortcodes

Cette annexe est une référence rapide pour les shortcodes enregistrés par l'extension ADP Car Market Hub.

Quand utiliser ce document

Utilisez cette référence lorsque vous devez rechercher un nom de shortcode, ses attributs pris en charge ou un exemple à copier-coller. Pour l'explication conceptuelle des shortcodes (quand utiliser lequel, comment ils interagissent avec les modèles), consultez Shortcodes dans la documentation technique et la Référence des shortcodes dans le guide du frontend.

Aperçu

Tous les shortcodes sont enregistrés par le bootstrap principal de l'extension et sont disponibles sur chaque page ou article WordPress (sous réserve de l'éditeur actif et des restrictions au niveau des blocs). Ils renvoient des chaînes de caractères plutôt que de faire un écho (echo), de sorte qu'ils peuvent être intégrés dans des légendes, des cellules de tableau ou des compositions de blocs.

Shortcode	Rendu	Notes
`[as24ci_archive]`	L'archive des véhicules (filtrable, triable, paginée).	Les paramètres d'URL surchargent les attributs du shortcode.
`[as24ci_search_filter]`	Le formulaire de filtre de recherche autonome, sans résultats.	Soumet à une URL de résultats de votre choix.
`[as24ci_compare]`	La page de comparaison de véhicules.	Véhicules sélectionnés via le paramètre d'URL `ids`.
`[as24ci_favorites]`	La page des favoris du visiteur.	S'alimente à partir de l'assistant REST des favoris ; les favoris sont stockés côté client.
`[as24ci_location_box]`	Une carte d'emplacement pour un seul article d'emplacement.	Résout l'emplacement à partir de `post_id` ou du contexte.
`[as24ci_hours_box]`	Une carte d'heures d'ouverture pour un seul article d'emplacement.	Même comportement de repli que `[as24ci_location_box]`.

Référence des attributs

`[as24ci_archive]`

Tous les attributs sont facultatifs. Les paramètres d'URL du même nom surchargent l'attribut du shortcode, afin que les visiteurs puissent affiner les résultats de manière interactive.

Attribut	Valeurs autorisées	Effet
`make`	Slug de marque	Pré-filtrer par marque.
`model`	Slug de modèle	Pré-filtrer par modèle.
`price_min`	Nombre	Limite inférieure du filtre de prix (mappée sur `min_price`).
`price_max`	Nombre	Limite supérieure du filtre de prix (mappée sur `max_price`).
`fuel`	Slug de type de carburant	Pré-filtrer par type de carburant.
`body`	Slug de type de carrosserie	Pré-filtrer par type de carrosserie.
`order_by`	`price`, `mileage`, `date`	Champ de tri. Combiné avec `order` pour produire le paramètre `sort`.
`order`	`asc`, `desc`	Direction du tri. Par défaut `asc`.
`per_page`	`12`, `24`, `48`, `72`, `all`	Éléments par page.

La pagination utilise ?paged= (préféré) ou ?page= depuis l'URL.

Exemple :

[as24ci_archive make="bmw" price_max="40000" order_by="price" order="asc" per_page="24"]

`[as24ci_search_filter]`

Attribut	Valeurs autorisées	Effet
`results_url`	URL absolue ou relative	URL vers laquelle le formulaire soumet. Par défaut, l'URL d'archive du type de publication `as24ci_car`, avec un repli sur `/cars/` lorsqu'aucune URL d'archive n'est disponible.

Seuls les filtres activés dans la zone de mise en page Filtres de recherche sont rendus. Gérez-les dans l'onglet d'administration du Layout Manager.

Exemple :

[as24ci_search_filter results_url="/inventory/"]

`[as24ci_compare]`

Aucun attribut documenté dans la source actuelle. La sélection est pilotée par le paramètre d'URL ids, une liste d'identifiants d'articles de véhicules séparés par des virgules.

Exemple d'URL : /compare/?ids=123,456

`[as24ci_favorites]`

Aucun attribut documenté. Les champs visibles sont configurés par la zone de mise en page Favoris dans le Layout Manager. Les données du véhicule sont récupérées depuis POST /wp-json/as24ci/v1/favorites pour les identifiants que le visiteur a stockés localement.

`[as24ci_location_box]`

Attribut	Valeurs autorisées	Effet
`post_id`	Entier	ID de l'article d'emplacement à afficher. S'il est omis, le shortcode résout l'emplacement à partir du contexte actuel.

`[as24ci_hours_box]`

Attribut	Valeurs autorisées	Effet
`post_id`	Entier	ID de l'article d'emplacement à afficher. Même comportement de repli que `[as24ci_location_box]`.

Notes opérationnelles

L'extension définit la variable globale $as24ci_render_mode sur 'shortcode' pendant le rendu d'un modèle de shortcode. Le chargement des ressources et l'analyse utilisent ce drapeau afin que les pages basées sur des shortcodes se comportent de manière cohérente avec l'archive CPT native.
[as24ci_archive] et [as24ci_compare] échangent la variable globale $wp_query pendant le rendu de leur modèle et appellent wp_reset_postdata() ensuite. Intégrez-les dans la zone de contenu principal pour éviter d'interférer avec les composants du thème qui lisent la requête globale de manière précoce.
[as24ci_search_filter] construit son URL action à partir de l'URL de résultats configurée (ou par défaut) et préserve tous les paramètres de requête présents dans cette URL via des champs de formulaire masqués, de sorte qu'il fonctionne à la fois avec les permaliens personnalisés et simples.
Les modèles d'archive et de filtre de recherche intégrés utilisent toujours les propres fichiers de l'extension. Les surcharges de thème pour archive-as24ci_car.php s'appliquent à la fois à l'archive CPT et à [as24ci_archive], mais page-as24ci_compare.php et parts/search-filter.php ne sont pas chargés via locate_template() et ne peuvent pas être surchargés à partir d'un thème sans modifier le code source de l'extension. Vérifiez par rapport à la version actuelle de l'extension avant de publier.
Les pages servies par un cache de page complète doivent être purgées après la modification d'une page qui utilise ces shortcodes afin que le dernier rendu soit servi.

Dépannage

Le shortcode s'affiche en texte brut. Vérifiez le nom du shortcode ; les noms sont sensibles à la casse. Utilisez la forme en minuscules documentée ci-dessus.
[as24ci_archive] affiche les mauvais véhicules. L'URL contient probablement déjà des paramètres de filtrage d'une page précédente ; les paramètres d'URL surchargent toujours les attributs du shortcode.
[as24ci_search_filter] n'affiche aucun champ. Aucun filtre n'est activé dans la zone de mise en page Filtres de recherche. Ouvrez le Layout Manager et activez les filtres dont vous avez besoin.
[as24ci_favorites] affiche une liste vide. Le visiteur n'a aucun favori stocké dans le navigateur actuel. Les favoris sont limités au navigateur/appareil.
Les liens de pagination renvoient une erreur 404. Votre structure de permaliens peut ne pas transmettre proprement paged à travers la page d'hébergement. Essayez ?page=N ou mettez à jour la structure des permaliens.
La page de comparaison est vide. Le paramètre ids est manquant dans l'URL. Ajoutez au moins deux identifiants de véhicules (?ids=123,456).

Quand utiliser ce document

Aperçu

Référence des attributs

[as24ci_archive]

[as24ci_search_filter]

[as24ci_compare]

[as24ci_favorites]

[as24ci_location_box]

[as24ci_hours_box]