Documentatie · Release Notes
Bekende beperkingen
Dit document bevat een overzicht van de bekende beperkingen van de ADP Car Market Hub-plugin in de huidige release.
Wanneer u dit document moet gebruiken
Lees dit document bij het plannen van een implementatie, bij het voorbereiden van een risicoanalyse voor de klant, of bij het oplossen van problemen met gedrag dat mogelijk een gedocumenteerde beperking is in plaats van een bug.
De gedetailleerde technische analyse is te vinden in Bekende beperkingen en open risico's. Deze pagina is een kortere samenvatting bedoeld voor lezers van de release notes.
Overzicht
De plugin is gebouwd op standaard WordPress-mechanismen (custom post types, taxonomieën, aangepaste tabellen, WP-Cron, REST en AJAX). De meeste beperkingen vloeien voort uit deze ontwerpkeuzes en uit de diensten van derden waarmee de plugin optioneel kan worden geïntegreerd.
De onderstaande informatie beschrijft het gedrag dat in de huidige broncode is waargenomen. Controleer elk punt met de huidige plugin-versie voordat u dit in een klantcontract opneemt.
Operationele beperkingen
- Afhankelijkheid van WP-Cron. Geplande imports, de afbeeldingenwachtrij, de AI Assistant-wachtrij en het opschonen van analytics-gegevens zijn allemaal afhankelijk van de activering van WP-Cron. WP-Cron is verzoekgestuurd en kan te laat of helemaal niet worden uitgevoerd op websites met weinig verkeer. Gebruik een echte systeem-cron (die
wp-cron.phpof hetcron-importREST-eindpunt aanroept) voor voorspelbaar gedrag. - Gelijktijdigheidsvergrendelingen (concurrency locks). Import- en afbeeldingenwachtrij-runs maken gebruik van tijdelijke vergrendelingen (
as24ci_cron_import_running,as24ci_image_queue_running). Als een worker vastloopt (PHP-fatal error, hosting-timeout) kan de vergrendeling de procesduur overschrijden. Verouderde vergrendelingen worden automatisch gewist zodra de TTL verloopt; handmatige verwijdering is alleen nodig als u een nieuwe run eerder wilt forceren. - Geheugen- en runtimebudgetten. Zeer grote imports (duizenden voertuigen per run, of voertuigen met veel afbeeldingen) kunnen de PHP-geheugenlimieten of
max_execution_time-limieten op gedeelde hostingpakketten overschrijden. Pas de cron-modus en de limieten voor voertuigen en afbeeldingen per run dienovereenkomstig aan. - Handmatige bewerkingen van geïmporteerde velden. Door de importer beheerde velden kunnen bij de volgende import worden overschreven. Gebruik de handmatige overschrijvingslaag of de handmatige galerijpositie voor inhoud die na herimport behouden moet blijven.
- Inline-modus met één afbeelding voor cron-imports. Als de afbeeldingenwachtrij is ingeschakeld (aanbevolen standaard), wordt tijdens een cron-import alleen de eerste afbeelding per voertuig inline gedownload. De overige afbeeldingen worden verwerkt door de asynchrone worker. Als de worker niet actief is, verschijnen deze afbeeldingen pas zodra deze wel draait.
Beveiligings- en toegangsbeperkingen
- Inloggegevens worden opgeslagen in
wp_options. Het AutoScout24 Client Secret en het gedeelde webhook-geheim worden versleuteld opgeslagen (encrypted at rest), en het cron-token wordt opgeslagen als een eenrichtings-HMAC-hash; andere instellingen en optiewaarden worden opgeslagen als gewone opties. Behandel databaseback-ups alsof ze geheimen bevatten en roteer inloggegevens na elk vermoeden van misbruik. De beheerde Gemini API-sleutel die door de AI Assistant wordt gebruikt, wordt niet ingevoerd of opgeslagen als een WordPress-optie: deze wordt centraal klaargezet via het ADP Car Market Hub API Platform en als een versleutelde, aan de licentie gekoppelde inloggegeven aan de site geleverd. Klanten voeren deze sleutel nooit in en krijgen deze ook niet te zien. - Afhankelijkheid van capabilities. Beheerpagina's van de plugin vereisen de
manage_as24_imports-capability (standaard toegewezen aan beheerders). Plugins voor rolbeheer die deze capability intrekken, sluiten beheerders uit van het plugin-beheer. - Openbare REST-eindpunten staan standaard uit en mogen alleen worden ingeschakeld als de afnemers ervan bekend zijn. De eindpunten voor favorieten en analytics zijn ontworpen om openbaar te zijn wanneer de bijbehorende functies zijn ingeschakeld, maar passen invoervalidatie toe.
Privacy- en nalevingsbeperkingen
- Analytics is opt-in maar registreert, eenmaal ingeschakeld, interacties van bezoekers in een aangepaste tabel. De modus voor verplichte toestemming is beschikbaar, maar staat standaard op toestaan wanneer er geen toestemmingsintegratie is gekoppeld aan het
as24ci_analytics_consent_check-filter. Controleer de verwerking van toestemmingen voor uw rechtsgebied voordat u analytics inschakelt. - Zoekalerts slaan persoonlijke gegevens op (e-mailadres en zoekcriteria). De
as24ci_search_agents-tabel wordt verwijderd bij de-installatie, maar klanten moeten tijdens normaal gebruik nog steeds voldoen aan hun eigen verplichtingen voor het verwijderen van gegevens op verzoek. - AI Assistant verzendt voertuiggegevens naar het beheerde Gemini-eindpunt. Indien ingeschakeld, worden prompts en de context van de advertentie verzonden naar de beheerde Google Gemini-configuratie in ADP Car Market Hub. Controleer de toepasselijke gegevensverwerking en contractuele voorwaarden voor de beheerde AI-configuratie voordat u AI-functies in productie neemt.
- QR-codes op PDF datasheets maken standaard gebruik van een externe dienst. Vervang deze door een lokaal gehoste generator via het
as24ci_pdf_qr_image_url-filter als externe verzoeken in afdrukbare documenten niet acceptabel zijn. - E-mailverzending maakt gebruik van
wp_mail(). Of een melding de ontvanger bereikt, hangt af van de geconfigureerde mailer en van externe factoren voor afleverbaarheid. De plugin registreert een best-effort status, maar garandeert de aflevering niet.
Externe afhankelijkheden
- Beschikbaarheid van de AutoScout24-API. Netwerkfouten en storingen bij de provider worden in de importlogs weergegeven als mislukte runs; geen inkomende gegevens betekent geen nieuwe voertuigen, zelfs niet als WP-Cron volgens schema wordt uitgevoerd.
- Browsergestuurde PDF-generatie. Het PDF datasheet is afhankelijk van de print-engine van de browser van de bezoeker. De precisie van de lay-out verschilt per browser.
- Beheerd eindpunt voor AI. Onderhevig aan Google Gemini-limieten, modelafschrijvingen en prijswijzigingen buiten de controle van de plugin.
- Webhook-ontvangers. Aanhoudende uitval van de ontvanger kan ertoe leiden dat gebeurtenissen verloren gaan; de plugin probeert mislukte leveringen een beperkt aantal keren opnieuw uit te voeren. Ontwerp ontvangers zo dat ze idempotent zijn en snel bevestigen.
Kanttekeningen bij de documentatie
- Deze documentatie beschrijft het gedrag dat in de huidige broncode is waargenomen. Waar de broncode geen uitsluitsel gaf, gebruikt de tekst voorzichtige bewoordingen zoals "controleer met de huidige plugin-versie alvorens te publiceren".
- Standaard model-ID's, ondersteunde talen en standaardopties kunnen tussen releases wijzigen. Neem bij het publiceren van materiaal voor klanten de waarden over uit de actuele broncode van de plugin in plaats van deze documentatie letterlijk te kopiëren.
Maatregelen
- Configureer een externe systeem-cron om
wp-cron.phpof hetcron-importREST-eindpunt aan te roepen om gepland werk te isoleren van weinig websiteverkeer. - Configureer externe databaseback-ups met de juiste versleuteling en toegangscontroles.
- Koppel de plugin aan een SMTP- of transactionele e-mailintegratie voor betrouwbare leadmeldingen.
- Gebruik een staging-omgeving om AI-prompts, PDF-sjablonen en webhook-ontvangers te valideren voordat u wijzigingen in productie doorvoert.
- Controleer welke rollen over de
manage_as24_imports-capability beschikken en welke externe diensten zijn gekoppeld.