# Pluginconflicten Pluginconflicten zijn een van de meest voorkomende oorzaken van problemen met WCPOS. Wanneer andere WordPress-plugins de functionaliteit van WooCommerce of WCPOS verstoren, kun je crashes, prestatieproblemen of onverwacht gedrag ondervinden. ## Tekenen van pluginconflicten[​](#signs-of-plugin-conflicts "Directe link naar Tekenen van pluginconflicten") Je hebt mogelijk een pluginconflict als je het volgende ervaart: * **Fatale fouten** - "There has been a critical error on this website" * **Prestatieproblemen** - Traag laden, time-outs of hoge serverbelasting * **Functionaliteitsproblemen** - Functies werken niet zoals verwacht * **Synchronisatieproblemen met gegevens** - Producten, bestellingen of klanten synchroniseren niet correct * **Problemen met betaalgateways** - Afrekenfouten of fouten bij het verwerken van betalingen ## Voordat je begint: gebruik een staging-site[​](#before-you-start-use-a-staging-site "Directe link naar Voordat je begint: gebruik een staging-site") Belangrijk **Los pluginconflicten nooit op je live site op.** Gebruik altijd een staging-omgeving om verstoring van je bedrijfsvoering te voorkomen. ### Wat is een staging-site?[​](#what-is-a-staging-site "Directe link naar Wat is een staging-site?") Een staging-site is een exacte kopie van je live website waar je veilig wijzigingen kunt testen zonder je klanten te beïnvloeden. De meeste moderne hostingproviders bieden staging-omgevingen als standaardfunctie. ### Als je host geen staging aanbiedt[​](#if-your-host-doesnt-offer-staging "Directe link naar Als je host geen staging aanbiedt") Als je hostingprovider geen staging-sites aanbiedt, **overweeg dan om over te stappen naar een host die dat wel doet**. Dit is tegenwoordig een standaardfunctie en essentieel voor: * Veilig testen van plugins/thema's * WordPress-updates * Het oplossen van problemen * Ontwikkelingswerk **Aanbevolen hosts met staging:** * WP Engine * SiteGround * Kinsta * Cloudways * Vele anderen ## Stap 1: Controleer op fatale fouten[​](#step-1-check-for-fatal-errors "Directe link naar Stap 1: Controleer op fatale fouten") Als je crashes of kritieke fouten ondervindt, begin dan met het controleren van de foutlogs: 1. **Controleer WCPOS-logs** - Open het [Logs](/nl/support/logs.md)-scherm in WCPOS op eventuele foutmeldingen 2. **Controleer fatale-foutlogs** - Volg de [handleiding voor probleemoplossing bij kritieke fouten](/nl/support/troubleshooting/critical-error.md) om gedetailleerde foutmeldingen te vinden 3. **Noteer de foutdetails** - Zoek naar pluginnamen of bestandspaden die in de fout worden genoemd Als je een fatale fout vindt die een specifieke plugin noemt, is dat waarschijnlijk je boosdoener. Je kunt die plugin uitschakelen en testen of het probleem is opgelost. ## Stap 2: De plugin-eliminatiemethode[​](#step-2-the-plugin-elimination-method "Directe link naar Stap 2: De plugin-eliminatiemethode") Als er geen fatale fouten in de logs staan, of als je prestatiegerelateerde conflicten wilt identificeren, gebruik dan deze systematische aanpak: ### 2.1 Maak een uitgangspunt[​](#21-create-a-baseline "Directe link naar 2.1 Maak een uitgangspunt") 1. **Open je staging-site** 2. **Test de problematische functionaliteit** - Noteer precies wat niet werkt of traag is 3. **Registreer prestatiegegevens** - Als het een prestatieprobleem is, noteer dan de uitvoeringstijden uit de [Logs](/nl/support/logs.md) ### 2.2 Schakel alle plugins uit (behalve de essentiële)[​](#22-disable-all-plugins-except-essential-ones "Directe link naar 2.2 Schakel alle plugins uit (behalve de essentiële)") **Houd deze plugins actief:** * WooCommerce * WCPOS * WCPOS Pro (als je die hebt) **Schakel al het andere uit:** 1. Ga naar `WP Admin > Plugins` 2. Selecteer alle andere plugins 3. Kies "Deactivate" uit het vervolgkeuzemenu voor bulkacties 4. Klik op "Apply" ### 2.3 Test het probleem[​](#23-test-the-issue "Directe link naar 2.3 Test het probleem") 1. **Wis eventuele caches** - Als je caching-plugins gebruikt, wis dan alle caches 2. **Test de problematische functionaliteit** - Werkt het nu? 3. **Controleer de prestaties** - Zijn de uitvoeringstijden verbeterd? **Als het probleem is opgelost:** Je hebt een pluginconflict. Ga verder met Stap 2.4. **Als het probleem aanhoudt:** Het probleem is waarschijnlijk geen pluginconflict. Overweeg: * Problemen met serverbronnen (zie [Serverprestaties](/nl/support/performance/server.md)) * Themaconflicten (zie Stap 3) * Problemen met de WordPress/WooCommerce-kern ### 2.4 Schakel plugins één voor één in[​](#24-enable-plugins-one-by-one "Directe link naar 2.4 Schakel plugins één voor één in") Nu moet je identificeren welke plugin het conflict veroorzaakt: 1. **Schakel één plugin in** - Begin met de meest essentiële 2. **Test de functionaliteit** - Controleer of het probleem terugkeert 3. **Als er geen probleem is** - Schakel de volgende plugin in en test opnieuw 4. **Als het probleem terugkeert** - Je hebt de conflicterende plugin gevonden! **Prioriteitsvolgorde van plugins (schakel in deze volgorde in):** 1. **Beveiligingsplugins** - Wordfence, Sucuri, enz. 2. **SEO-plugins** - Yoast, RankMath, enz. 3. **Prestatieplugins** - Caching, optimalisatie 4. **Betaalgateways** - Stripe, PayPal, enz. 5. **Andere WooCommerce-extensies** 6. **Algemene WordPress-plugins** ### 2.5 Documenteer je bevindingen[​](#25-document-your-findings "Directe link naar 2.5 Documenteer je bevindingen") Wanneer je de conflicterende plugin identificeert: 1. **Noteer de naam en versie van de plugin** 2. **Documenteer het specifieke probleem dat deze veroorzaakt** 3. **Controleer of er een bijgewerkte versie beschikbaar is** 4. **Zoek naar alternatieve plugins die vergelijkbare functionaliteit bieden** ## Stap 3: Controleer op themaconflicten[​](#step-3-check-for-theme-conflicts "Directe link naar Stap 3: Controleer op themaconflicten") Hoewel thema's WCPOS zelden beïnvloeden (omdat het zijn eigen interface gebruikt), kunnen ze soms problemen veroorzaken met: * Afrekenprocessen (bij gebruik van de webafreken-gateway) * Functionaliteit van het beheergedeelte * API-reacties ### Test met een standaardthema[​](#test-with-a-default-theme "Directe link naar Test met een standaardthema") 1. **Schakel op je staging-site** over naar een standaard WordPress-thema: * Twenty Twenty-Four * Twenty Twenty-Three * Twenty Twenty-Two 2. **Test de problematische functionaliteit** 3. **Als het probleem is opgelost** - Je thema heeft een conflict Impact van thema's Thema's veroorzaken veel minder snel WCPOS-problemen dan plugins. De POS-interface werkt onafhankelijk van je thema. Thema's kunnen echter wel invloed hebben op: * WooCommerce-afrekenpagina's * Functionaliteit van het WordPress-beheergedeelte * REST API-reacties ## Stap 4: Pluginconflicten oplossen[​](#step-4-resolving-plugin-conflicts "Directe link naar Stap 4: Pluginconflicten oplossen") Zodra je de conflicterende plugin hebt geïdentificeerd, heb je verschillende opties: ### Optie 1: Werk de plugin bij[​](#option-1-update-the-plugin "Directe link naar Optie 1: Werk de plugin bij") 1. **Controleer op updates** - Het conflict is mogelijk opgelost in een nieuwere versie 2. **Werk de plugin bij** op je staging-site eerst 3. **Test grondig** voordat je bijwerkt op de live site ### Optie 2: Zoek een alternatief[​](#option-2-find-an-alternative "Directe link naar Optie 2: Zoek een alternatief") 1. **Onderzoek alternatieve plugins** die dezelfde functionaliteit bieden 2. **Test alternatieven** op je staging-site 3. **Migreer instellingen** als je van plugin wisselt ### Optie 3: Neem contact op met de plugin-ontwikkelaar[​](#option-3-contact-plugin-developer "Directe link naar Optie 3: Neem contact op met de plugin-ontwikkelaar") 1. **Meld het conflict** bij de plugin-ontwikkelaar 2. **Geef gedetailleerde informatie:** * Betrokken pluginversies * WordPress- en WooCommerce-versies * Exacte foutmeldingen of gedrag * Stappen om het probleem te reproduceren ### Optie 4: Aangepaste oplossing[​](#option-4-custom-solution "Directe link naar Optie 4: Aangepaste oplossing") Voor essentiële plugins die niet kunnen worden vervangen: 1. **Neem contact op met een WordPress-ontwikkelaar** om een aangepaste oplossing te maken 2. **Overweeg plugin-specifieke hooks** om conflicterende functionaliteit uit te schakelen 3. **Gebruik voorwaardelijke logica** om de plugin uit te schakelen op POS-gerelateerde pagina's ## Veelvoorkomende conflicterende plugintypen[​](#common-conflicting-plugin-types "Directe link naar Veelvoorkomende conflicterende plugintypen") ### Plugincategorieën met een hoog risico[​](#high-risk-plugin-categories "Directe link naar Plugincategorieën met een hoog risico") **Beveiligingsplugins:** * Kunnen API-verzoeken blokkeren * Kunnen de authenticatie verstoren * Hebben vaak agressieve firewallregels **Caching-plugins:** * Kunnen API-reacties op ongepaste wijze cachen * Kunnen realtime gegevens verstoren * Kunnen problemen met verouderde gegevens veroorzaken **SEO-plugins:** * Zware plugins kunnen het beheergedeelte vertragen * Kunnen onnodige databasequery's toevoegen * Kunnen REST API-reacties verstoren **Page builders:** * Laden vaak zware scripts in het beheergedeelte * Kunnen conflicteren met WooCommerce-beheerpagina's * Kunnen afrekenprocessen verstoren **Lidmaatschaps-/beperkingsplugins:** * Kunnen API-toegang blokkeren * Kunnen gebruikersauthenticatie verstoren * Kunnen de toegang tot vereiste resources beperken ### Plugincategorieën met een lager risico[​](#lower-risk-plugin-categories "Directe link naar Plugincategorieën met een lager risico") **Contactformulieren:** Verstoren WCPOS doorgaans niet **Social media-plugins:** Veroorzaken zelden conflicten **Analyseplugins:** Over het algemeen veilig, tenzij erg zwaar **Basis-contentplugins:** Doorgaans compatibel ## Bekende pluginconflicten[​](#known-plugin-conflicts "Directe link naar Bekende pluginconflicten") De onderstaande plugins staan erom bekend WCPOS te verstoren. Veel problemen zijn al automatisch opgelost in recente WCPOS-versies — **bijwerken naar de nieuwste versie** lost deze zonder enige configuratie op. De meeste oplossingen zijn "sluit de POS uit" De rode draad: WCPOS vertrouwt op de WooCommerce REST API en geeft sommige flows (login, betaling, bonnen) weer in iframes. De gebruikelijke oplossing is om de **POS-endpoints/URL's uit te sluiten** (`/wp-json/wcpos/`, `/wp-json/wc/v3/` en het `/pos/`-pad) van de andere plugin — niet om deze volledig uit te schakelen. ### Beveiligings- en login-plugins[​](#security-and-login-plugins "Directe link naar Beveiligings- en login-plugins") Dit zijn de **meest voorkomende** bron van conflicten, vooral voor login via de desktop-/mobiele app. | Plugin | Symptoom | Oplossing | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Wordfence** | Firewall blokkeert REST API; 2FA-codeveld wordt niet weergegeven in de login-iframe; restrictieve CSP kan POS-assets blokkeren | Zet `/wp-json/wcpos/` en `/wp-json/wc/v3/` op de whitelist in de firewall. Voor 2FA: schakel het tijdelijk uit voor POS-gebruikers. CSP wordt automatisch verwijderd in v1.9.0+ | | **Really Simple Security** | Blokkeert API-toegang / forceert omleidingen | Schakel eventuele REST API-beperkingen uit in de **Advanced**-instellingen van de plugin | | **WPS Hide Login** | Aangepaste login-URL breekt de login-iframe van de app | Gebruik de standaard `/wp-admin/`-login-URL voor POS-toegang | | **iThemes / Solid Security** | Blokkeert REST API of activeert brute-force-vergrendelingen door POS-aanroepen | Zet alleen de POS-endpoints en het eigen IP van de server op de whitelist — vermijd algemene IP-regels | | **Sucuri** | WAF blokkeert API-verzoeken | Zet de REST API-endpoints op de whitelist in het Sucuri-dashboard | | **Security Optimizer** | Blokkeert POS-login van beheerder (*"use customize login URL"*) | Log eerst in op WP Admin via de aangepaste URL, ga dan naar `/pos` | | **Force Login** (en vergelijkbare REST-auth-plugins) | `/wp-json/` geeft 401/403 terug; oudere apps meldden *"Site does not seem to be a WordPress site"* | Sta niet-geauthenticeerde toegang tot de POS-endpoints toe, of schakel uit tijdens de eerste verbinding. v1.x-apps tonen nu de echte foutmelding | | **LoginPress** | Forceert login op basis van e-mail; breekt multi-user POS-login | Sta login met gebruikersnaam toe, of schakel uit voor POS-toegang | | **JWT Authentication plugins** | 403 op alle POS API-verzoeken na activering (login kan slagen, al het andere mislukt) | Automatisch opgelost in v1.8.x+. Op oudere versies, deactiveer de JWT-plugin of sluit de POS-endpoints uit | | **Captcha / reCAPTCHA** | Login-lus in de desktop-app (captcha kan niet worden weergegeven in de iframe) | Schakel captcha uit voor de POS-login-URL | | **Defender Pro** | `X-Frame-Options`-header blokkeert alle POS-iframes (login, betaling, bonnen) | Voeg een POS-specifieke uitzondering toe voor `/pos/` in plaats van `X-Frame-Options` site-breed uit te schakelen | | **Jetpack CRM Client Portal** | Breekt de POS-login volledig | Schakel alleen de Client Portal-extensie uit | ### Prestatie-, caching- en optimalisatieplugins[​](#performance-caching-optimisation-plugins "Directe link naar Prestatie-, caching- en optimalisatieplugins") | Plugin | Symptoom | Oplossing | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | **WP Rocket, Autoptimize, Hummingbird, Smush** | Defer/minify van JS breekt afrekenen en Stripe Terminal | Sluit `/pos/`-URL's uit van JS-optimalisatie | | **LiteSpeed Cache** | Constante herlaad-lus bij het afrekenen in de desktop-app; restrictieve CSP | Werk WCPOS bij, leeg de cache, sluit POS-pagina's uit van caching. CSP automatisch verwijderd in v1.9.0+ | | **Image Prioritizer** | Spamt de HTTP `Link`-header, waardoor REST API-detectie breekt; desktop-app toont *"does not appear to be a WordPress site"* | Deactiveer de plugin | ### Page builders & front-end-injectors[​](#page-builders-front-end-injectors "Directe link naar Page builders & front-end-injectors") | Plugin | Symptoom | Oplossing | | -------------------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | **Elementor** | `elementor-frontend.js` breekt de afreken-accordion binnen de POS-iframe — betaalmethoden klappen niet uit | Sluit POS-pagina's uit van het laden van Elementor-scripts | | **Omnisend / marketingplugins** | Injecteren scripts in de afreken-iframe, waardoor lay-out en betalingen breken | Gebruik POS **Checkout Settings** om niet-essentiële scripts uit te schakelen | | **MyStickyElements / Complianz** | Injecteren overlays (sticky knoppen, cookiebanners) in de afreken-iframe | Configureer ze om `/pos/`-URL's uit te sluiten | ### WooCommerce-extensies en andere plugins[​](#woocommerce-extensions-other-plugins "Directe link naar WooCommerce-extensies en andere plugins") | Plugin | Symptoom | Oplossing | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | **WooCommerce Subscriptions** | Conflict met migratiescript tijdens de upgrade van v1.7→v1.8 | Deactiveer Subscriptions, activeer POS Pro (laat de migratie draaien), schakel het dan weer in | | **WP Activity Log** | Logt elke POS-actie → postmeta-bloat → *"only 10 products"* | Schakel het uit, of sluit POS-posttypen uit van logging | | **Jetpack / Astra / Xero** (alles dat inhaakt op `save_post`) | Dubbele meta-rijen bij elke POS API-aanroep (één winkel bereikte 36.867 rijen op één product) | Automatisch opgelost in v1.8.12+ (gratis) / v1.8.14+ (Pro) met een opschoonmigratie — werk gewoon bij | | **Stripe Tax** | Incompatibel met via de REST API aangemaakte bestellingen (zoals de POS bestellingen aanmaakt) | Geen tijdelijke oplossing — incompatibel | | **Mollie** | Kan de BACS-methode (bankoverschrijving) verbergen bij het POS-afrekenen | Werk Mollie bij naar de nieuwste versie | | **CTX Feed** | Sporadische 403-fouten op de POS-instellingenpagina | Deactiveer ter bevestiging; geen bekende oplossing | | **Plugins voor barcodescanners van derden** | Beschadigen de bestellings-API-JSON, waardoor het aanmaken/weergeven van bestellingen breekt | Schakel ze uit; gebruik de ingebouwde barcodescanning van de POS | | **MailerLite** (Signup Forms + WooCommerce) | 500-fout bij het aanmaken van POS-bestellingen (geheugen uitgeput) | Deactiveer ter bevestiging, neem dan contact op met MailerLite | | **The Courier Guy Shipping** | Het aanmaken van POS-bestellingen mislukt met een serverfout | Rol terug naar een vorige versie, of neem contact op met de ontwikkelaar | | **PixelYourSite / PixelMySite** | Fatale fout: *call to member function `is_type()` on bool* | Tijdelijk uitschakelen | | **Google Listings & Ads** | Autoloader-conflict → *"Class WCPOS\…\Stores not found"* kritieke fout | Verwijder alle POS-plugins en installeer alleen de nieuwste Pro standalone opnieuw | Stripe Terminal: schakel het niet globaal in De **Stripe Terminal**-gateway moet **alleen** binnen POS Settings worden ingeschakeld, nooit in `WooCommerce > Settings > Payments`. Het globaal inschakelen zorgt ervoor dat het op het afrekenen van je openbare winkel verschijnt en laat de online afreken-flow crashen. ### Conflicten op serverniveau[​](#server-level-conflicts "Directe link naar Conflicten op serverniveau") | Bron | Symptoom | Oplossing | | ------------------------------------------------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Aangepaste CSP-headers** (`.htaccess`, Nginx of een beveiligingsplugin) | POS blijft hangen op het logo; JS/CSS geblokkeerd | Automatisch verwijderd op POS-pagina's in v1.9.0+. Voor CSP op serverniveau, sta `cdn.jsdelivr.net` toe in `script-src`/`style-src`, of voeg een `/pos/`-uitzondering toe | | **GoDaddy Website Firewall** | Blokkeert `/wp-json/` (*"Received 'undefined'"*) | Sta het `/wp-json/`-URL-pad toe in de firewall — zie [Serverprestaties](/nl/support/performance/server.md#hosting-specific-notes) | ## Preventietips[​](#prevention-tips "Directe link naar Preventietips") ### Regelmatig onderhoud[​](#regular-maintenance "Directe link naar Regelmatig onderhoud") 1. **Houd plugins bijgewerkt** - Gebruik altijd de nieuwste versies 2. **Verwijder ongebruikte plugins** - Deactiveer ze niet alleen, verwijder ze 3. **Test updates op staging** voordat je ze toepast op de live site 4. **Bewaak de prestaties** regelmatig met behulp van de [Serverprestaties](/nl/support/performance/server.md)-gegevens ### Best practices voor pluginselectie[​](#plugin-selection-best-practices "Directe link naar Best practices voor pluginselectie") 1. **Kies betrouwbare ontwikkelaars** - Controleer beoordelingen en updatefrequentie 2. **Vermijd overbodige functionaliteit** - Installeer niet meerdere plugins die hetzelfde doen 3. **Lees compatibiliteitsinformatie** - Controleer of plugins zijn getest met WooCommerce 4. **Begin met minimale plugins** - Voeg functionaliteit geleidelijk toe naarmate dat nodig is ## Hulp krijgen[​](#getting-help "Directe link naar Hulp krijgen") Als je het pluginconflict niet kunt oplossen: ### Voor Pro-gebruikers[​](#for-pro-users "Directe link naar Voor Pro-gebruikers") Pro-ondersteuning Pro-gebruikers ontvangen prioriteitsondersteuning voor het oplossen van pluginconflicten. Ons team kan je helpen conflicten te identificeren en op te lossen. ### Community-ondersteuning[​](#community-support "Directe link naar Community-ondersteuning") [Discord Community](https://wcpos.com/discord) ### Bij het contact opnemen met ondersteuning[​](#when-contacting-support "Directe link naar Bij het contact opnemen met ondersteuning") Geef het volgende op: 1. **Lijst met actieve plugins** met versies 2. **WordPress- en WooCommerce-versies** 3. **Gedetailleerde beschrijving** van het probleem 4. **Stappen die je al hebt geprobeerd** 5. **Foutmeldingen** uit de logs 6. **Serverprestatiegegevens** indien relevant ## Gerelateerde documentatie[​](#related-documentation "Directe link naar Gerelateerde documentatie") [Kritieke foutHoe je fatale-foutlogs vindt](/nl/support/troubleshooting/critical-error.md) [LogsWCPOS-logs en -gegevens begrijpen](/nl/support/logs.md) [ServerprestatiesPrestatieproblemen diagnosticeren](/nl/support/performance/server.md) [AfrekenprestatiesAfrekensnelheid optimaliseren](/nl/support/performance/checkout.md)