Documentatie · Probleemoplossing
Veelgestelde vragen over probleemoplossing
Dit document beantwoordt de meest gestelde vragen over probleemoplossing voor de ADP Car Market Hub plugin. Volg de links naar de relevante documenten voor gedetailleerde stapsgewijze handleidingen.
Algemeen
Het plugin-menu ontbreekt in de WordPress admin na activering.
De plugin-admin is alleen toegankelijk voor WordPress gebruikers met de manage_as24_imports capability, die tijdens de activering aan de administrator rol wordt toegewezen. Log in als een WordPress beheerder. Als het menu nog steeds ontbreekt, deactiveer en activeer de plugin dan opnieuw om de toewijzing van de capability opnieuw uit te voeren. Zie Permission Errors.
Ik kan de plugin-admin zien, maar alle knoppen geven "Permission denied" (Toegang geweigerd).
Alle AJAX-acties en formulierinzendingen van de plugin controleren de manage_as24_imports capability. Als uw gebruikersaccount de status van beheerder heeft gekregen nadat de plugin was geactiveerd, is de capability mogelijk niet toegewezen. Deactiveer en activeer de plugin opnieuw, of vraag een super-admin om uw rol te controleren. Zie Permission Errors.
Hoe controleer ik wat de plugin aan het doen is?
Open het tabblad Logs in de plugin-admin. Het logboek registreert alle importruns, fouten, gedownloade afbeeldingen en systeemgebeurtenissen. Gebruik het tabblad System & Help voor een downloadbare diagnostische export (JSON of ZIP). Zie Cron Errors en Import Errors.
Licenties
Een functie toont "not active for this license" (niet actief voor deze licentie) of een heel tabblad is vervangen door een vergrendelingsscherm.
Verschillende functies (waaronder Market Insights, de AI Assistant en Content Studio) worden beheerd door uw ADP Car Market Hub plugin-licentie. Wanneer de licentie een functie niet bevat, toont die functie een vriendelijke melding "niet inbegrepen in deze licentie" en worden de bijbehorende acties niet uitgevoerd. Wanneer de licentie zelf niet operationeel is (bijvoorbeeld verlopen of niet geverifieerd), worden operationele acties zoals imports gepauzeerd en tonen de getroffen beheergedeelten een licentievergrendelingsscherm. Bestaande voertuigpagina's en -gegevens worden in geen van beide gevallen verwijderd. Neem contact op met de ondersteuning van ADP Car Market Hub om een functie in te schakelen of om een verlopen of opgeschorte licentie te herstellen. Zie Market Insights Issues.
Imports zijn gestopt en het logboek maakt melding van de licentie.
Wanneer de licentie is verlopen, opgeschort of niet kan worden geverifieerd na de respijtperiode, worden operationele acties zoals imports en de dagelijkse prijsanalyse gepauzeerd (ze "falen gesloten"). Er worden hierdoor geen berichten, meta-gegevens of media verwijderd. Herstel of vernieuw de licentie om de normale werking te hervatten.
Setup Wizard
De setup-melding "Welkom bij ADP Car Market Hub" verschijnt niet.
De melding wordt alleen getoond wanneer er een tijdstempel van de eerste activering is geregistreerd en de wizard nog niet is voltooid of overgeslagen, en de huidige gebruiker moet de beheercapability van de plugin hebben. Plugin-upgrades die geen nieuwe activering activeren, tonen de melding niet op bestaande installaties. U kunt de wizard altijd handmatig openen via Car Market Hub → Tools → Setup Wizard of via de link Run Setup Wizard op het Dashboard. Zie Setup Wizard Reference.
Ik heb de wizard overgeslagen. Hoe open ik deze opnieuw?
Open Car Market Hub → Tools en klik op de kaart Setup Wizard, of gebruik de link Run Setup Wizard bovenaan Car Market Hub → Dashboard. De wizard blijft bereikbaar via wp-admin/admin.php?page=as24ci-setup-wizard, zelfs nadat deze is overgeslagen of voltooid.
De wizard heeft mijn pagina's niet aangemaakt.
Ofwel is de optie Overslaan geselecteerd voor die pagina in Stap 4, is een bestaande pagina met dezelfde titel hergebruikt (de wizard ontdubbelt op basis van titel om duplicaten te voorkomen), of de bijbehorende optie (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) verwees al naar een gepubliceerde pagina. Open de WordPress Pages lijst om dit te controleren. De wizard verwijdert nooit bestaande pagina's.
Het veld Client Secret is leeg wanneer ik Stap 3 opnieuw open.
Dit is ontworpen gedrag. Het opgeslagen Client Secret wordt nooit opnieuw in de admin-HTML weergegeven, noch in de wizard, noch op het tabblad Settings. Als u het formulier verzendt terwijl het veld leeg is gelaten, blijft het bestaande opgeslagen geheim behouden. Het verzenden van een niet-lege waarde vervangt het.
Analytics is niet ingeschakeld na een Live-installatie.
In de Live-modus is de analytics-schakelaar standaard uitgeschakeld en moet deze expliciet worden ingeschakeld. Open de wizard opnieuw en vink de analytics-schakelaar aan bij Stap 5, of schakel analytics in op het tabblad Analytics. Controleer eerst de vereisten voor toestemming voor cookies en privacy. Zie Analytics Retention.
Demogegevens zijn niet geïnstalleerd.
Demogegevens worden alleen geïnstalleerd wanneer Demo setup is geselecteerd in Stap 1 en de wizard is voltooid met Install Demo Data and Finish in Stap 6. Een Live-installatie installeert geen demogegevens. Demogegevens kunnen ook op elk gewenst moment worden geïnstalleerd via de kaart Demo Data op Car Market Hub → Tools.
Vergelijkings- of favorietenpagina's zijn leeg na een demo-installatie.
Vergelijken en Favorieten zijn functies die de status aan de clientzijde bijhouden en lezen uit de localStorage van de browser van de bezoeker. Het demo-installatieprogramma biedt een fallback die de localStorage vult bij het eerste laden van de pagina. Open de pagina's Cars, Vergelijken of Favorieten eenmalig in dezelfde browsersessie om dit vullen te activeren.
Overschrijft de wizard mijn bestaande instellingen als ik deze opnieuw uitvoer?
Nee. De wizard schrijft alleen opties waarvan de beheerder de formuliervelden daadwerkelijk verzendt. Het halverwege opnieuw uitvoeren wist nooit een instelling die niet op het verzonden formulier stond. Het Client Secret blijft behouden wanneer het veld leeg wordt gelaten. Activering en heractivering van de plugin zijn eveneens niet-destructief.
API en verbinding
De verbindingstest mislukt met "Missing API credentials" (API-inloggegevens ontbreken).
De API Base URL, Client ID of het Client Secret is leeg of onjuist. Open het tabblad Settings van de plugin, controleer of alle drie de velden zijn ingevuld en sla de wijzigingen op. Zie API Connection Errors.
Het access token blijft verlopen en imports mislukken.
De plugin cachet het access token in de as24ci_access_token transient. Als het token-eindpunt een zeer korte expires_in-waarde retourneert, kan het token verlopen voordat de import is voltooid. Verwijder de transient via WP-CLI (wp transient delete as24ci_access_token) en probeer het opnieuw. Als het probleem zich blijft voordoen, neem dan contact op met uw API-provider om de geldigheidsduur van het token te controleren. Zie API Connection Errors.
De import retourneert nul voertuigen, hoewel mijn AutoScout24-account advertenties bevat.
De meest voorkomende oorzaken zijn: de Seller ID is onjuist, de advertenties zijn niet actief of live op AutoScout24, of de API-inloggegevens hebben geen toegang tot de geconfigureerde Seller ID. Controleer alle vier de instellingen (Base URL, Client ID, Client Secret, Seller ID) en controleer het logboek van de plugin op specifieke foutmeldingen. Zie API Connection Errors en Import Errors.
Importeren
Voertuigen worden geïmporteerd als concepten in plaats van automatisch te worden gepubliceerd.
De standaard status van het bericht is configureerbaar. Open het tabblad Importer of Settings van de plugin en controleer de instelling Default Post Status. Wijzig deze van draft naar publish als u wilt dat voertuigen direct na de import op de site verschijnen. Let op dat importeren als draft de voorzichtige standaardinstelling is bij nieuwe installaties. Zie Import Errors.
Sommige voertuigvelden zijn leeg na de import.
De import koppelt velden uit de API-respons aan WordPress post-meta met behulp van de veldmapping-configuratie van de plugin. Als een veld leeg is, bevat de AutoScout24-advertentie ofwel geen waarde voor dat veld, of is de veldmapping gewijzigd. Controleer het tabblad Field Mapping in de plugin-admin en controleer of de relevante velden correct zijn gekoppeld. Zie Import Errors.
De automatische import start niet.
Automatische imports vereisen dat de optie Auto Import is ingeschakeld en dat WP-Cron correct werkt. Open het tabblad Import & Limits → Automation om te controleren of automatische import is ingeschakeld en of er een schema is geconfigureerd. Controleer vervolgens het tabblad System & Help om te bevestigen dat de gebeurtenis as24ci_scheduled_import is ingepland. Als DISABLE_WP_CRON is ingesteld op true in wp-config.php, zal WP-Cron niet starten en moet er een externe cron-trigger worden geconfigureerd. Zie Cron Errors.
Afbeeldingen
Voertuigen worden geïmporteerd maar hebben geen afbeeldingen.
De import van afbeeldingen wordt beheerd door de schakelaar Import Images in de Importer-instellingen. Controleer of deze is ingeschakeld. Als deze is ingeschakeld maar er nog steeds afbeeldingen ontbreken, open dan het logboek van de plugin en zoek naar Image download failed of media_handle_sideload failed om de specifieke fout te identificeren. Veelvoorkomende oorzaken zijn onvoldoende schijfruimte, ontbrekende schrijfrechten op wp-content/uploads en PHP-geheugenlimieten. Zie Image Import Errors.
Sommige afbeeldingen ontbreken, terwijl andere succesvol zijn geïmporteerd.
De plugin verwerkt afbeeldingen via een achtergrondwachtrij (de image queue worker). Afbeeldingen die tijdens de hoofdimportrun niet konden worden gedownload, worden asynchroon opnieuw geprobeerd. Controleer het tabblad System & Help voor de grootte van de afbeeldingenwachtrij en de laatste runtime. U kunt de wachtrij ook handmatig starten met de knop Run Image Queue. Zie Image Import Errors.
Geconverteerde WebP-afbeeldingen worden niet gegenereerd.
WebP-conversie vereist ofwel de GD-extensie met imagewebp-ondersteuning of de Imagick-extensie. Controleer of een van deze beschikbaar is op uw server (controleer Gereedschap → Sitetest → Info → Server in WordPress). WebP-conversie is standaard uitgeschakeld. Schakel dit in bij de Importer-instellingen wanneer uw server dit ondersteunt. Zie Image Import Errors.
Frontend-weergave
De voertuigarchiefpagina toont een 404-fout.
De meest voorkomende oorzaak is dat de WordPress permalink-rewriterules moeten worden vernieuwd. Ga naar Instellingen → Permalinks en klik op Wijzigingen opslaan zonder wijzigingen aan te brengen. Dit genereert de rewriterules opnieuw. Zie Frontend Display Issues.
De voertuigoverzichtspagina toont geen voertuigen, hoewel er wel voertuigen zijn geïmporteerd.
Voertuigen moeten de status publish hebben om in het archief te verschijnen. Controleer of voertuigen de status concept hebben en publiceer ze. Controleer ook of er geen actieve filter of zoekopdracht is die resultaten verbergt, en of er geen caching-plugin is die een verouderde pagina serveert. Zie Frontend Display Issues.
De voertuigarchief- of detailpagina's zien er defect of ongestijld uit.
De plugin laadt zijn CSS en JavaScript alleen op pagina's waar een voertuig-shortcode aanwezig is in post_content, of op standaard CPT-archief- en single-templates. Als uw thema een pagebuilder of een aangepast template gebruikt dat post_content niet rechtstreeks rendert, worden de assets mogelijk niet geladen. Voeg de shortcode [as24ci_archive] rechtstreeks toe aan het veld voor de pagina-inhoud. Zie Frontend Display Issues en Shortcode Issues.
Shortcodes
Een shortcode wordt als platte tekst op de pagina weergegeven.
De verwerking van shortcodes is in sommige contexten uitgeschakeld (bijvoorbeeld pagebuilders, widgetgebieden of aangepaste templatebestanden die do_shortcode niet aanroepen). Controleer of de shortcode in het standaard WordPress Inhoud-veld van een pagina of bericht is geplaatst, en niet in een widget, aangepast veld of PHP-template. Zie Shortcode Issues.
De shortcode [as24ci_archive] toont niets.
Als de shortcode op de juiste positie staat maar niets toont, is de meest waarschijnlijke oorzaak dat er geen gepubliceerde voertuigen bestaan. Controleer of er voertuigen zijn geïmporteerd en gepubliceerd. Controleer ook of de attribuutwaarden van de shortcode geldig zijn — per_page moet bijvoorbeeld een positief geheel getal zijn. Zie Shortcode Issues.
E-mail en Leads
Er komt geen e-mail binnen wanneer een bezoeker een aanvraagformulier verzendt.
De plugin verzendt notificatie-e-mails via wp_mail(). Als er geen e-mail binnenkomt, controleer dan of uw WordPress-site correct is geconfigureerd voor e-mailbezorging. Veel hostingomgevingen vereisen een SMTP-plugin om betrouwbaar e-mail te verzenden. Controleer ook of het ontvangersadres dat is geconfigureerd in de plugin-instellingen correct is en niet wordt gefilterd door een spammaf. Zie E-mail- en leadfouten.
De lead is opgeslagen in het Leads-beheer, maar er is geen e-mailnotificatie verzonden.
Leadgegevens worden opgeslagen in het custom post type as24ci_lead, ongeacht de e-mailbezorging. E-mailbezorging is een afzonderlijk proces. Controleer de configuratie van het ontvangersadres (globale override-instelling → e-mailadres van verkopersprofiel → e-mailadres van auteur van het bericht → fallback naar WordPress-beheerders-e-mailadres) en test met een eenvoudige SMTP-bezorgingsplugin. Zie E-mail- en leadfouten.
Het contactformulier geeft een validatiefout, maar alle velden lijken te zijn ingevuld.
Het formulier valideert naam, e-mailadres, bericht en de toestemmings-checkbox aan de serverzijde. Een honeypot-antispamveld moet ook leeg zijn. Als de fout aanhoudt, heeft een automatische invulfunctie van de browser mogelijk het honeypotveld ingevuld, of verstoort een JavaScript-conflict de werking van het formulier. Probeer het formulier te verzenden in een privébrowservenster zonder actieve extensies. Zie E-mail- en leadfouten.
Market Insights
Alle voertuigen tonen no_data in de kolom Market Score.
De status no_data wordt geretourneerd wanneer er geen prijs voor een voertuig is opgeslagen (_as24ci_price is leeg of nul). Controleer of voertuigen met een prijs zijn geïmporteerd. Als dat zo is, voer de import dan opnieuw uit of activeer de prijsanalyse handmatig door de plugin te deactiveren en opnieuw te activeren. Zie Market Insights-problemen.
Days on Lot toont 0 of een onverwacht hoog getal.
Een waarde van 0 kan betekenen dat het voertuig vandaag is gepubliceerd of een geplande publicatiedatum in de toekomst heeft. Zeer grote waarden duiden op een beschadigde publicatiedatum (bijvoorbeeld geïmporteerd uit een record met een nuldatum). Controleer de publicatiedatum van het voertuig in de tabel met de berichtenlijst. Zie Market Insights-problemen.
PDF Datasheet
De datasheet-URL (?as24ci_pdf=123) retourneert een 404-fout.
Ofwel de PDF Datasheet-functie is niet ingeschakeld, de post-ID is onjuist, of het voertuig heeft niet de status publish. Schakel de functie in de plugin-instellingen in, flush de permalinks en controleer of het voertuig is gepubliceerd. Zie PDF Datasheet-problemen.
De datasheet toont geen afbeeldingen.
Controleer of er afbeeldingen zijn geïmporteerd voor het voertuig en of de schakelaar Show Gallery is ingeschakeld in de instellingen van de PDF Manager. De datasheet toont maximaal 5 afbeeldingen. Zie PDF Datasheet-problemen.