Documentation · Guide du Frontend
Archive des véhicules
Ce document traite de la page d'archive des véhicules de l'extension ADP Car Market Hub WordPress : comment les véhicules sont listés, comment fonctionnent les filtres et le tri, et ce que les visiteurs peuvent faire depuis l'archive.
Quand utiliser ce document
Lisez ce document si vous configurez l'archive des véhicules pour la première fois, si vous dépannez le comportement des filtres ou du tri, ou si vous aidez un visiteur à comprendre comment rechercher et parcourir l'inventaire.
Aperçu
L'archive des véhicules affiche tous les véhicules importés sous forme de liste consultable et filtrable. Les visiteurs peuvent affiner les résultats à l'aide de filtres de recherche, trier la liste par prix ou par kilométrage, basculer entre les vues en grille et en liste, et naviguer vers les pages de détails de chaque véhicule.
L'archive est générée par le modèle d'archive intégré de l'extension (archive-as24ci_car.php). Elle peut être affichée de deux manières :
- Archive CPT native : WordPress sert automatiquement l'archive à l'URL de l'archive du type de publication personnalisé (CPT). L'extension enregistre le type de publication
as24ci_caret intercepte le modèle d'archive via le filtrearchive_template. - Page de shortcode : Placez le shortcode
[as24ci_archive]sur n'importe quelle page WordPress. L'extension génère l'archive complète, y compris les filtres et la pagination, sur cette page. C'est l'approche recommandée lors de l'utilisation de permaliens simples (non réécrits) ou lorsque vous souhaitez contrôler le slug de l'URL de l'archive.
Les deux méthodes utilisent le même modèle et produisent un résultat identique.
Configuration requise ou prérequis
- L'extension doit être installée et activée.
- Au moins un véhicule doit avoir été importé et publié.
- Si vous utilisez la méthode du shortcode, une page contenant
[as24ci_archive]doit exister dans WordPress. - La page d'archive ou l'URL de l'archive CPT doit être accessible publiquement.
Instructions étape par étape
Afficher l'archive des véhicules via un shortcode
- Dans l'administration de WordPress, allez dans Pages → Ajouter une nouvelle page.
- Donnez un titre à la page, tel que « Nos véhicules » ou « Inventaire de véhicules ».
- Dans l'éditeur de contenu de la page, ajoutez le shortcode
[as24ci_archive]. - Publiez la page.
- Dans les réglages de l'extension, confirmez que l'ID de la page d'archive est correctement défini dans la configuration de l'extension, afin que le fil d'Ariane et les liens de comparaison pointent vers la bonne URL.
Pré-filtrer l'archive à l'aide des attributs du shortcode
Vous pouvez pré-filtrer l'archive à partir du shortcode pour n'afficher qu'un sous-ensemble de véhicules :
[as24ci_archive make="bmw" fuel="diesel" per_page="12"]Attributs de shortcode pris en charge :
| Attribut | Description | Exemple de valeur |
|---|---|---|
make | Filtrer par marque (slug) | bmw, volkswagen |
model | Filtrer par modèle (slug) | 3-series, golf |
price_min | Prix minimum | 5000 |
price_max | Prix maximum | 30000 |
fuel | Filtrer par type de carburant (slug) | diesel, electric |
body | Filtrer par type de carrosserie (slug) | suv, sedan |
order_by | Champ de tri : price, mileage ou date | price |
order | Direction du tri : asc ou desc | asc |
per_page | Résultats par page : 12, 24, 48, 72 ou all | 24 |
Les visiteurs peuvent toujours interagir avec le formulaire de filtrage après le chargement de la page. Les paramètres GET du formulaire de filtrage remplacent les attributs du shortcode.
Référence de configuration
Contrôles de filtrage
L'archive comprend un formulaire de filtre de recherche. Les filtres qui apparaissent sont contrôlés par la zone Layout Manager → Search Filters de l'extension. Les champs de filtrage suivants sont pris en charge :
Filtres standards (visibles par défaut) :
- Marque
- Modèle (dépend de la marque sélectionnée)
- Année (plage min/max)
- Kilométrage (plage min/max)
- Prix (plage min/max)
- Type de carburant
- Transmission
- Type de transmission (motricité)
- État
- Couleur extérieure
Filtres avancés (affichés via un bouton « Afficher plus ») :
- Couleur intérieure
- Cylindrée du moteur (plage min/max)
- Label énergétique
- Emplacement
Filtres optionnels (désactivés par défaut, peuvent être activés) :
- Type de carrosserie
- Portes (plage min/max)
- Sièges (plage min/max)
Contrôles de la barre d'outils (configurables) :
- Ordre de tri
- Résultats par page
- Recherche par mot-clé (
q)
Chaque filtre peut être activé ou désactivé individuellement dans le Layout Manager. Les filtres désactivés sont masqués pour les visiteurs mais n'affectent pas les valeurs de filtre actuellement actives.
Paramètres GET acceptés par l'archive
L'archive traite les paramètres GET suivants, que le formulaire de filtrage soumet automatiquement :
| Paramètre | Type | Description |
|---|---|---|
make | string | Slug de la marque du véhicule |
model | string | Slug du modèle du véhicule |
body_type | string | Slug du type de carrosserie |
drive_type | string | Slug du type de transmission (motricité) |
condition | string | Slug de l'état (new ou used) |
fuel_type | string | Slug du type de carburant |
transmission | string | Slug de la transmission |
color_exterior | string | Slug de la couleur extérieure (color est accepté comme alias) |
color_interior | string | Slug de la couleur intérieure |
min_price | int | Prix minimum |
max_price | int | Prix maximum |
mileage_min | int | Kilométrage minimum en km |
mileage_max | int | Kilométrage maximum en km |
year_min | int | Année de première immatriculation minimale |
year_max | int | Année de première immatriculation maximale |
displacement_min | int | Cylindrée minimale du moteur en cm³ |
displacement_max | int | Cylindrée maximale du moteur en cm³ |
energy_label | string | Slug du label énergétique |
location | string | Nom de l'emplacement |
doors_min | int | Nombre minimum de portes |
doors_max | int | Nombre maximum de portes |
seats_min | int | Nombre minimum de sièges |
seats_max | int | Nombre maximum de sièges |
status | string | all, new ou used (onglet d'état) |
q | string | Recherche par mot-clé (max 100 caractères) |
sort | string | Ordre de tri (voir la section Tri) |
per_page | string | Résultats par page : 12, 24, 48, 72 ou all |
paged | int | Numéro de page pour la pagination |
Tri
L'archive prend en charge les options de tri suivantes via le paramètre GET sort :
| Valeur | Description |
|---|---|
| (vide) | Les plus récents en premier (date décroissante) |
price_asc | Prix : du moins cher au plus cher |
price_desc | Prix : du plus cher au moins cher |
mileage_asc | Kilométrage : du plus bas au plus haut |
mileage_desc | Kilométrage : du plus haut au plus bas |
L'ordre de tri par défaut peut être configuré dans les réglages de l'extension. Si aucun tri par défaut n'est configuré, l'archive affiche par défaut les véhicules les plus récents en premier.
Options de mise en page et d'affichage
Les réglages d'affichage suivants sont disponibles dans l'administration de l'extension :
| Réglage | Options | Description |
|---|---|---|
| Archive layout | grid, list, both | Mode d'affichage des fiches. both ajoute un bouton de changement de vue. |
| Grid columns | 1, 2, 3, 4 | Nombre de colonnes en vue grille |
| Results per page | 12, 24, 48, 72 ou entier personnalisé | Nombre par défaut de véhicules par page |
| List excerpt length | 0–500 caractères | Limite de caractères pour l'extrait affiché en vue liste |
| Badges | New, Used, Sale, Top offer | Activer/désactiver les badges affichés sur les fiches de véhicules |
Contenu des fiches d'archive
Chaque fiche de véhicule dans l'archive affiche les informations suivantes. Les éléments individuels peuvent être réorganisés ou désactivés via la zone Layout Manager → Archive Cards :
- Image miniature du véhicule (affiche une image de remplacement par défaut si aucune image n'est disponible)
- Titre du véhicule
- Prix (formaté avec la devise)
- Badges d'état (New, Used, Sale, Top offer)
- Caractéristiques clés : année, kilométrage, type de carburant, transmission, puissance, type de carrosserie, couleur extérieure, état (configurable)
- Bouton Favoris (icône de cœur, si la fonctionnalité de favoris est activée)
- Bouton Comparer (si la fonctionnalité de comparaison est activée)
- Texte de l'extrait (vue liste uniquement, si la longueur de l'extrait est supérieure à zéro)
Onglets d'état
L'en-tête de l'archive comprend trois onglets : All, New et Used. Chaque onglet affiche le nombre de véhicules correspondant à l'état actuel du filtre. Cliquer sur un onglet filtre par état. Lorsqu'un état est sélectionné via le filtre déroulant d'état, les compteurs d'onglets et la sélection d'onglets sont synchronisés avec cette sélection.
Notes opérationnelles
- Les filtres catégoriels (marque, modèle, type de carburant, état, etc.) sont implémentés à l'aide de requêtes de taxonomie WordPress. Les filtres numériques (prix, kilométrage, année, cylindrée) interrogent la table de base de données personnalisée
{prefix}as24_vehiclesde l'extension. - Le filtrage par emplacement résout le nom de l'emplacement en un ensemble de Seller IDs, puis filtre les véhicules par ces vendeurs.
- Lorsque l'option
per_page=allest sélectionnée, la pagination est masquée et tous les véhicules correspondants sont renvoyés dans une seule requête. - Le modèle d'archive est chargé via le filtre WordPress
archive_template. Le thème actif peut surcharger le modèle en fournissant un fichierarchive-as24ci_car.phpdans le répertoire du thème. - Lors de l'utilisation du shortcode, l'action du formulaire pointe vers l'URL de la page actuelle plutôt que vers l'URL de l'archive CPT. Cela garantit que les soumissions de filtres et la pagination fonctionnent correctement sur la page du shortcode.
- L'extension ne charge ses propres fichiers CSS et JavaScript que sur les pages d'archive, les pages de véhicules individuels et les pages contenant un shortcode reconnu de l'extension.
Dépannage
La page d'archive n'affiche aucun véhicule.
- Confirmez qu'au moins un véhicule a été importé et est publié.
- Vérifiez que la bonne page est configurée comme page d'archive dans les réglages de l'extension.
- Si vous utilisez l'URL d'archive du CPT, vérifiez que les permaliens personnalisés sont activés dans WordPress Réglages → Permaliens.
Les filtres n'apparaissent pas.
- Vérifiez la zone Gestionnaire de mise en page → Filtres de recherche et confirmez que les filtres souhaités sont activés.
- Si le formulaire de filtre apparaît mais qu'un filtre spécifique est manquant, il se peut qu'il ait été désactivé dans le Gestionnaire de mise en page.
Le tri par prix ou par kilométrage ne fonctionne pas correctement.
- Le tri par prix et par kilométrage repose sur la table de véhicules personnalisée de l'extension. Les véhicules importés avant la création de cette table peuvent ne pas se trier correctement tant qu'ils ne sont pas réimportés ou que l'outil de migration n'est pas exécuté.
Le shortcode [as24ci_archive] ne s'affiche pas.
- Confirmez que l'extension est active et que le shortcode est correctement placé dans le contenu de la page.
- Recherchez d'éventuels conflits de thèmes ou d'extensions qui pourraient bloquer l'affichage du shortcode.
La pagination ne fonctionne pas sur une page de shortcode.
- Les paramètres GET
pagedetpagesont tous deux pris en charge. Vérifiez que les liens de pagination de votre thème génèrent l'un de ces paramètres.