Plugin-Konflikte
Plugin-Konflikte gehören zu den häufigsten Ursachen für Probleme mit WCPOS. Wenn andere WordPress-Plugins die Funktionalität von WooCommerce oder WCPOS stören, können Abstürze, Leistungsprobleme oder unerwartetes Verhalten auftreten.
Anzeichen für Plugin-Konflikte
Sie haben möglicherweise einen Plugin-Konflikt, wenn Sie Folgendes erleben:
- Fatale Fehler - "Es ist ein kritischer Fehler auf dieser Website aufgetreten"
- Leistungsprobleme - Langsame Ladezeiten, Zeitüberschreitungen oder hohe Serverlast
- Funktionsprobleme - Funktionen arbeiten nicht wie erwartet
- Daten-Synchronisierungsprobleme - Produkte, Bestellungen oder Kunden werden nicht ordnungsgemäß synchronisiert
- Zahlungsgateway-Probleme - Fehler beim Checkout oder Zahlungsbearbeitungsprobleme
Bevor Sie beginnen: Verwenden Sie eine Staging-Website
Troubleshooting von Plugin-Konflikten niemals auf Ihrer Live-Website. Verwenden Sie immer eine Staging-Umgebung, um Ihre Geschäftsabläufe nicht zu stören.
Was ist eine Staging-Website?
Eine Staging-Website ist eine exakte Kopie Ihrer Live-Website, auf der Sie Änderungen sicher testen können, ohne Ihre Kunden zu beeinträchtigen. Die meisten modernen Hosting-Anbieter bieten Staging-Umgebungen als Standardfunktion an.
Wenn Ihr Host kein Staging anbietet
Wenn Ihr Hosting-Anbieter keine Staging-Websites anbietet, erwägen Sie den Wechsel zu einem Anbieter, der dies tut. Dies ist heutzutage eine Standardfunktion und für Folgendes unerlässlich:
- Sicheres Testen von Plugins/Themes
- WordPress-Updates
- Fehlersuche
- Entwicklungsarbeiten
Empfohlene Hosts mit Staging:
- WP Engine
- SiteGround
- Kinsta
- Cloudways
- Viele andere
Schritt 1: Überprüfen Sie auf fatale Fehler
Wenn Sie Abstürze oder kritische Fehler erleben, beginnen Sie mit der Überprüfung der Fehlermeldungsprotokolle:
- Überprüfen Sie die WCPOS-Protokolle - Öffnen Sie den Protokollbereich in WCPOS auf Fehlermeldungen
- Überprüfen Sie die Fatale Fehlerprotokolle - Folgen Sie dem Leitfaden zur Fehlersuche bei kritischen Fehlern, um detaillierte Fehlermeldungen zu finden
- Notieren Sie die Fehlermeldungen - Achten Sie auf erwähnte Plugin-Namen oder Dateipfade
Wenn Sie einen fatalen Fehler finden, der ein bestimmtes Plugin erwähnt, ist dies wahrscheinlich der Verursacher. Sie können dieses Plugin deaktivieren und testen, ob das Problem behoben ist.
Schritt 2: Die Plugin-Eliminierungsmethode
Wenn keine fatalen Fehler in den Protokollen vorliegen oder Sie leistungsbezogene Konflikte identifizieren möchten, verwenden Sie diesen systematischen Ansatz:
2.1 Erstellen Sie eine Basislinie
- Zugriff auf Ihre Staging-Website
- Testen Sie die problematische Funktionalität - Notieren Sie genau, was nicht funktioniert oder langsam ist
- Aufzeichnen von Leistungsmetriken - Wenn es sich um ein Leistungsproblem handelt, notieren Sie die Ausführungszeiten aus den Protokollen
2.2 Deaktivieren Sie alle Plugins (außer den wesentlichen)
Diese Plugins aktiv halten:
- WooCommerce
- WCPOS
- WCPOS Pro (falls vorhanden)
Alles andere deaktivieren:
- Gehen Sie zu
WP Admin > Plugins - Wählen Sie alle anderen Plugins aus
- Wählen Sie "Deaktivieren" aus dem Dropdown-Menü für Massenaktionen
- Klicken Sie auf "Übernehmen"
2.3 Testen Sie das Problem
- Löschen Sie alle Caches - Wenn Sie Caching-Plugins verwenden, leeren Sie alle Caches
- Testen Sie die problematische Funktionalität - Funktioniert es jetzt?
- Überprüfen Sie die Leistung - Sind die Ausführungszeiten verbessert?
Wenn das Problem behoben ist: Sie haben einen Plugin-Konflikt. Fahren Sie mit Schritt 2.4 fort.
Wenn das Problem weiterhin besteht: Das Problem ist wahrscheinlich kein Plugin-Konflikt. Berücksichtigen Sie:
- Serverressourcenprobleme (siehe Server-Leistung)
- Theme-Konflikte (siehe Schritt 3)
- Probleme mit dem WordPress/WooCommerce-Kern
2.4 Aktivieren Sie Plugins einzeln
Jetzt müssen Sie identifizieren, welches Plugin den Konflikt verursacht:
- Aktivieren Sie ein Plugin - Beginnen Sie zuerst mit den wichtigsten
- Testen Sie die Funktionalität - Überprüfen Sie, ob das Problem zurückkehrt
- Wenn kein Problem - Aktivieren Sie das nächste Plugin und testen Sie erneut
- Wenn das Problem zurückkehrt - Sie haben das konfliktverursachende Plugin gefunden!
Plugin-Prioritätsreihenfolge (in dieser Reihenfolge aktivieren):
- Sicherheitsplugins - Wordfence, Sucuri usw.
- SEO-Plugins - Yoast, RankMath usw.
- Leistungsplugins - Caching, Optimierung
- Zahlungsgateways - Stripe, PayPal usw.
- Andere WooCommerce-Erweiterungen
- Allgemeine WordPress-Plugins
2.5 Dokumentieren Sie Ihre Ergebnisse
Wenn Sie das konfliktverursachende Plugin identifiziert haben:
- Notieren Sie den Plugin-Namen und die Version
- Dokumentieren Sie das spezifische Problem, das es verursacht
- Überprüfen Sie, ob eine aktualisierte Version verfügbar ist
- Suchen Sie nach alternativen Plugins, die ähnliche Funktionalität bieten
Schritt 3: Überprüfen Sie auf Theme-Konflikte
Obwohl Themes WCPOS selten beeinflussen (da es seine eigene Benutzeroberfläche verwendet), können sie manchmal Probleme verursachen bei:
- Checkout-Prozessen (bei Verwendung eines Web-Checkout-Gateways)
- Funktionalität im Admin-Bereich
- API-Antworten
Testen mit einem Standard-Theme
- Wechseln Sie auf Ihrer Staging-Website zu einem Standard-WordPress-Theme:
- Twenty Twenty-Four
- Twenty Twenty-Three
- Twenty Twenty-Two
- Testen Sie die problematische Funktionalität
- Wenn das Problem behoben ist - Ihr Theme hat einen Konflikt
Themes verursachen viel seltener Probleme mit WCPOS im Vergleich zu Plugins. Die POS-Oberfläche läuft unabhängig von Ihrem Theme. Themes können jedoch beeinflussen:
- WooCommerce-Checkout-Seiten
- WordPress-Admin-Funktionalität
- REST-API-Antworten
Schritt 4: Behebung von Plugin-Konflikten
Sobald Sie das konfliktverursachende Plugin identifiziert haben, haben Sie mehrere Optionen:
Option 1: Update des Plugins
- Überprüfen Sie auf Updates - Der Konflikt könnte in einer neueren Version behoben sein
- Aktualisieren Sie das Plugin zuerst auf Ihrer Staging-Website
- Testen Sie gründlich, bevor Sie auf der Live-Website aktualisieren
Option 2: Finden Sie eine Alternative
- Recherchieren Sie alternative Plugins, die dieselbe Funktionalität bieten
- Testen Sie Alternativen auf Ihrer Staging-Website
- Migrieren Sie die Einstellungen, wenn Sie plugins wechseln
Option 3: Kontaktieren Sie den Plugin-Entwickler
- Melden Sie den Konflikt an den Plugin-Entwickler
- Geben Sie detaillierte Informationen an:
- Betroffene Plugin-Versionen
- WordPress- und WooCommerce-Versionen
- Exakte Fehlermeldungen oder Verhalten
- Schritte zur Reproduktion des Problems
Option 4: Benutzerdefinierte Lösung
Für essentielle Plugins, die nicht ersetzt werden können:
- Kontaktieren Sie einen WordPress-Entwickler, um eine benutzerdefinierte Lösung zu erstellen
- Berücksichtigen Sie plugin-spezifische Hooks, um konfliktierende Funktionen zu deaktivieren
- Verwenden Sie bedingte Logik, um das Plugin auf POS-bezogenen Seiten zu deaktivieren
Häufige Konflikt verursachende Plugin-Typen
Hochrisiko-Plugin-Kategorien
Sicherheits-Plugins:
- Können API-Anfragen blockieren
- Können Authentifizierung stören
- Haben oft aggressive Firewall-Regeln
Caching-Plugins:
- Können API-Antworten unangemessen cachen
- Können mit Echtzeitdaten stören
- Können Probleme mit veralteten Daten verursachen
SEO-Plugins:
- Schwere Plugins können den Adminbereich verlangsamen
- Können unnötige Datenbankabfragen hinzufügen
- Können mit REST-API-Antworten interferieren
Seiten-Builder:
- Laden oft schwere Skripte im Adminbereich
- Können mit WooCommerce-Admin-Seiten in Konflikt stehen
- Können Checkout-Prozesse stören
Mitgliedschafts-/Einschränkungs-Plugins:
- Können den API-Zugriff blockieren
- Können die Benutzerauthentifizierung stören
- Können den Zugriff auf erforderliche Ressourcen einschränken
Geringeres Risiko-Plugin-Kategorien
Kontaktformulare: Stören normalerweise nicht WCPOS Soziale Medien-Plugins: Verursachen selten Konflikte Analyse-Plugins: Generell sicher, es sei denn, sie sind sehr schwer Einfache Inhalts-Plugins: In der Regel kompatibel
Bekannte Plugin-Konflikte
Die unten aufgeführten Plugins sind dafür bekannt, WCPOS zu stören. Viele Probleme wurden bereits in aktuellen WCPOS-Versionen automatisch behoben — ein Update auf die neueste Version löst diese ohne jegliche Konfiguration.
Der gemeinsame Nenner: WCPOS verlässt sich auf die WooCommerce-REST-API und rendert einige Abläufe (Login, Zahlung, Belege) in iframes. Die übliche Lösung besteht darin, die POS-Endpunkte/-URLs auszuschließen (/wp-json/wcpos/, /wp-json/wc/v3/ und den Pfad /pos/) vom anderen Plugin — nicht es vollständig zu deaktivieren.
Sicherheits- & Login-Plugins
Dies sind die häufigste Konfliktquelle, insbesondere beim Login der Desktop-/Mobile-App.
| Plugin | Symptom | Lösung |
|---|---|---|
| Wordfence | Firewall blockiert REST-API; 2FA-Code-Feld wird im Login-iframe nicht gerendert; restriktive CSP kann POS-Assets blockieren | Setzen Sie /wp-json/wcpos/ und /wp-json/wc/v3/ in der Firewall auf die Whitelist. Für 2FA: deaktivieren Sie es vorübergehend für POS-Benutzer. CSP wird in v1.9.0+ automatisch entfernt |
| Really Simple Security | Blockiert API-Zugriff / erzwingt Weiterleitungen | Deaktivieren Sie alle REST-API-Beschränkungen in den Erweitert-Einstellungen des Plugins |
| WPS Hide Login | Benutzerdefinierte Login-URL beschädigt den App-Login-iframe | Verwenden Sie die Standard-Login-URL /wp-admin/ für den POS-Zugriff |
| iThemes / Solid Security | Blockiert REST-API oder löst Brute-Force-Sperren durch POS-Aufrufe aus | Setzen Sie nur die POS-Endpunkte und die eigene IP des Servers auf die Whitelist — vermeiden Sie pauschale IP-Regeln |
| Sucuri | WAF blockiert API-Anfragen | Setzen Sie die REST-API-Endpunkte im Sucuri-Dashboard auf die Whitelist |
| Security Optimizer | Blockiert den Admin-POS-Login („use customize login URL") | Melden Sie sich zuerst über die benutzerdefinierte URL in WP Admin an, gehen Sie dann zu /pos |
| Force Login (und ähnliche REST-Auth-Plugins) | /wp-json/ gibt 401/403 zurück; ältere Apps meldeten „Site does not seem to be a WordPress site" | Erlauben Sie unauthentifizierten Zugriff auf die POS-Endpunkte oder deaktivieren Sie es während der ersten Verbindung. v1.x-Apps zeigen jetzt die echte Fehlermeldung an |
| LoginPress | Erzwingt E-Mail-basierten Login; beschädigt den Mehrbenutzer-POS-Login | Erlauben Sie den Benutzernamen-Login oder deaktivieren Sie es für den POS-Zugriff |
| JWT-Authentifizierungs-Plugins | 403 bei allen POS-API-Anfragen nach Aktivierung (Login kann gelingen, alles andere schlägt fehl) | In v1.8.x+ automatisch behoben. Bei älteren Versionen deaktivieren Sie das JWT-Plugin oder schließen Sie die POS-Endpunkte aus |
| Captcha / reCAPTCHA | Login-Schleife in der Desktop-App (Captcha kann im iframe nicht gerendert werden) | Deaktivieren Sie Captcha für die POS-Login-URL |
| Defender Pro | X-Frame-Options-Header blockiert alle POS-iframes (Login, Zahlung, Belege) | Fügen Sie eine POS-spezifische Ausnahme für /pos/ hinzu, anstatt X-Frame-Options site-weit zu deaktivieren |
| Jetpack CRM Client Portal | Beschädigt den POS-Login vollständig | Deaktivieren Sie nur die Client-Portal-Erweiterung |
Leistungs-, Caching- & Optimierungs-Plugins
| Plugin | Symptom | Lösung |
|---|---|---|
| WP Rocket, Autoptimize, Hummingbird, Smush | Defer/Minify von JS beschädigt Checkout und Stripe Terminal | Schließen Sie /pos/-URLs von der JS-Optimierung aus |
| LiteSpeed Cache | Ständige Reload-Schleife beim Checkout in der Desktop-App; restriktive CSP | Aktualisieren Sie WCPOS, leeren Sie den Cache, schließen Sie POS-Seiten vom Caching aus. CSP wird in v1.9.0+ automatisch entfernt |
| Image Prioritizer | Überfrachtet den HTTP-Link-Header und beschädigt die REST-API-Erkennung; Desktop-App zeigt „does not appear to be a WordPress site" | Deaktivieren Sie das Plugin |
Page-Builder & Front-End-Injektoren
| Plugin | Symptom | Lösung |
|---|---|---|
| Elementor | elementor-frontend.js beschädigt das Checkout-Akkordeon innerhalb des POS-iframes — Zahlungsmethoden lassen sich nicht aufklappen | Schließen Sie POS-Seiten vom Laden der Elementor-Skripte aus |
| Omnisend / Marketing-Plugins | Injizieren Skripte in den Checkout-iframe und beschädigen Layout und Zahlungen | Verwenden Sie die POS-Checkout-Einstellungen, um nicht wesentliche Skripte zu deaktivieren |
| MyStickyElements / Complianz | Injizieren Overlays (Sticky-Buttons, Cookie-Banner) in den Checkout-iframe | Konfigurieren Sie sie so, dass sie /pos/-URLs ausschließen |
WooCommerce-Erweiterungen & andere Plugins
| Plugin | Symptom | Lösung |
|---|---|---|
| WooCommerce Subscriptions | Konflikt mit dem Migrationsskript während des Upgrades von v1.7 auf v1.8 | Deaktivieren Sie Subscriptions, aktivieren Sie POS Pro (lassen Sie die Migration laufen), aktivieren Sie es dann wieder |
| WP Activity Log | Protokolliert jede POS-Aktion → Postmeta-Aufblähung → „only 10 products" | Deaktivieren Sie es oder schließen Sie POS-Post-Typen von der Protokollierung aus |
Jetpack / Astra / Xero (alles, was sich in save_post einhängt) | Doppelte Meta-Zeilen bei jedem POS-API-Aufruf (ein Shop erreichte 36.867 Zeilen bei einem Produkt) | In v1.8.12+ (kostenlos) / v1.8.14+ (Pro) mit einer Bereinigungsmigration automatisch behoben — einfach aktualisieren |
| Stripe Tax | Inkompatibel mit über die REST-API erstellten Bestellungen (so erstellt das POS Bestellungen) | Keine Umgehung — inkompatibel |
| Mollie | Kann die BACS-Methode (Banküberweisung) im POS-Checkout ausblenden | Aktualisieren Sie Mollie auf die neueste Version |
| CTX Feed | Sporadische 403-Fehler auf der POS-Einstellungsseite | Deaktivieren Sie es zur Bestätigung; keine bekannte Umgehung |
| Barcode-Scanner-Plugins von Drittanbietern | Beschädigen das Bestell-API-JSON und brechen die Bestellerstellung/-anzeige | Deaktivieren Sie sie; verwenden Sie das integrierte Barcode-Scanning des POS |
| MailerLite (Signup Forms + WooCommerce) | 500-Fehler bei der POS-Bestellerstellung (Speichererschöpfung) | Deaktivieren Sie es zur Bestätigung, kontaktieren Sie dann MailerLite |
| The Courier Guy Shipping | POS-Bestellerstellung schlägt mit einem Serverfehler fehl | Setzen Sie auf eine frühere Version zurück oder kontaktieren Sie den Entwickler |
| PixelYourSite / PixelMySite | Fataler Fehler: call to member function is_type() on bool | Deaktivieren Sie es vorübergehend |
| Google Listings & Ads | Autoloader-Konflikt → „Class WCPOS\…\Stores not found" kritischer Fehler | Löschen Sie alle POS-Plugins und installieren Sie nur die neueste Pro-Standalone-Version neu |
Das Stripe Terminal-Gateway sollte nur innerhalb der POS-Einstellungen aktiviert werden, niemals in WooCommerce > Settings > Payments. Die globale Aktivierung lässt es im Checkout Ihres öffentlichen Shops erscheinen und bringt den Online-Checkout-Ablauf zum Absturz.
Konflikte auf Serverebene
| Quelle | Symptom | Lösung |
|---|---|---|
Benutzerdefinierte CSP-Header (.htaccess, Nginx oder ein Sicherheits-Plugin) | POS bleibt beim Logo hängen; JS/CSS blockiert | Auf POS-Seiten in v1.9.0+ automatisch entfernt. Für CSP auf Serverebene erlauben Sie cdn.jsdelivr.net in script-src/style-src oder fügen Sie eine /pos/-Ausnahme hinzu |
| GoDaddy Website Firewall | Blockiert /wp-json/ („Received 'undefined'") | Erlauben Sie den URL-Pfad /wp-json/ in der Firewall — siehe Server-Leistung |
Tipps zur Prävention
Regelmäßige Wartung
- Halten Sie die Plugins aktuell - Verwenden Sie immer die neuesten Versionen
- Entfernen Sie ungenutzte Plugins - Deaktivieren Sie sie nicht nur, sondern löschen Sie sie
- Testen Sie Updates auf Staging, bevor Sie sie auf der Live-Website anwenden
- Überwachen Sie die Leistung regelmäßig mit Server-Leistungs-metriken
Best Practices bei der Plugin-Auswahl
- Wählen Sie seriöse Entwickler - Überprüfen Sie Bewertungen und Aktualisierungsfrequenzen
- Vermeiden Sie redundante Funktionalität - Installieren Sie nicht mehrere Plugins, die dasselbe tun
- Lesen Sie die Kompatibilitätsinformationen - Überprüfen Sie, ob Plugins mit WooCommerce getestet wurden
- Beginnen Sie mit minimalen Plugins - Fügen Sie nach Bedarf schrittweise Funktionen hinzu
Hilfe erhalten
Wenn Sie den Plugin-Konflikt nicht beheben können:
Für Pro-Nutzer
Pro-Nutzer erhalten vorrangigen Support bei der Lösung von Plugin-Konflikten. Unser Team kann helfen, Konflikte für Sie zu identifizieren und zu beheben.
Community-Support
Bei der Kontaktaufnahme mit dem Support
Bitte geben Sie an:
- Liste der aktiven Plugins mit Versionen
- WordPress- und WooCommerce-Versionen
- Detaillierte Beschreibung des Problems
- Schritte, die Sie bereits versucht haben
- Fehlermeldungen aus den Protokollen
- Server-Leistungsmetriken, falls relevant