Fehlerbehebung beim WooCommerce-Bestellformular-Shortcode

Haben Sie den WooCommerce-Bestellformular-Shortcode zu einer Seite hinzugefügt und nun fehlt das Formular, wird ein Fehler angezeigt oder die Seite ist fehlerhaft? In den meisten Fällen liegt es am Shortcode selbst, am Formularstatus, an einer Page-Builder-Vorlage oder an einem Konflikt mit einem anderen Plugin. Diese Anleitung führt Sie durch jedes Symptom, damit Sie die Ursache finden und das Formular wieder anzeigen lassen können.

Bevor Sie beginnen: Überprüfen Sie Ihre Shortcode-Syntax

In Version 3 von WooCommerce Wholesale Order Form ist das richtige Shortcode-Format:

[wwof_product_listing id="XX"]

wobei XX die numerische ID Ihres Bestellformulars ist. Ein Shortcode, der ohne das Attribut id platziert wird oder eine falsche ID verwendet, zeigt entweder eine Fehlermeldung an oder gar nichts.

So finden Sie den richtigen Shortcode für Ihr Formular:

1. Gehen Sie in Ihrem WordPress-Adminbereich zu Großhandel → Bestellformulare.
2. Öffnen Sie das Formular, das Sie einbetten möchten.
3. Kopieren Sie den Shortcode, der im Formular-Editor angezeigt wird.
4. Fügen Sie ihn auf der Seite ein, auf der das Formular erscheinen soll.

Wenn Sie [wwof_order_form] ohne id Attribut verwendet haben, wird dieses Shortcode-Format nicht mehr verwendet. Ersetzen Sie es durch den Shortcode, den Sie aus dem Formular-Editor kopiert haben.

Häufige Probleme und Lösungen

Die Seite zeigt „Keine Bestellformular-ID angegeben“, „existiert nicht“ oder „Es gibt einen Konfigurationsfehler“

Administratoren, die „Keine Bestellformular-ID angegeben.“ sehen, verwenden den Shortcode ohne das erforderliche Attribut id. Administratoren, die eine Meldung wie „Bestellformular-ID 123 existiert nicht!“ sehen, verwenden eine ID, die keinem Bestellformular entspricht, z. B. die ID eines gelöschten Formulars. In beiden Fällen ersetzen Sie den Shortcode durch den, der unter Wholesale → Bestellformulare kopiert wurde.

Nicht-Admin-Besucher sehen stattdessen „Es gibt einen Konfigurationsfehler bei diesem Formular. Bitte kontaktieren Sie den Website-Administrator.“, sowohl bei einer fehlenden ID als auch bei einer falschen ID. Dies ist dasselbe zugrunde liegende Problem. Korrigieren Sie den Shortcode und die Meldung verschwindet für beide.

Das Bestellformular wird gar nicht angezeigt

Kunden können ein Bestellformular nur sehen, wenn sein Status Veröffentlicht ist. Ein Entwurfsformular wird weiterhin für Administratoren und Shop-Manager angezeigt, sodass die Seite gut aussehen kann, während Sie angemeldet sind. Kunden und nicht angemeldete Besucher sehen stattdessen eine Meldung „Zugriff verweigert“ („Sie haben keine Berechtigung, dieses Bestellformular anzuzeigen.“). Daher sieht ein Entwurfsformular oft wie ein Berechtigungsproblem aus und nicht wie ein fehlendes Formular. Um zu sehen, was Ihre Kunden sehen, öffnen Sie die Seite in einem privaten oder Inkognito-Fenster.

1. Gehen Sie zu Großhandel → Bestellformulare.
2. Überprüfen Sie den Status des Formulars. Wenn Entwurf angezeigt wird, öffnen Sie es und klicken Sie auf Veröffentlichen.

Das Formular bleibt in einer Page-Builder-Vorlage leer

Die Seite wird geladen, aber der Bereich, in dem das Bestellformular sein sollte, bleibt leer. Dies geschieht, wenn der Shortcode in einer Theme-Builder-Vorlage, wie z. B. einer Divi Theme Builder-Vorlage oder einer Elementor Pro-Theme-Vorlage, anstelle des Inhalts der Seite selbst platziert wird.

Das WooCommerce-Bestellformular lädt sein Formularskript nur, wenn es den Shortcode im Inhalt der angezeigten Seite findet. Eine Vorlage wird separat von der Seite gespeichert, sodass das Plugin den Shortcode dort nicht sieht. Der leere Formularcontainer wird gedruckt, aber das Skript, das ihn füllt, wird nie geladen.

Die einfachste Lösung ist, den Shortcode in den Inhalt der Seite selbst zu platzieren, z. B. im Block-Editor oder in einem Builder-Modul auf dieser Seite. Wenn Sie das Formular in der Vorlage belassen möchten, fügen Sie einen Shortcode-Snippet hinzu, der das Plugin anweist, das Formular auf dieser Seite zu laden.

So fügen Sie das Snippet hinzu:

1. Gehen Sie zu WooCommerce → Bestellformulare und notieren Sie die ID Ihres Formulars. Es ist die Zahl im Shortcode des Formulars, z. B. 123 in [wwof_product_listing id="123"].
2. Notieren Sie den Slug der Seite, auf der die Vorlage angezeigt wird, z. B. wholesale-ordering für Ihre-domain.de/wholesale-ordering/. Die Seiten-ID funktioniert auch.
3. Fügen Sie den folgenden Ausschnitt mit einem Code-Snippets-Plugin wie WPCode hinzu oder fügen Sie ihn zur functions.php-Datei Ihres Child-Themes hinzu.
4. Ersetzen Sie wholesale-ordering durch Ihren Seiten-Slug und 123 durch Ihre Formular-ID und speichern Sie dann.
5. Leeren Sie den Cache Ihrer Website und laden Sie die Seite neu.

add_filter( 'wwof_force_load_form_posts', function ( $form_posts ) {
	// Replace 'wholesale-ordering' with the slug or ID of the page that shows the form.
	if ( is_page( 'wholesale-ordering' ) ) {
		// Replace 123 with your order form ID.
		$form_posts[123] = \RymeraWebCo\WWOF\Factories\Order_Form::get_instance( get_post( 123 ) );
	}

	return $form_posts;
} );

Ein Snippet kann so viele Formulare laden, wie Sie benötigen. Fügen Sie pro Formular eine Zeile innerhalb der Prüfung für die Seite hinzu, auf der es angezeigt wird:

add_filter( 'wwof_force_load_form_posts', function ( $form_posts ) {
	if ( is_page( 'wholesale-ordering' ) ) {
		$form_posts[123] = \RymeraWebCo\WWOF\Factories\Order_Form::get_instance( get_post( 123 ) );
	}

	if ( is_page( 'trade-restock' ) ) {
		$form_posts[456] = \RymeraWebCo\WWOF\Factories\Order_Form::get_instance( get_post( 456 ) );
		$form_posts[789] = \RymeraWebCo\WWOF\Factories\Order_Form::get_instance( get_post( 789 ) );
	}

	return $form_posts;
} );

Auf einer Seite, auf der das Snippet Formulare lädt, verwendet das Plugin die Liste des Snippets und hört auf, nach Shortcodes im Seiteninhalt zu suchen. Wenn diese Seite auch ein Bestellformular in ihrem Inhalt hat, fügen Sie dieses Formular ebenfalls zum Snippet hinzu.

Die is_page()-Prüfung passt auf normale WordPress-Seiten. Wenn Ihre Vorlage auf einem anderen Bildschirmtyp angezeigt wird, ändern Sie die Prüfung, um diesen Bildschirm anzupassen.

Ein kritischer PHP-Fehler erscheint, wenn der Shortcode auf der Seite ist

Kritische Fehler, die nur erscheinen, wenn der Shortcode vorhanden ist, werden durch einen Plugin-Konflikt, ein Caching- oder Optimierungs-Plugin, das das JavaScript-Bundle des Bestellformulars falsch verarbeitet, oder ein zu niedriges PHP-Speicherlimit verursacht. Gehen Sie die folgenden Schritte in der Reihenfolge durch.

Schritt 1: WP_DEBUG aktivieren, um den tatsächlichen Fehler zu sehen

1. Öffnen Sie die Datei wp-config.php Ihrer Website (befindet sich im Stammverzeichnis Ihres WordPress).
2. Finden Sie die Zeile define( 'WP_DEBUG', false ); und ändern Sie false in true.
3. Fügen Sie direkt unter dieser Zeile hinzu: define( 'WP_DEBUG_LOG', true );
4. Speichern Sie die Datei und laden Sie die Seite, die den Fehler auslöst, neu.
5. Öffnen Sie wp-content/debug.log.
6. Beachten Sie die genaue Fehlermeldung und den Dateipfad, auf den sie verweist.

Halten Sie diese Fehlermeldung und den Dateipfad bereit. Sie benötigen sie, wenn Sie den Support kontaktieren.

Weitere Details zu den verfügbaren Konstanten finden Sie unter Debugging in WordPress.

Schritt 2: PHP-Speicherlimit prüfen

Das Bestellformular lädt eine JavaScript-Anwendung, die mehrere Hintergrundanfragen an Ihren Server stellt. Wenn PHP während dieses Vorgangs der Arbeitsspeicher ausgeht, kann dies zu einem schwerwiegenden Fehler führen. Das empfohlene Minimum für WooCommerce-Websites, einschließlich derjenigen, die das WooCommerce Wholesale Order Form verwenden, beträgt 256 MB.

Um Ihr aktuelles Limit zu überprüfen, gehen Sie zu WooCommerce → Status, öffnen Sie den Tab Systemstatus und suchen Sie nach der Zeile WordPress memory limit. Wenn dieser Wert unter 256 MB liegt, kontaktieren Sie Ihren Hosting-Provider, um ihn zu erhöhen, oder fügen Sie die folgende Zeile zu wp-config.php hinzu:

define( 'WP_MEMORY_LIMIT', '256M' );

Schritt 3: Zu einem Standard-Theme wechseln

Ein Theme, das widersprüchliche JavaScript-Dateien hinzufügt oder WooCommerce-Vorlagen überschreibt, kann das Bestellformular beeinträchtigen. Ein Wechsel zu einem Standard-Theme schließt dies schnell aus.

1. Gehen Sie im WordPress-Adminbereich zu Design → Themes.
2. Aktivieren Sie Storefront oder Twenty Twenty-Four.
3. Laden Sie die Seite mit dem Shortcode neu.

Wenn der Fehler verschwindet, wenn das Standard-Theme aktiv ist, ist Ihr ursprüngliches Theme die Ursache des Konflikts. Aktivieren Sie es erneut und teilen Sie das Debug-Protokoll mit dem Support-Team Ihres Themes.

Schritt 4: Konfliktierendes Plugin isolieren

1. Gehen Sie zu Plugins → Installierte Plugins.
2. Deaktivieren Sie alle Plugins außer WooCommerce und Ihren Wholesale Suite-Plugins: WooCommerce Wholesale Prices, WooCommerce Wholesale Order Form und WooCommerce Wholesale Prices Premium, falls Sie es verwenden.
3. Laden Sie die Seite mit dem Shortcode neu. Wenn der Fehler behoben ist, ist ein Plugin-Konflikt die Ursache.
4. Aktivieren Sie die Plugins einzeln wieder und laden Sie die Seite nach jeder Aktivierung neu. Das letzte Plugin, das Sie aktiviert haben, als der Fehler erneut auftrat, ist das konfliktierende Plugin.

Bekannte Plugin-Konflikte und Workarounds

Mehrere Optimierungs- und Caching-Plugins erfordern eine spezielle Behandlung, um neben dem Bestellformular zu funktionieren. Das Plugin enthält eine integrierte Kompatibilität für einige davon, was bedeutet, dass keine manuellen Schritte für diese erforderlich sind.

WP Rocket. Das Wholesale Order Form schließt Seiten, die seinen Shortcode enthalten, automatisch vom Seitencache von WP Rocket aus. Es ist keine manuelle Ausschlussregel erforderlich.

SiteGround Optimizer. Das Plugin schließt seine Skripte automatisch von der Kombination und Minifizierung von JavaScript und CSS des SiteGround Optimizers aus. Wenn Sie nach Bestätigung dieses Konflikts immer noch Probleme haben, deaktivieren Sie manuell Combine JavaScript Files und Minify JavaScript Files (und die entsprechenden CSS-Kombinations- und Minifizierungsoptionen) für die Seite, die das Bestellformular enthält.

Andere Caching-Plugins (WP Super Cache, W3 Total Cache, LiteSpeed Cache usw.). Fügen Sie die URL der Bestellformularseite zur Ausschlussliste des Caches des Plugins hinzu und deaktivieren Sie die JavaScript-Minifizierung und -Kombination für diese Seite.

Seitenersteller (Elementor, Divi, WPBakery). Wenn das Formular in einer Theme-Builder-Vorlage sitzt und leer bleibt, befolgen Sie die Schritte unter Das Formular bleibt in einer Seitenersteller-Vorlage leer oben. Für Breakdance liest das Plugin Shortcodes aus Breakdance-Elementen ab Version 3.0.9 von WooCommerce Wholesale Order Form, sodass kein zusätzlicher Schritt erforderlich ist.

Was Sie beim Kontaktieren des Supports angeben sollten

Wenn der Fehler nach Bearbeitung der obigen Schritte weiterhin besteht, benötigt das Wholesale Suite-Supportteam die folgenden Details zur Untersuchung:

• Die genaue Fehlermeldung aus wp-content/debug.log
• Eine Liste Ihrer aktiven Plugins zum Zeitpunkt des Fehlers
• Ihre PHP-Version und Ihr aktuelles Speicherlimit (sichtbar im Tab Systemstatus unter WooCommerce → Status)
• Der Name und die Version des aktiven Themes
• Alle Änderungen, die kurz vor dem Auftreten des Fehlers an der Website vorgenommen wurden

Häufig gestellte Fragen

Was ist der korrekte Shortcode für das Bestellformular?

Der korrekte Shortcode in Version 3 ist [wwof_product_listing id="XX"], wobei XX die ID des Bestellformulars ist. Kopieren Sie ihn direkt aus dem Formular-Editor unter Wholesale → Order Forms.

Warum zeigt das Bestellformular „Es gibt einen Konfigurationsfehler in diesem Formular“ an?

Diese Meldung erscheint, wenn das id-Attribut im Shortcode fehlt oder wenn die angegebene Bestellformular-ID nicht existiert. Überprüfen Sie, ob Ihr Shortcode die korrekte id enthält, die aus dem Formular-Editor kopiert wurde.

Warum wird mein Bestellformular nicht angezeigt, obwohl der Shortcode korrekt ist?

Die häufigste Ursache ist, dass das Formular noch als Entwurf gespeichert ist. Ein Entwurfsformular wird Administratoren und Shop-Managern angezeigt, aber Kunden und abgemeldete Besucher sehen die Meldung „Zugriff verweigert“, bis das Formular veröffentlicht ist. Öffnen Sie das Formular unter Wholesale → Order Forms und klicken Sie auf Veröffentlichen. Abgemeldete Besucher sehen möglicherweise auch die Meldung „Zugriff verweigert“, wenn das Formular auf bestimmte Rollen beschränkt ist.

Muss ich mein Caching-Plugin konfigurieren, damit es mit dem Bestellformular funktioniert?

Für WP Rocket und SiteGround Optimizer ist keine manuelle Konfiguration erforderlich. Das Plugin kümmert sich automatisch um die Kompatibilität. Fügen Sie für andere Caching-Plugins die Seite mit dem Bestellformular zur Ausschlussliste des Caches hinzu und deaktivieren Sie die JavaScript-Minifizierung für diese Seite.

Warum bleibt das Bestellformular in meiner Divi- oder Elementor-Vorlage leer?

Das Plugin lädt das Formular nur, wenn es den Shortcode im eigenen Inhalt der Seite findet, und eine Theme-Builder-Vorlage wird separat gespeichert. Verschieben Sie den Shortcode in die Seite oder fügen Sie den wwof_force_load_form_posts-Snippet aus Das Formular bleibt in einer Page Builder-Vorlage leer oben hinzu.

Kann ich das Bestellformular verwenden, um eine Bestellung für einen meiner Kunden aufzugeben?

Nein. Das Bestellformular zeigt immer die Preise für das eingeloggte Konto an, und es gibt keinen Modus, um sich als Kunde im Frontend anzumelden. Wenn Sie das Formular als Administrator geöffnet haben, sehen Sie die Preise für Ihr eigenes Konto. Um eine Bestellung zum Großhandelspreis eines Kunden aufzugeben, verwenden Sie stattdessen eine Backend-Bestellung. Mit aktivem Wholesale Prices Premium gehen Sie zu WooCommerce → Bestellungen, klicken Sie auf Bestellung hinzufügen, wählen Sie den Kunden aus und aktivieren Sie Großhandelspreise anwenden. Die vollständigen Schritte finden Sie unter Erstellung manueller Großhandelsbestellungen.

Benötigen Sie Hilfe?

Wenn Sie eine Frage haben oder auf Probleme stoßen, sind wir für Sie da.

• Premium-Benutzer: Support-Ticket eröffnen
• Kostenlose Benutzer: Besuchen Sie unser Community-Forum