Problemen adres aanvulling door Custom Fields plugin

Je hebt de ApiCheck WooCommerce-plugin geïnstalleerd, maar de adresaanvulling werkt niet. Straatnaam en plaatsnaam worden niet automatisch ingevuld. Kans groot dat een Custom Fields-plugin de schuldige is.

Het probleem

WooCommerce gebruikt standaard veldnamen voor adresvelden: billing_address_1, billing_city, billing_postcode, enzovoort. ApiCheck koppelt aan die standaardnamen.

Custom fields-plugins zoals Checkout Field Editor, WooCommerce Custom Fields of Flexible Checkout Fields kunnen die veldnamen wijzigen. Soms worden velden hernoemd, soms worden ze vervangen door nieuwe velden met andere ID's.

Als de veld-ID's niet overeenkomen met de ApiCheck-verwachting, worden de velden niet aangevuld.

Drie oorzaken

1. Gewijzigde veldnamen

De custom fields-plugin heeft de standaard WooCommerce-veldnamen vervangen door eigen namen. ApiCheck zoekt naar billing_address_1, maar dat veld heet nu checkout_street_address.

2. Persistente databasewijzigingen

Sommige plugins slaan hun instellingen op in de database. Zelfs na het deactiveren van de plugin blijven de gewijzigde veldnamen actief totdat je ze handmatig reset.

3. Conflicterende JavaScript

Beide plugins proberen hetzelfde formulierveld te controleren en vullen. Dit leidt tot race conditions waarbij de ene plugin de aanvulling van de andere overschrijft.

Oplossingen

Stap 1: Inspecteer de veldnamen

Open je browser DevTools (F12), ga naar het Elements-tabblad en zoek de input-velden van je checkout-formulier. Controleer of de id en name attributen overeenkomen met de WooCommerce-standaard.

Stap 2: Reset via WooCommerce

Ga naar WooCommerce → Status → Tools → Checkout fields en klik op Reset. Dit herstelt de standaard WooCommerce-veldnamen.

Stap 3: Verwijder cache

Verwijder de plugin-cache en de browser-cache. Herlaad de checkout-pagina en test opnieuw.

Stap 4: Gebruik compatibele plugins

Niet alle custom fields-plugins veroorzaken conflicten. Checkout Field Editor (door ThemeHigh) en Flexible Checkout Fields (door WP Desk) zijn bekend compatibel met ApiCheck.

Preventieve maatregelen

• Test wijzigingen altijd eerst op een staging-omgeving
• Maak een backup voor je plugins installeert of aanpast
• Documenteer welke veld-ID's je gebruikt, zodat je bij problemen snel terugkunt draaien

Conclusie

Conflicten tussen custom fields-plugins en ApiCheck zijn bijna altijd te herleiden tot gewijzigde veldnamen. Controleer de ID's in je DevTools en reset indien nodig naar de WooCommerce-standaard. Kom er niet uit? Neem contact op via support@apicheck.nl.