Documentatie · Beheerdersreferentie
Referentie voor shortcodes en widgets
Dit document is een referentie voor het scherm Shortcodes & Widgets van de ADP Car Market Hub-plugin (CMH Center → Shortcodes & Widgets). Het documenteert elke shortcode die de plugin registreert, de ondersteunde attributen en URL-parameters, de integraties met editors en pagebuilders en de dashboard-widgets die met de plugin worden meegeleverd.
Wanneer dit document te 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 insluiten.
- 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 van de bezoeker (items worden aan de clientzijde opgeslagen in localStorage). |
[as24ci_location_box] | Contactkaart voor de dealervestiging die aan een voertuig is gekoppeld. |
[as24ci_hours_box] | Openingstijdenkaart voor de dealervestiging die aan een voertuig is gekoppeld. |
Elke shortcode wordt ook op het scherm vermeld als een eigen item met een speciale knop Kopiëren en een uitklapbaar gedeelte Attributen & voorbeelden dat 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- / pagebuilder-integratiefamilies beschikbaar zijn. |
| Pagina's die plugin gebruiken | Aantal gepubliceerde pagina's en berichten die ten minste één plugin-shortcode bevatten. |
| Template-overschrijvingen | 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 die gepubliceerde pagina's en berichten vermeldt die een plugin-shortcode bevatten (tot de meest recente 100 resultaten), en een kaart Ontwikkelaarsnotities die template-overschrijvingen en ondersteunde URL-parameters documenteert.
Vereisten of randvoorwaarden
- Een gebruiker met een rol die pagina's of berichten kan bewerken.
- Voor
[as24ci_compare]en[as24ci_favorites]moet de bijbehorende functieschakelaar zijn ingeschakeld inCMH Center → Settings. Wanneer een functie is uitgeschakeld, markeert het scherm de shortcode met een Uitgeschakeld-badge. - Voor
[as24ci_location_box]and[as24ci_hours_box]moet ten minste één locatie zijn geconfigureerd in Locaties en moeten de Seller IDs overeenkomen met het voertuig.
Stapsgewijze instructies
Een shortcode in een pagina insluiten
- Open de pagina of het bericht in uw editor.
- Voeg de shortcode in met behulp van de ingebouwde editor-optie: - 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.
Het archief vooraf filteren op het moment van 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_ascConfiguration reference
[as24ci_archive] attributen
Alle attributen zijn optioneel. URL-parameters overschrijven shortcode-attributen.
| Attribuut | Beschrijving | Voorbeeld |
|---|---|---|
make | Voorfilteren op merk. | make="BMW" |
model | Voorfilteren 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" |
[as24ci_search_filter] attributen
| 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.
[as24ci_location_box] en [as24ci_hours_box] attributen
| Attribuut | Beschrijving | Voorbeeld |
|---|---|---|
post_id | ID van het voertuigbericht. Standaard ingesteld op het huidige bericht in de loop. | post_id="123" |
De vestiging die aan het voertuig is gekoppeld, wordt bepaald door de 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 en editors
Systeemeigen shortcode-besturingselementen in Block Editor (Gutenberg), Elementor, Divi / Beaver Builder / WPBakery en de Classic Editor. De KPI-balk op het scherm rapporteert vier ondersteunde integratiefamilies.
Dashboard-widgets
De plugin voegt de volgende widgets toe aan het standaard WordPress-dashboard:
| Widget | Inhoud |
|---|---|
| CMH – Company Overview | Voertuigaantallen, importtijdstippen, leadtotalen en portfoliowaarde. |
| CMH – AI and SEO Monitor | AI-tekstwachtrij, afbeelding-SEO-wachtrij en API-verbindingsstatus. |
| CMH – Current Leads | Recente inkomende leadactiviteit voor uw voertuigen. |
| CMH – Car Performance | Meest bekeken voertuigen en betrokkenheid in één oogopslag. |
| CMH – Price Information | Momentopname van prijsinformatie voor uw voorraad. |
Shortcode-gebruiksoverzichtstabel
De tabel met het gebruiksoverzicht toont elke gepubliceerde pagina of elk gepubliceerd 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 | Hoe vaak de plugin-shortcode voorkomt in die inhoud. |
| Last Updated | Wanneer de pagina of het bericht voor het laatst is gewijzigd. |
| Actions | Een Bewerken-link die de pagina of het bericht opent in de editor. |
Template-overschrijvingen
De uitvoer van shortcodes maakt gebruik van dezelfde templates als de systeemeigen voertuig-CPT. Om een template te overschrijven, kopieert u het bestand naar de hoofdmap van uw actieve thema; WordPress laadt uw versie automatisch.
| Template | Gebruikt voor |
|---|---|
archive-as24ci_car.php | Voertuigarchief en shortcode-lijstuitvoer. |
single-as24ci_car.php | Individuele voertuigdetailpagina. |
page-as24ci_compare.php | Voertuigvergelijkingspagina. |
Operational notes
- Shortcode-gebruiksoverzicht 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-overschrijvingen telt de plugin-templates die momenteel door uw actieve thema worden overschreven.
- 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.
Troubleshooting
- 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 standaardvestiging. De seller ID van het voertuig is niet aan een locatie toegewezen; voeg deze toe in Locaties.
- Een thema-overschrijving wordt niet herkend. Het bestand moet zich in de hoofdmap van de actieve (of child-) themamap bevinden en moet exact de hierboven vermelde bestandsnaam gebruiken.