Documentatie · Frontend-handleiding
Shortcodes-referentie
Dit document is een volledige referentie voor alle WordPress shortcodes die worden geleverd door de ADP Car Market Hub WordPress Plugin.
Wanneer u dit document gebruikt
Gebruik dit document wanneer u plugin-output wilt insluiten op een WordPress pagina en de exacte shortcode-syntaxis, ondersteunde attributen en het verwachte gedrag voor elke shortcode wilt weten.
Overzicht
De plugin registreert de volgende shortcodes:
| Shortcode | Beschrijving |
|---|---|
[as24ci_archive] | Toont het volledige voertuigarchief met filters, sortering en paginering |
[as24ci_search_filter] | Toont alleen het zoekfilterformulier, zonder resultaten |
[as24ci_compare] | Toont de voertuigvergelijkingstabel |
[as24ci_favorites] | Toont de lijst met opgeslagen favorieten van de bezoeker |
[as24ci_location_box] | Toont het adresblok van de dealerlocatie voor een voertuig |
[as24ci_hours_box] | Toont het blok met openingstijden van de dealer voor een voertuig |
[as24ci_archive]
Toont het volledige voertuigarchief inclusief het zoekfilterformulier, het resultatenoverzicht (grid of lijst), conditietabs, sorteeropties, resultaten per pagina en paginering. Genereert dezelfde output als de standaard archief-URL van het custom post type.
Attributen
Alle attributen zijn optioneel. Als er een GET-parameter met dezelfde naam in de URL aanwezig is, overschrijft deze het shortcode-attribuut.
| Attribuut | Type | Beschrijving | Voorbeeld |
|---|---|---|---|
make | string | Voorfilteren op voertuigmerk-slug | bmw |
model | string | Voorfilteren op voertuigmodel-slug | 3-series |
price_min | int | Minimum prijs voorfilter | 5000 |
price_max | int | Maximum prijs voorfilter | 30000 |
fuel | string | Voorfilteren op brandstoftype-slug | diesel |
body | string | Voorfilteren op carrosserietype-slug | suv |
order_by | string | Sorteerveld: price, mileage, of date | price |
order | string | Sorteerrichting: asc of desc. Gebruikt met order_by. | asc |
per_page | string | Resultaten per pagina: 12, 24, 48, 72, of all | 24 |
Voorbeelden
Toon alle voertuigen:
[as24ci_archive]Toon alleen diesel-SUV's gesorteerd op prijs oplopend:
[as24ci_archive fuel="diesel" body="suv" order_by="price" order="asc"]Toon voertuigen in een prijsklasse met 12 resultaten per pagina:
[as24ci_archive price_min="10000" price_max="50000" per_page="12"]Opmerkingen
- Bezoekers kunnen na het laden van de pagina interactie hebben met het filterformulier. Elke filterselectie door de bezoeker overschrijft de voorfilter-attributen van de shortcode via GET-parameters.
- Paginering maakt gebruik van de
pagedofpageGET-parameter. - De shortcode gebruikt de URL van de pagina zelf als actie voor het filterformulier. Zorg ervoor dat de pagina een schone, toegankelijke URL heeft.
[as24ci_search_filter]
Toont alleen het zoekfilterformulier, zonder voertuigresultaten. Gebruik dit op een homepage of landingspagina om bezoekers hun criteria te laten instellen voordat ze naar de resultatenpagina worden gestuurd.
Attributen
| Attribuut | Type | Beschrijving | Voorbeeld |
|---|---|---|---|
results_url | string | URL van de resultatenpagina waarnaar het formulier verzendt. Standaard ingesteld op de CPT-archief-URL of /cars/. | /inventory/ |
Voorbeelden
Filterformulier dat doorverwijst naar het standaard CPT-archief:
[as24ci_search_filter]Filterformulier dat doorverwijst naar een aangepaste resultatenpagina:
[as24ci_search_filter results_url="/car-inventory/"]Opmerkingen
- Het filterformulier wordt weergegeven met dezelfde velden en Layout Manager-configuratie als het filter op de archiefpagina.
- Eventuele GET-parameters die al op de huidige pagina aanwezig zijn, worden weerspiegeld in de vooraf geselecteerde waarden van het filterformulier.
- Wanneer eenvoudige (niet-mooie) permalinks worden gebruikt, is de CPT-archief-URL mogelijk niet bereikbaar. Stel in dat geval
results_urlexpliciet in op een pagina met de[as24ci_archive]shortcode.
[as24ci_compare]
Toont de voertuigvergelijkingstabel. Laadt de voertuig-ID's uit de ids GET-parameter (een door komma's gescheiden lijst van post-ID's) en toont elk voertuig als een kolom in een tabel naast elkaar.
Attributen
Deze shortcode heeft geen configureerbare attributen. Voertuig-ID's worden via de URL doorgegeven.
URL-indeling
/compare-page/?ids=123,456,789Het vergelijkings-JavaScript bouwt deze URL automatisch op wanneer de bezoeker op de knop Vergelijken klikt.
Voorbeeld
[as24ci_compare]Plaats deze shortcode op een speciale pagina "Voertuigen vergelijken". De plugin-instellingen moeten naar de ID van deze pagina verwijzen als de vergelijkingspagina.
Opmerkingen
- De vergelijkingstabel toont alleen gepubliceerde voertuigen van het custom post type van de plugin.
- Er worden maximaal 4 voertuigen weergegeven, ongeacht hoeveel ID's er worden doorgegeven. ID's buiten de eerste 4 worden geruisloos genegeerd.
- Als er geen
idsparameter aanwezig is of alle opgegeven ID's ongeldig zijn, toont de pagina "Geen voertuigen geselecteerd voor vergelijking." - De velden die in elke kolom worden getoond, worden geconfigureerd in de Layout Manager → Compare-zone.
[as24ci_favorites]
Toont de lijst met opgeslagen favorieten van de bezoeker. De lijst wordt dynamisch gevuld door JavaScript met behulp van voertuig-ID's die zijn opgeslagen in de localStorage van de browser. De plugin roept een intern REST-eindpunt aan om de actuele voertuiggegevens voor elk opgeslagen ID op te halen.
Attributen
Deze shortcode heeft geen configureerbare attributen.
Voorbeeld
[as24ci_favorites]Plaats deze shortcode op een speciale pagina "Mijn favorieten".
Opmerkingen
- De pagina heeft JavaScript nodig om te functioneren. Zonder JavaScript kan de lijst niet worden gevuld.
- Als er geen voertuigen zijn opgeslagen in de browser van de bezoeker, toont de pagina "U heeft nog geen opgeslagen favorieten."
- De REST API moet openbaar toegankelijk zijn. Beveiligingsplugins die openbare REST-eindpunten blokkeren, voorkomen dat de favorietenlijst wordt geladen.
- De velden die op elke favorietenkaart worden getoond, worden geconfigureerd in de Layout Manager → Favorites-zone.
- Er worden maximaal 50 opgeslagen voertuig-ID's per verzoek opgehaald.
[as24ci_location_box]
Toont het adresblok van de dealerlocatie voor een voertuig. Het blok toont de dealernaam, telefoonnummer, adres en optioneel een knop "Locatie bezoeken" als er een website-URL is geconfigureerd.
De locatie wordt bepaald door het AutoScout24 verkoper-ID van het voertuig te koppelen aan de geconfigureerde locaties van de plugin.
Attributen
| Attribuut | Type | Beschrijving | Voorbeeld |
|---|---|---|---|
post_id | int | WordPress post-ID van het voertuig. Standaard ingesteld op de huidige post in de loop. | 456 |
Voorbeelden
Locatieblok voor een specifiek voertuig:
[as24ci_location_box post_id="456"]Locatieblok voor de huidige post (bij gebruik binnen een voertuigpaginatag-template):
[as24ci_location_box]Opmerkingen
- Geeft lege output terug als het voertuig geen verkoper-ID heeft, of als er geen geconfigureerde locatie overeenkomt met het verkoper-ID.
- Op voertuigdetailpagina's wordt deze informatie ook automatisch onder het contactformulier weergegeven, dus handmatig gebruik van de shortcode op dezelfde pagina zou leiden tot dubbele output.
[as24ci_hours_box]
Toont het blok met openingstijden van de dealer voor een voertuig. Het blok toont één kolom per geconfigureerde categorie openingstijden, elk met rijen voor dagbereik en tijdsbereik.
De locatie wordt bepaald door het AutoScout24 verkoper-ID van het voertuig te koppelen aan de geconfigureerde locaties van de plugin.
Attributen
| Attribuut | Type | Beschrijving | Voorbeeld |
|---|---|---|---|
post_id | int | WordPress post-ID van het voertuig. Standaard ingesteld op de huidige post in de loop. | 456 |
Voorbeelden
Openingstijdenblok voor een specifiek voertuig:
[as24ci_hours_box post_id="456"]Openingstijdenblok for de huidige post:
[as24ci_hours_box]Opmerkingen
- Geeft lege output terug als het voertuig geen verkoper-ID heeft, er geen overeenkomstige locatie is gevonden, of de gekoppelde locatie geen openingstijden heeft geconfigureerd.
- Op voertuigdetailpagina's wordt deze informatie ook automatisch onder het contactformulier weergegeven.