Documentatie · Beheerdersreferentie
Instellingenreferentie
Dit document is een referentie voor het Instellingen-scherm van de ADP Car Market Hub-plugin (Car Market Hub → Settings). Het legt elke kaart op de pagina uit, wat elk veld regelt en hoe de waarden worden gevalideerd en opgeslagen.
Wanneer u dit document moet gebruiken
Gebruik deze referentie wanneer u de plugin voor de eerste keer configureert, wanneer u wilt opzoeken wat een specifieke optie doet, of wanneer u problemen oplost met gedrag dat afhankelijk is van een instelling.
Overzicht
Het Instellingen-scherm is georganiseerd als een verticale stapel kaarten. Elke kaart heeft zijn eigen Instellingen opslaan-knop, maar het verzenden van een van deze knoppen slaat de hele pagina op. De pagina is onderverdeeld in de volgende secties:
- Licentie en activering (bovenaan de pagina weergegeven)
- API-verbinding & Algemene instellingen
- Standaardpagina's & Shortcodes
- SEO & Integraties
- Frontend-functies
- Beheerdersfuncties
- Gevarenzone
Vereisten of randvoorwaarden
- Toegang tot Car Market Hub → Instellingen (hiervoor is de beheersbevoegdheid van de plugin vereist).
- Voor de API-verbinding: geldige inloggegevens verstrekt door uw gegevensleverancier (AutoScout24 of een compatibel integratie-eindpunt). Deze worden niet door de plugin geleverd en moeten afzonderlijk worden verkregen.
- Voor standaardpagina's: toestemming om WordPress-pagina's aan te maken.
Stapsgewijze instructies
- Open Car Market Hub → Instellingen.
- Vul de kaart API-verbinding & Algemene instellingen in met de URL, Seller ID en inloggegevens die door uw leverancier zijn verstrekt, en kies vervolgens de standaardvaluta.
- Sla op en controleer of er geen validatiefouten bovenaan het scherm staan.
- Schakel optioneel Standaardpagina's maken bij opslaan in, zodat de plugin automatisch de pagina's Auto's, Vergelijken en Favorieten aanmaakt. Voeg anders de bijbehorende shortcodes handmatig in op de pagina's van uw keuze.
- Bekijk de kaarten SEO & Integraties, Frontend-functies and Beheerdersfuncties en schakel de functies in die u nodig hebt.
- Schakel alleen items in de Gevarenzone in nadat u de waarschuwingen zorgvuldig hebt gelezen en eventueel een back-up hebt gemaakt.
Configuratiereferentie
Licentie en activering
De Licentie-kaart is de eerste kaart op de Instellingen-pagina. ADP Car Market Hub is een gelicentieerd product: de licentie ontgrendelt de premium-onderdelen (zoals AI Assistant, Content Studio en Market Insights) en maakt updates en ondersteuning mogelijk. De licentiesleutel wordt geleverd door AD Promotion.
Hoe licentiëring werkt, stap voor stap:
- Activeer de licentie. Plak de door AD Promotion geleverde sleutel in het veld Licentiesleutel en klik op Activeren. De plugin neemt contact op met de licentieservice, valideert de sleutel voor het domein van deze site en slaat deze gemaskeerd op. Als u ooit opnieuw een sleutel invoert, geeft de knop Opnieuw activeren aan.
- Controleer de status op elk gewenst moment. Klik op Licentie nu controleren om de licentieservice om de nieuwste status te vragen. De kaart vernieuwt vervolgens de Status (bijvoorbeeld Actief, Inactief, Geschorst of Verlopen), het pakket, de verloop-/ondersteuningsdata en de inbegrepen functies. Dezelfde licentiestatus wordt ook weergegeven als een KPI-tegel op het Dashboard en het Ondersteuning-scherm, zodat u deze kunt zien zonder de Instellingen te openen.
- Bekijk welke functies zijn ontgrendeld. Wanneer de licentie actief is, toont de kaart een rij Inbegrepen functies met de premium-onderdelen die uw licentie dekt (bijvoorbeeld AI Assistant, Content Studio, Market Insights). Elk premium-scherm weerspiegelt dit ook direct: als een onderdeel is inbegrepen, toont het de normale bedieningselementen, en als het niet is inbegrepen, toont het in plaats daarvan een kaart met "niet inbegrepen in deze licentie".
- Opnieuw activeren of verwijderen. Gebruik Opnieuw activeren na een pakketwijziging om de nieuwe rechten op te halen, of Licentie verwijderen om de opgeslagen sleutel van deze site te wissen (premium-onderdelen worden dan weer vergrendeld).
Het meeste hiervan draait automatisch op de achtergrond: de plugin controleert de licentie periodiek opnieuw en houdt de status actueel, dus handmatig Licentie nu controleren is voornamelijk bedoeld om een wijziging onmiddellijk te bevestigen.
| Element | Opmerkingen |
|---|---|
| Licentiesleutel | Voer de door AD Promotion geleverde sleutel in en klik op Activeren (of Opnieuw activeren). De sleutel wordt gemaskeerd opgeslagen en gekoppeld aan het domein van deze site; de volledige sleutel wordt nooit meer weergegeven. |
| Status | De huidige licentiestatus, bijvoorbeeld Actief, Inactief, Geschorst of Verlopen. |
| Licentie nu controleren | Controleert de licentie opnieuw bij de licentieservice en vernieuwt de status, het pakket en de inbegrepen functies. Beschikbaar zodra er een sleutel is opgeslagen. |
| Licentie verwijderen | Verwijdert de opgeslagen sleutel van deze site. Premium-functies die afhankelijk zijn van de licentie worden weer vergrendeld. |
Wanneer een sleutel actief is, toont de kaart ook alleen-lezen details: Pakket, Verloopt, Ondersteuning tot, Domein, Laatst gecontroleerd, Gerapporteerde versie, de importlimiet en de lijst met Inbegrepen functies. Dezelfde licentiestatus wordt ook als een KPI weergegeven op het Dashboard en het Ondersteuning-scherm.
Premium-onderdelen die geen deel uitmaken van uw licentie tonen een kaart met "niet inbegrepen in deze licentie" op hun eigen pagina in plaats van de normale bedieningselementen (zie AI Assistant-referentie, Beheerdersreferentie voor de Content Studio en Beheerdersreferentie voor Market Insights). Er is in die status niets kapot — neem contact op met de ondersteuning van ADP Car Market Hub om het onderdeel in te schakelen.
API-verbinding & Algemene instellingen
| Veld | Type | Opmerkingen |
|---|---|---|
| API Base URL | URL | Volledige URL inclusief https://. Server-side gevalideerd; slashes aan het einde worden verwijderd. Ongeldige URL's worden geweigerd en de vorige waarde wordt behouden. |
| Seller ID | Tekst | Een of meer Seller IDs gescheiden door komma's, spaties of puntkomma's. Alleen letters, cijfers, underscores en koppeltekens blijven behouden na opschoning. |
| Client ID | Tekst | Client-ID in OAuth-stijl geleverd door uw leverancier. |
| Client Secret | Wachtwoordveld | Opgeslagen als platte optietekst in de database; behandel het veld dienovereenkomstig. De invoer wordt weergegeven als een wachtwoordveld om meekijken te voorkomen. |
| Standaardvaluta | Selectie | Kies een van de ondersteunde ISO 4217-codes: BGN, CHF, CZK, DKK, EUR, GBP, HUF, NOK, PLN, RON, RUB, SEK, TRY, UAH. Onbekende waarden vallen terug op EUR. |
Wanneer inloggegevens veranderen, wist de plugin zijn gecachte toegangstoken en de gecachte API-verbindingsstatus, zodat de volgende paginalaadactie de nieuwe configuratie weerspiegelt.
Standaardpagina's & Shortcodes
| Veld | Type | Opmerkingen |
|---|---|---|
| Standaardpagina's maken bij opslaan | Schakelaar | Indien aangevinkt en opgeslagen, worden ontbrekende pagina's voor Auto's, Auto's vergelijken en Favorieten aangemaakt. Bestaande pagina's worden niet overschreven. |
De kaart toont ook shortcodes die klaar zijn om te kopiëren:
[as24ci_archive]— voertuigoverzicht.[as24ci_compare]— vergelijkingspagina.[as24ci_favorites]— favorieten- / verlanglijstpagina.[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]— voorbeeld van een vooraf gefilterd overzicht.
Ondersteunde [as24ci_archive]-parameters zoals gedocumenteerd in het beheer: make, model, price_min, price_max, fuel, body, order_by (price / mileage / date), order (asc / desc), per_page (12 / 24 / 48 / 72 / all).
SEO & Integraties
| Veld | Standaard | Opmerkingen |
|---|---|---|
| Schema.org & Open Graph | Aan | Genereert JSON-LD gestructureerde gegevens en Open Graph / Twitter Card meta-tags op individuele voertuigpagina's. |
| XML Sitemap-integratie | Aan | Voegt voertuigberichten toe aan de kern-sitemaps van WordPress met de juiste lastmod-data. Het beheerderslabel vermeldt compatibiliteit met Yoast SEO en Rank Math. |
| REST API | Uit | Indien ingeschakeld, registreert dit GET /wp-json/as24ci/v1/vehicles en GET /wp-json/as24ci/v1/vehicles/{id} voor externe toegang. |
Frontend-functies
| Veld | Standaard | Opmerkingen |
|---|---|---|
| Favorieten / Verlanglijst | Aan | Voegt favorietenpictogrammen toe aan het archief en de zwevende zijbalk op individuele pagina's. De favorietenpagina kan worden ingesloten met [as24ci_favorites]. De implementatie is gebaseerd op localStorage. |
| Voertuig vergelijken | Aan | Voegt vergelijkingsknoppen toe aan het archief en individuele pagina's. Geselecteerde voertuigen kunnen worden weergegeven via [as24ci_compare]. |
| Financieringscalculator | Uit | Indien ingeschakeld, kan de calculator via de Layout Manager worden geplaatst in Individueel voertuig – Zijbalk, Individueel voertuig – Hoofdinhoud, of Individueel voertuig – Onderste sectie. |
| Jaarlijkse rentevoet (%) | 3.9 | Toegestaan bereik 0–50, stap 0.1. |
| Looptijd lening (maanden) | 48 | Toegestane waarden: 12, 24, 36, 48, 60, 72, 84. |
| Aanbetaling (%) | 20 | Toegestaan bereik 0–100. |
De financieringswaarden zijn standaardwaarden die vooraf zijn ingevuld in de calculator op de frontend; bezoekers kunnen deze aanpassen als het calculatorsjabloon dit toestaat.
Beheerdersfuncties
| Veld | Standaard | Opmerkingen |
|---|---|---|
| Dashboard-widget | Aan | Toont de widget met het overzicht van voertuigstatistieken op het WordPress-dashboard. |
| Bulkacties | Aan | Voegt de bulkacties 'Instellen als concept', 'Instellen als gepubliceerd' en 'Verwijderen met afbeeldingen' toe aan de voertuiglijsttabel. |
| Voertuigexport | Aan | Schakelt CSV- / JSON-export van voertuiggegevens in op het tabblad Gereedschap. |
Gevarenzone
| Veld | Standaard | Opmerkingen |
|---|---|---|
| Geïmporteerde auto's en geïmporteerde afbeeldingen verwijderen wanneer de plugin wordt verwijderd | Uit | Indien ingeschakeld, verwijdert het de-installeren van de plugin de Cars custom post type-items en hun geïmporteerde bijlagen. Pagina's die door de plugin zijn gemaakt, worden niet automatisch verwijderd. |
Operationele opmerkingen
- Elke kaart heeft zijn eigen verzendknop, maar elke verzending verzendt het volledige formulier. Het opslaan van een kaart slaat elk veld op de pagina op.
- API-inloggegevens worden opgeslagen in de WordPress-optietabel. Iedereen met toegang tot de database of beheerdersexport kan ze lezen; beveilig de site dienovereenkomstig.
- Het inschakelen van de financieringscalculator plaatst deze niet automatisch op de pagina — de plaatsing wordt geregeld in de Layout Manager.
- De REST API-schakelaar regelt alleen de openbare voertuigeindpunten. Interne admin AJAX-eindpunten die door de plugin worden gebruikt, worden niet beïnvloed door deze schakelaar.
- De actie "Standaardpagina's maken bij opslaan" wordt alleen uitgevoerd als het selectievakje is ingeschakeld op het moment dat u opslaat. Het later uitschakelen ervan verwijdert eerder gemaakte pagina's niet.
Problemen oplossen
- Foutmelding "De API Base URL is geen geldige URL". De waarde is niet geslaagd voor
FILTER_VALIDATE_URL. Voer de volledige URL in inclusief het protocol (https://) en zonder extra tekens. De vorige waarde wordt behouden totdat een geldige URL wordt opgegeven. - Imports retourneren 401 / 403 fouten na het opslaan van inloggegevens. Controleer de Client ID, Client Secret en Seller ID bij uw leverancier. De tokencache wordt gewist bij het opslaan, dus het volgende verzoek gebruikt de nieuwe waarden.
- Standaardpagina's zijn niet aangemaakt. De schakelaar werkt alleen op het moment van opslaan. Zorg ervoor dat de schakelaar is ingeschakeld wanneer u op Opslaan klikt, en dat de WordPress-gebruiker toestemming heeft om pagina's aan te maken.
- Valuta verandert niet in de frontend. Het veld slaat een standaardwaarde op. Valuta's per voertuig die van de gegevensleverancier komen, kunnen de weergave overschrijven, afhankelijk van de actieve sjablonen. Controleer dit gedrag in de huidige plugin-versie voordat u publiceert.
- Financieringscalculator is ingeschakeld maar niet zichtbaar. Voeg het blok Financieringscalculator toe aan een van de zones voor Individueel voertuig in de Beheerdersreferentie voor de Layout Manager. Het Instellingenscherm waarschuwt niet over plaatsing; het toont alleen een statische beschrijving die naar de Layout Manager verwijst. Om te voorkomen dat de calculator twee keer verschijnt, moet u ervoor zorgen dat deze aan slechts één zone voor Individueel voertuig is toegevoegd.