Documentatie · Beheerdersreferentie

Beheerdersreferentie voor Shortcodes & Widgets

Dit document is een referentie voor het scherm Shortcodes & Widgets van de ADP Car Market Hub plugin (Car Market Hub → Shortcodes & Widgets). Het documenteert elke shortcode die de plugin registreert, de ondersteunde attributen en URL-parameters, de integraties met editors en page-builders en de dashboard-widgets die met de plugin worden meegeleverd.

Wanneer u dit document moet gebruiken

Lees dit als u een redacteur, sitebouwer of ontwikkelaar bent en u het volgende moet doen:

Voertuiglijsten, zoekformulieren, vergelijkingstabellen, favorieten, locatieboxen of openingstijdenboxen op een pagina invoegen.
De voorraad vooraf filteren op het moment van invoegen met behulp van shortcode-attributen.
Vooraf gefilterd verkeer naar de voorraadpagina sturen met behulp van URL-parameters.
Een plugin-template overschrijven in uw actieve thema.
Begrijpen welke dashboard-widgets de plugin biedt.

Overzicht

De plugin registreert zes openbare shortcodes:

Shortcode	Doel
`[as24ci_archive]`	Volledige voertuigvoorraad met filters, sortering en paginering.
`[as24ci_search_filter]`	Zelfstandig zoekformulier, bedoeld voor landings- of homepages.
`[as24ci_compare]`	Voertuigvergelijkingstabel voor door de bezoeker geselecteerde voertuigen.
`[as24ci_favorites]`	Favorietenpagina voor bezoekers (items worden aan de clientzijde opgeslagen in `localStorage`).
`[as24ci_location_box]`	Contactkaart voor de dealerlocatie die aan een voertuig is gekoppeld.
`[as24ci_hours_box]`	Openingstijdenkaart voor de dealerlocatie die aan een voertuig is gekoppeld.

Elke shortcode wordt ook op het scherm vermeld als een eigen item met een speciale Kopiëren-knop en een uitklapbare sectie Attributen & voorbeelden die de ondersteunde attributen en kant-en-klare voorbeelden voor die shortcode toont.

Bovenaan het scherm vatten vijf KPI-tegels het shortcode-gebruik in één oogopslag samen:

KPI-tegel	Toont
Beschikbare shortcodes	Hoeveel openbare shortcodes de plugin registreert.
Shortcodes in gebruik	Totaal aantal gevonden shortcodes op de gescande pagina's en berichten.
Builder-integraties	Hoeveel ondersteunde editor- / page-builder-integratiefamilies beschikbaar zijn.
Pagina's die plugin gebruiken	Aantal gepubliceerde pagina's en berichten die ten minste één plugin-shortcode bevatten.
Template-overrides	Aantal plugin-templates dat momenteel wordt overschreven door uw actieve thema.

Onder de tegels biedt een introductiekaart snel kopiëren-knoppen met één klik voor de vier meest gebruikte shortcodes — [as24ci_archive], [as24ci_search_filter], [as24ci_compare] en [as24ci_favorites] — zodat u ze naar het klembord kunt kopiëren zonder te typen.

Het scherm toont ook een tabel Overzicht van shortcode-gebruik met gepubliceerde pagina's en berichten die een plugin-shortcode bevatten (tot de meest recente 100 resultaten), en een kaart Ontwikkelaarsnotities met documentatie over template-overrides en ondersteunde URL-parameters.

Vereisten of randvoorwaarden

Een gebruiker met een rol die pagina's of berichten kan bewerken.
Voor [as24ci_compare] en [as24ci_favorites] moet de bijbehorende functie-schakelaar zijn ingeschakeld in Car Market Hub → Settings. Wanneer een functie is uitgeschakeld, markeert het scherm de shortcode met een Uitgeschakeld-badge.
Voor [as24ci_location_box] en [as24ci_hours_box] moet ten minste één locatie zijn geconfigureerd in Locaties en moeten de verkoper-ID's overeenkomen met het voertuig.

Stapsgewijze instructies

Een shortcode in een pagina invoegen

Open de pagina of het bericht in uw editor.
Voeg de shortcode in met behulp van de ingebouwde editor-functionaliteit: - Blokeditor (Gutenberg): voeg een Shortcode-blok toe. - Elementor: voeg een Shortcode-widget toe. - Divi, Beaver Builder, WPBakery: gebruik de shortcode- of tekstmodule. - Klassieke editor: typ de shortcode rechtstreeks in de inhoud.
Plak de gewenste shortcode (indien nodig met attributen).
Sla op en bekijk het voorbeeld.

De plugin laadt zijn eigen stijlen en scripts alleen op pagina's die een plugin-shortcode bevatten, zodat niet-gerelateerde pagina's niet worden beïnvloed.

De archiefpagina vooraf filteren bij het invoegen

Gebruik shortcode-attributen op [as24ci_archive], bijvoorbeeld:

[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]
[as24ci_archive fuel="electric" body="suv" per_page="12"]

Dynamische filtering aansturen via links of externe formulieren

Voeg GET-parameters toe aan de archief-URL (URL-parameters overschrijven shortcode-attributen):

/inventory/?make=BMW&max_price=20000
/inventory/?condition=new&sort=price_asc

Configuratiereferentie

Attributen voor `[as24ci_archive]`

Alle attributen zijn optioneel. URL-parameters overschrijven shortcode-attributen.

Attribuut	Beschrijving	Voorbeeld
`make`	Vooraf filteren op merk.	`make="BMW"`
`model`	Vooraf filteren op model (gebruik samen met `make`).	`model="3 Series"`
`price_min`	Minimumprijs (numeriek).	`price_min="10000"`
`price_max`	Maximumprijs (numeriek).	`price_max="40000"`
`fuel`	Brandstoftype, bijvoorbeeld `petrol`, `diesel`, `electric`.	`fuel="electric"`
`body`	Carrosserievorm, bijvoorbeeld `suv`, `sedan`, `coupe`.	`body="suv"`
`order_by`	Sorteerveld: `price`, `mileage` of `date` (standaard).	`order_by="price"`
`order`	Sorteerrichting: `asc` (standaard) of `desc`.	`order="asc"`
`per_page`	Items per pagina: `12`, `24` (standaard), `48`, `72`, `all`.	`per_page="12"`

Attributen voor `[as24ci_search_filter]`

Attribuut	Beschrijving	Voorbeeld
`results_url`	URL van de resultatenpagina. Standaard ingesteld op de voertuigarchief-URL van de plugin.	`results_url="/inventory/"`

`[as24ci_compare]`

Geen attributen. Plaats deze op een speciale vergelijkingspagina. Het instellingenscherm kan deze pagina automatisch aanmaken.

`[as24ci_favorites]`

Geen attributen. Plaats deze op een speciale favorieten- of verlanglijstpagina. Favorieten worden opgeslagen in de browser van de bezoeker via localStorage — er is geen account vereist en er worden geen gegevens naar de server verzonden.

Attributen voor `[as24ci_location_box]` en `[as24ci_hours_box]`

Attribuut	Beschrijving	Voorbeeld
`post_id`	ID van het voertuigbericht. Standaard ingesteld op het huidige bericht in de loop.	`post_id="123"`

De locatie die aan het voertuig is gekoppeld, wordt bepaald via het AutoScout24 Seller ID. Als er geen overeenkomst wordt gevonden, wordt de eerste (standaard) locatie uit Locaties gebruikt.

Ondersteunde URL-parameters

Deze parameters kunnen aan de archief-URL worden toegevoegd. URL-parameters overschrijven shortcode-attributen.

Parameter	Beschrijving	Voorbeeld
`make`	Filteren op merk.	`?make=BMW`
`model`	Filteren op model (vereist `make`).	`?model=3+Series`
`min_price` / `max_price`	Filteren op prijsbereik.	`?min_price=5000&max_price=20000`
`mileage_max`	Maximale kilometerstand.	`?mileage_max=80000`
`condition`	`all`, `new` of `used`.	`?condition=new`
`sort`	`price_asc`, `price_desc`, `mileage_asc`, `mileage_desc`.	`?sort=price_asc`
`per_page`	Items per pagina (`12`, `24`, `48`, `72`, `all`).	`?per_page=12`
`q`	Zoeken op trefwoord.	`?q=diesel`

Ondersteuning voor Builders & Editors

Ingebouwde shortcode-functionaliteiten in de Blokeditor (Gutenberg), Elementor, Divi / Beaver Builder / WPBakery en de Klassieke editor. De KPI-balk op het scherm meldt vier ondersteunde integratiefamilies.

Dashboard-widgets

De plugin voegt de volgende widgets toe aan het standaard WordPress dashboard:

Widget	Inhoud
CMH – Company Overview	Voertuigtellingen, importtijdstippen, leadtotalen en waarde van de voorraad.
CMH – AI and SEO Monitor	Wachtrij voor AI-teksten, wachtrij voor afbeelding-SEO en status van de API-verbinding.
CMH – Current Leads	Recente inkomende leadactiviteit voor uw voertuigen.
CMH – Car Performance	Meest bekeken voertuigen en interactie in één oogopslag.
CMH – Price Information	Momentopname van prijsinformatie voor uw voorraad.

Tabel Overzicht van shortcode-gebruik

De tabel Overzicht van shortcode-gebruik toont elke gepubliceerde pagina of bericht dat een plugin-shortcode bevat, met de volgende kolommen:

Kolom	Toont
Content Title	Titel van de pagina of het bericht.
Content Type	Of het item een pagina of een bericht is.
Shortcodes Used	Welke plugin-shortcode(s) de inhoud bevat.
Count	Hoeveel plugin-shortcodes er in die inhoud voorkomen.
Last Updated	Wanneer de pagina of het bericht voor het laatst is gewijzigd.
Actions	Een Bewerken-link die de pagina of het bericht in de editor opent.

Template-overrides

De uitvoer van shortcodes gebruikt dezelfde templates als de ingebouwde voertuig-CPT. Om een template te overschrijven, kopieert u het bestand naar de root van uw actieve thema; WordPress laadt uw versie automatisch.

Template	Gebruikt voor
`archive-as24ci_car.php`	Uitvoer van het voertuigarchief en de shortcode-lijst.
`single-as24ci_car.php`	Individuele voertuigdetailpagina.
`page-as24ci_compare.php`	Voertuigvergelijkingspagina.

Operationele opmerkingen

Overzicht van shortcode-gebruik scant tot de 100 meest recent gewijzigde gepubliceerde pagina's en berichten die een plugin-shortcode bevatten. Aangepaste berichttypen (CPT's) zijn standaard niet inbegrepen.
De KPI-tegel Shortcodes in gebruik telt het totale aantal keren dat shortcodes voorkomen binnen dezelfde scan.
De KPI-tegel Template-overrides telt de plugin-templates die momenteel worden overschreven door uw actieve thema.
Het uitschakelen van Vergelijken of Favorieten in de Instellingen verwijdert de shortcode niet uit uw inhoud; het markeert deze alleen als uitgeschakeld in deze referentie en kan de weergave aan de frontend onderdrukken. Schakel de functie opnieuw in om de shortcode weer actief te maken.

Problemen oplossen

Een shortcode wordt als platte tekst weergegeven. WordPress heeft de shortcode-verwerking niet uitgevoerd op dat veld. Plaats de shortcode in de hoofdinhoud van de pagina of het bericht, in een Shortcode-blok of in een builder-module die shortcodes ondersteunt.
Het archief toont alles ondanks een attribuut. Een URL-parameter overschrijft shortcode-attributen. Verwijder de URL-parameter of stem deze af op het gewenste filter.
[as24ci_compare] of [as24ci_favorites] lijkt leeg. Controleer of de bijbehorende functie is ingeschakeld in de Instellingen. Het scherm toont in dit geval ook een Uitgeschakeld-badge.
Locatie en openingstijden vallen terug op de standaardlocatie. Het Seller ID van het voertuig is niet toegewezen aan een locatie; voeg dit toe in Locaties.
Een thema-override wordt niet gedetecteerd. Het bestand moet zich in de root van de actieve (of child-) themamap bevinden en moet exact de hierboven vermelde bestandsnaam gebruiken.