Documentatie · Bijlagen

Shortcode-referentie

Deze bijlage is een snelle referentie voor de shortcodes die zijn geregistreerd door de ADP Car Market Hub-plugin.

Wanneer u dit document moet gebruiken

Gebruik deze referentie wanneer u een shortcode-naam, de ondersteunde attributen of een kopieer-en-plakvoorbeeld wilt opzoeken. Voor de conceptuele uitleg van de shortcodes (wanneer u welke gebruikt, hoe ze communiceren met templates), raadpleegt u Shortcodes in de technische documentatie en de Shortcodes-referentie in de gebruikershandleiding voor de frontend.

Overzicht

Alle shortcodes worden geregistreerd door de hoofd-bootstrap van de plugin en zijn beschikbaar op elke WordPress-pagina of -bericht (afhankelijk van de actieve editor en eventuele beperkingen op blokniveau). Ze retourneren strings in plaats van dat ze direct output genereren (echoing), zodat ze kunnen worden ingesloten in bijschriften, tabelcellen of blokpatronen.

Shortcode	Rendert	Opmerkingen
`[as24ci_archive]`	Het voertuigarchief (filterbaar, sorteerbaar, gepagineerd).	URL-parameters overschrijven shortcode-attributen.
`[as24ci_search_filter]`	Het stand-alone zoekfilterformulier, zonder resultaten.	Verzendt naar een resultaten-URL naar keuze.
`[as24ci_compare]`	De voertuigvergelijkingspagina.	Voertuigen geselecteerd via de `ids` URL-parameter.
`[as24ci_favorites]`	De favorietenpagina van de bezoeker.	Wordt geladen via de favorieten REST-helper; favorieten worden aan de clientzijde opgeslagen.
`[as24ci_location_box]`	Een locatiekaart voor een enkel locatiebericht.	Bepaalt de locatie op basis van `post_id` of de context.
`[as24ci_hours_box]`	Een openingstijdenkaart voor een enkel locatiebericht.	Zelfde fallback-gedrag als `[as24ci_location_box]`.

Attributenreferentie

`[as24ci_archive]`

Alle attributen zijn optioneel. URL-parameters met dezelfde naam overschrijven het shortcode-attribuut, zodat bezoekers de resultaten interactief kunnen verfijnen.

Attribuut	Toegestane waarden	Effect
`make`	Merk-slug	Voorfilteren op merk.
`model`	Model-slug	Voorfilteren op model.
`price_min`	Getal	Ondergrens van het prijsfilter (gekoppeld aan `min_price`).
`price_max`	Getal	Bovengrens van het prijsfilter (gekoppeld aan `max_price`).
`fuel`	Brandstoftype-slug	Voorfilteren op brandstoftype.
`body`	Carrosserietype-slug	Voorfilteren op carrosserietype.
`order_by`	`price`, `mileage`, `date`	Sorteerveld. Gecombineerd met `order` om de parameter `sort` te genereren.
`order`	`asc`, `desc`	Sorteerrichting. Standaard `asc`.
`per_page`	`12`, `24`, `48`, `72`, `all`	Items per pagina.

Paginering gebruikt ?paged= (voorkeur) of ?page= uit de URL.

Voorbeeld:

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

`[as24ci_search_filter]`

Attribuut	Toegestane waarden	Effect
`results_url`	Absolute of relatieve URL	URL waarnaar het formulier wordt verzonden. Standaard ingesteld op de `as24ci_car` post-type archief-URL, met een fallback naar `/cars/` wanneer er geen archief-URL beschikbaar is.

Alleen de filters die zijn ingeschakeld in de lay-outzone Zoekfilters worden gerenderd. Beheer deze in het tabblad Layout Manager in het beheerderspaneel.

Voorbeeld:

[as24ci_search_filter results_url="/inventory/"]

`[as24ci_compare]`

Geen gedocumenteerde attributen in de huidige broncode. De selectie wordt gestuurd door de ids URL-parameter, een door komma's gescheiden lijst van voertuig-post-ID's.

Voorbeeld-URL: /compare/?ids=123,456

`[as24ci_favorites]`

Geen gedocumenteerde attributen. De zichtbare velden worden geconfigureerd door de lay-outzone Favorieten in de Layout Manager. Voertuiggegevens worden opgehaald uit POST /wp-json/as24ci/v1/favorites voor de ID's die de bezoeker lokaal heeft opgeslagen.

`[as24ci_location_box]`

Attribuut	Toegestane waarden	Effect
`post_id`	Geheel getal (integer)	ID van het locatiebericht dat moet worden gerenderd. Indien weggelaten, bepaalt de shortcode de locatie op basis van de huidige context.

`[as24ci_hours_box]`

Attribuut	Toegestane waarden	Effect
`post_id`	Geheel getal (integer)	ID van het locatiebericht dat moet worden gerenderd. Zelfde fallback-gedrag als `[as24ci_location_box]`.

Operationele opmerkingen

De plugin stelt de globale $as24ci_render_mode in op 'shortcode' tijdens het renderen van een shortcode-template. Het laden van assets en analytics gebruiken deze vlag, zodat op shortcodes gebaseerde pagina's zich consistent gedragen met het systeemeigen CPT-archief.
[as24ci_archive] en [as24ci_compare] wisselen de globale $wp_query om tijdens het renderen van hun template en roepen daarna wp_reset_postdata() aan. Sluit ze in binnen het hoofdgedeelte van de inhoud om te voorkomen dat ze interfereren met thema-componenten die de globale query vroegtijdig uitlezen.
[as24ci_search_filter] bouwt zijn action-URL op basis van de geconfigureerde (of standaard) resultaten-URL en behoudt eventuele queryparameters in die URL via verborgen formuliervelden, zodat het werkt met zowel mooie (pretty) als eenvoudige (plain) permalinks.
De meegeleverde archief- en zoekfiltertemplates gebruiken altijd de eigen bestanden van de plugin. Thema-overschrijvingen voor archive-as24ci_car.php zijn van toepassing op zowel het CPT-archief als [as24ci_archive], maar page-as24ci_compare.php en parts/search-filter.php worden niet geladen via locate_template() en kunnen niet vanuit een thema worden overschreven zonder de broncode van de plugin aan te passen. Controleer dit met de huidige plugin-versie voordat u publiceert.
Pagina's die worden geserveerd door een paginabrede cache (full-page cache) moeten worden geleegd na het bewerken van een pagina die deze shortcodes gebruikt, zodat de nieuwste output wordt getoond.

Problemen oplossen

Shortcode wordt als platte tekst weergegeven. Controleer de naam van de shortcode; namen zijn hoofdlettergevoelig. Gebruik de hierboven gedocumenteerde kleine letters.
[as24ci_archive] toont de verkeerde voertuigen. De URL bevat waarschijnlijk al filterparameters van een vorige pagina; URL-parameters overschrijven altijd shortcode-attributen.
[as24ci_search_filter] toont geen velden. Er zijn geen filters ingeschakeld in de lay-outzone Zoekfilters. Open de Layout Manager en schakel de filters in die u nodig hebt.
[as24ci_favorites] toont een lege lijst. De bezoeker heeft geen favorieten opgeslagen in de huidige browser. Favorieten zijn gekoppeld aan de browser/het apparaat.
Paginering-links geven een 404-fout. Uw permalink-structuur geeft paged mogelijk niet correct door via de hostende pagina. Probeer ?page=N of werk de permalink-structuur bij.
Vergelijkingspagina is leeg. De parameter ids ontbreekt in de URL. Voeg ten minste twee voertuig-ID's toe (?ids=123,456).

Overzicht

Attributenreferentie

[as24ci_archive]

[as24ci_search_filter]

[as24ci_compare]

[as24ci_favorites]

[as24ci_location_box]

[as24ci_hours_box]