Documentatie · Frontend-handleiding
Voertuigarchief
Dit document behandelt de voertuigarchiefpagina van de ADP Car Market Hub WordPress Plugin: hoe voertuigen worden weergegeven, hoe filters en sortering werken en wat bezoekers kunnen doen vanaf het archief.
Wanneer u dit document moet gebruiken
Lees dit document als u het voertuigarchief voor de eerste keer configureert, problemen met filter- of sorteergedrag oplost, of een bezoeker helpt te begrijpen hoe hij de voorraad kan doorzoeken en bekijken.
Overzicht
Het voertuigarchief toont alle geïmporteerde voertuigen als een doorzoekbare, filterbare lijst. Bezoekers kunnen de resultaten verfijnen met behulp van zoekfilters, de lijst sorteren op prijs of kilometerstand, schakelen tussen raster- en lijstweergaven en navigeren naar individuele voertuigdetailpagina's.
Het archief wordt gerenderd door de ingebouwde archieftemplate van de plugin (archive-as24ci_car.php). Het kan op twee manieren worden weergegeven:
- Systeemeigen CPT-archief: WordPress serveert het archief automatisch op de archief-URL van het aangepaste berichttype (custom post type). De plugin registreert het berichttype
as24ci_caren onderschept de archieftemplate via hetarchive_template-filter. - Shortcode-pagina: Plaats de shortcode
[as24ci_archive]op een willekeurige WordPress-pagina. De plugin rendert het volledige archief inclusief filters en paginering op die pagina. Dit is de aanbevolen aanpak bij het gebruik van eenvoudige (niet-mooie) permalinks of wanneer u de URL-slug van het archief wilt beheren.
Beide methoden gebruiken dezelfde template en produceren identieke uitvoer.
Vereisten of randvoorwaarden
- De plugin moet geïnstalleerd en geactiveerd zijn.
- Er moet ten minste één voertuig zijn geïmporteerd en gepubliceerd.
- Bij gebruik van de shortcode-methode moet er een pagina met
[as24ci_archive]bestaan in WordPress. - De archiefpagina of de CPT-archief-URL moet openbaar toegankelijk zijn.
Stapsgewijze instructies
Het voertuigarchief weergeven via shortcode
- Ga in de WordPress-beheeromgeving naar Pagina's → Nieuwe pagina toevoegen.
- Geef de pagina een titel zoals "Onze voertuigen" of "Voertuigvoorraad".
- Voeg in de inhoudseditor van de pagina de shortcode
[as24ci_archive]toe. - Publiceer de pagina.
- Controleer in de plugin-instellingen of de ID van de archiefpagina correct is ingesteld onder de configuratie van de plugin, zodat kruimelpaden en vergelijkingslinks naar de juiste URL verwijzen.
Het archief vooraf filteren met shortcode-attributen
U kunt het archief vooraf filteren vanuit de shortcode om slechts een selectie van voertuigen te tonen:
[as24ci_archive make="bmw" fuel="diesel" per_page="12"]Ondersteunde shortcode-attributen:
| Attribuut | Beschrijving | Voorbeeldwaarde |
|---|---|---|
make | Filteren op merk (slug) | bmw, volkswagen |
model | Filteren op model (slug) | 3-series, golf |
price_min | Minimum prijs | 5000 |
price_max | Maximum prijs | 30000 |
fuel | Filteren op brandstoftype (slug) | diesel, electric |
body | Filteren op carrosserietype (slug) | suv, sedan |
order_by | Sorteerveld: price, mileage, of date | price |
order | Sorteerrichting: asc of desc | asc |
per_page | Resultaten per pagina: 12, 24, 48, 72, of all | 24 |
Bezoekers kunnen nog steeds communiceren met het filterformulier nadat de pagina is geladen. GET-parameters van het filterformulier overschrijven de shortcode-attributen.
Configuratiereferentie
Filteropties
Het archief bevat een zoekfilterformulier. Welke filters verschijnen, wordt beheerd door de zone Layout Manager → Search Filters van de plugin. De volgende filtervelden worden ondersteund:
Standaardfilters (standaard zichtbaar):
- Merk
- Model (afhankelijk van merkselectie)
- Bouwjaar (min/max bereik)
- Kilometerstand (min/max bereik)
- Prijs (min/max bereik)
- Brandstoftype
- Transmissie
- Aandrijving
- Staat
- Exterieurkleur
Geavanceerde filters (weergegeven via een "Toon meer"-knop):
- Interieurkleur
- Motorinhoud (min/max bereik)
- Energielabel
- Locatie
Optionele filters (standaard uitgeschakeld, kunnen worden ingeschakeld):
- Carrosserietype
- Deuren (min/max bereik)
- Zitplaatsen (min/max bereik)
Werkbalkopties (configureerbaar):
- Sorteervolgorde
- Resultaten per pagina
- Zoeken op trefwoord (
q)
Elk filter kan afzonderlijk worden in- of uitgeschakeld in de Layout Manager. Uitgeschakelde filters zijn verborgen voor bezoekers, maar hebben geen invloed op eventuele momenteel actieve filterwaarden.
GET-parameters geaccepteerd door het archief
Het archief verwerkt de volgende GET-parameters, die automatisch door het filterformulier worden verzonden:
| Parameter | Type | Beschrijving |
|---|---|---|
make | string | Voertuigmerk slug |
model | string | Voertuigmodel slug |
body_type | string | Carrosserietype slug |
drive_type | string | Aandrijving slug |
condition | string | Staat slug (new of used) |
fuel_type | string | Brandstoftype slug |
transmission | string | Transmissie slug |
color_exterior | string | Exterieurkleur slug (color wordt geaccepteerd als alias) |
color_interior | string | Interieurkleur slug |
min_price | int | Minimum prijs |
max_price | int | Maximum prijs |
mileage_min | int | Minimum kilometerstand in km |
mileage_max | int | Maximum kilometerstand in km |
year_min | int | Minimum bouwjaar |
year_max | int | Maximum bouwjaar |
displacement_min | int | Minimum motorinhoud in cc |
displacement_max | int | Maximum motorinhoud in cc |
energy_label | string | Energielabel slug |
location | string | Locatienaam |
doors_min | int | Minimum aantal deuren |
doors_max | int | Maximum aantal deuren |
seats_min | int | Minimum aantal zitplaatsen |
seats_max | int | Maximum aantal zitplaatsen |
status | string | all, new, of used (statustabblad) |
q | string | Zoeken op trefwoord (max. 100 tekens) |
sort | string | Sorteervolgorde (zie sectie Sortering) |
per_page | string | Resultaten per pagina: 12, 24, 48, 72, of all |
paged | int | Paginanummer voor paginering |
Sortering
Het archief ondersteunt de volgende sorteeropties via de GET-parameter sort:
| Waarde | Beschrijving |
|---|---|
| (leeg) | Nieuwste eerst (datum aflopend) |
price_asc | Prijs: laagste eerst |
price_desc | Prijs: hoogste eerst |
mileage_asc | Kilometerstand: laagste eerst |
mileage_desc | Kilometerstand: hoogste eerst |
De standaardsorteervolgorde kan worden geconfigureerd in de plugin-instellingen. Als er geen standaard is geconfigureerd, sorteert het archief standaard op nieuwste eerst.
Lay-out- en weergaveopties
De volgende weergave-instellingen zijn beschikbaar in het plugin-beheer:
| Instelling | Opties | Beschrijving |
|---|---|---|
| Archieflay-out | grid, list, both | Kaartweergavemodus. both voegt een knop toe om tussen weergaven te schakelen. |
| Rasterkolommen | 1, 2, 3, 4 | Aantal kolommen in rasterweergave |
| Resultaten per pagina | 12, 24, 48, 72, of aangepast getal | Standaard aantal voertuigen per pagina |
| Lengte van tekstfragment in lijst | 0–500 tekens | Tekenlimiet voor het tekstfragment dat in de lijstweergave wordt getoond |
| Badges | Nieuw, Gebruikt, Actie, Topaanbod | Schakelen welke badges op voertuigkaarten worden getoond |
Inhoud van de archiefkaart
Elke voertuigkaart in het archief toont de volgende informatie. Individuele elementen kunnen opnieuw worden geordend of uitgeschakeld via de zone Layout Manager → Archive Cards:
- Miniatuurafbeelding van het voertuig (valt terug op een tijdelijke aanduiding als er geen afbeelding beschikbaar is)
- Voertuigtitel
- Prijs (geformatteerd met valuta)
- Statusbadges (Nieuw, Gebruikt, Actie, Topaanbod)
- Belangrijke kenmerken: bouwjaar, kilometerstand, brandstoftype, transmissie, vermogen, carrosserietype, exterieurkleur, staat (configureerbaar)
- Favorietenknop (hartpictogram, als de favorietenfunctie is ingeschakeld)
- Vergelijkingsknop (als de vergelijkingsfunctie is ingeschakeld)
- Tekstfragment (alleen lijstweergave, als de lengte van het tekstfragment groter is dan nul)
Staat-tabbladen
De koptekst van het archief bevat drie tabbladen: Alle, Nieuw en Gebruikt. Elk tabblad toont het aantal voertuigen dat overeenkomt met de huidige filterstatus. Klikken op een tabblad filtert op staat. Wanneer een staat wordt geselecteerd via het dropdown-filter voor staat, worden de tabbladaantallen en de tabbladselectie gesynchroniseerd met die selectie.
Operationele opmerkingen
- Categorie-filters (merk, model, brandstoftype, staat, enz.) zijn geïmplementeerd met behulp van WordPress-taxonomiequery's. Numerieke filters (prijs, kilometerstand, bouwjaar, motorinhoud) bevragen de aangepaste database-tabel
{prefix}as24_vehiclesvan de plugin. - Locatiefiltering herleidt de locatienaam naar een set Seller ID's en filtert vervolgens voertuigen op die verkopers.
- Wanneer de optie
per_page=allis geselecteerd, wordt paginering verborgen en worden alle overeenkomende voertuigen in één enkel verzoek geretourneerd. - De archieftemplate wordt geladen via het WordPress
archive_template-filter. Het actieve thema kan de template overschrijven door eenarchive-as24ci_car.php-bestand in de themamap te plaatsen. - Bij gebruik van de shortcode verwijst de formulieractie naar de huidige pagina-URL in plaats van de CPT-archief-URL. Dit zorgt ervoor dat filterverzendingen en paginering correct werken op de shortcode-pagina.
- De plugin laadt zijn eigen CSS en JavaScript alleen op archiefpagina's, individuele voertuigpagina's en pagina's die een herkende shortcode van de plugin bevatten.
Probleemoplossing
De archiefpagina toont geen voertuigen.
- Controleer of er ten minste één voertuig is geïmporteerd en gepubliceerd.
- Controleer of de juiste pagina is geconfigureerd als de archiefpagina in de plugin-instellingen.
- Als u de CPT-archief-URL gebruikt, controleer dan of mooie permalinks zijn ingeschakeld in WordPress Instellingen → Permalinks.
Filters verschijnen niet.
- Controleer de zone Layout Manager → Zoekfilters en controleer of de gewenste filters zijn ingeschakeld.
- Als het filterformulier wel verschijnt maar een specifiek filter ontbreekt, is dit mogelijk uitgeschakeld in de Layout Manager.
Sorteren op prijs of kilometerstand werkt niet correct.
- Sorteren op prijs en kilometerstand is afhankelijk van de aangepaste voertuigentalbel van de plugin. Voertuigen die zijn geïmporteerd voordat deze tabel werd gemaakt, sorteren mogelijk niet correct totdat ze opnieuw worden geïmporteerd of de migratietool wordt uitgevoerd.
De [as24ci_archive] shortcode wordt niet weergegeven.
- Controleer of de plugin actief is en of de shortcode correct in de pagina-inhoud is geplaatst.
- Controleer op conflicten met thema's of plugins die de uitvoer van shortcodes kunnen onderdrukken.
Paginering werkt niet op een shortcodepagina.
- De GET-parameters
pagedenpageworden beide ondersteund. Controleer of de pagineringslinks van uw thema een van deze parameters genereren.