Problemen oplossen met de Wholesale Order Form shortcode

Krijg je een kritieke PHP-fout na het toevoegen van de WooCommerce Wholesale Order Form shortcode aan een pagina, maar laadt de pagina prima zodra je deze verwijdert? De oorzaak is vrijwel altijd een onjuiste shortcode-syntaxis, een te lage PHP-geheugenlimiet, of een conflict met een andere plugin. Dit artikel behandelt de meest voorkomende scenario's en begeleidt je bij het isoleren van de exacte oorzaak.

Voordat je begint: controleer je shortcode-syntaxis

In versie 3 van WooCommerce Wholesale Order Form is het juiste shortcode-formaat:

[wwof_product_listing id="XX"]

waarbij XX de numerieke ID van je Bestelformulier is. Een shortcode die zonder het id attribuut wordt geplaatst, of een onjuiste ID gebruikt, zal ofwel een foutmelding geven of helemaal niets tonen.

Om de juiste shortcode voor je formulier te vinden:

1. Ga naar Wholesale Suite → Order Forms in je WordPress-admin.
2. Open het formulier dat je wilt insluiten.
3. Kopieer de shortcode die wordt weergegeven in de formulier-editor.
4. Plak deze op de pagina waar het formulier moet verschijnen.

Als je [wwof_order_form] hebt gebruikt zonder id attribuut, dan wordt dat shortcode-formaat niet meer gebruikt. Vervang het door de shortcode die je hebt gekopieerd uit de formulier-editor.

Veelvoorkomende problemen en oplossingen

De pagina toont "Geen orderformulier-ID opgegeven" of "Er is een configuratiefout"

Beheerders die "Geen orderformulier-ID opgegeven." zien, gebruiken de shortcode zonder het vereiste id attribuut. Vervang de shortcode door degene die is gekopieerd uit Wholesale Suite → Order Forms.

Niet-beheerder bezoekers zien in plaats daarvan "Er is een configuratiefout op dit formulier. Neem contact op met de sitebeheerder." Dit is hetzelfde onderliggende probleem. Los de shortcode op en het bericht verdwijnt voor beiden.

Het bestelformulier wordt helemaal niet weergegeven

Het bestelformulier wordt alleen weergegeven wanneer de status Gepubliceerd is. Een formulier dat als concept is opgeslagen, verschijnt niet op de front-end, zelfs als de shortcode correct is geplaatst. Uitgelogde bezoekers en klanten zien in plaats daarvan een "Toegang geweigerd" restrictiebericht ("Je hebt geen toestemming om dit bestelformulier te bekijken."), dus een conceptformulier lijkt vaak op een permissieprobleem in plaats van een ontbrekend formulier.

1. Ga naar Wholesale Suite → Order Forms.
2. Controleer de status van het formulier. Als deze Concept aangeeft, open het dan en klik op Publiceren.

Er verschijnt een kritieke PHP-fout wanneer de shortcode op de pagina staat

Kritieke fouten die alleen verschijnen wanneer de shortcode aanwezig is, worden veroorzaakt door een plugin-conflict, een caching- of optimalisatieplugin die de JavaScript-bundel van het bestelformulier verkeerd afhandelt, of een te lage PHP-geheugenlimiet. Werk de onderstaande stappen in volgorde door.

Stap 1: schakel WP_DEBUG in om de daadwerkelijke fout te zien

1. Open het wp-config.php-bestand van je site (bevindt zich in je WordPress-rootmap).
2. Zoek de regel define( 'WP_DEBUG', false ); en verander false in true.
3. Voeg direct onder die regel toe: define( 'WP_DEBUG_LOG', true );
4. Sla het bestand op en laad de pagina die de fout activeert opnieuw.
5. Open wp-content/debug.log.
6. Noteer de exacte foutmelding en het bestandspad waarnaar deze verwijst.

Let op: Houd deze foutmelding en het bestandspad bij de hand. U heeft ze nodig als u contact opneemt met de ondersteuning.

Zie Debugging in WordPress voor volledige details over de beschikbare constanten.

Stap 2: controleer de PHP-geheugenlimiet

Het bestelformulier laadt een JavaScript-applicatie die verschillende achtergrondverzoeken naar uw server stuurt. Als PHP tijdens dit proces geen geheugen meer heeft, kan dit leiden tot een fatale fout. De aanbevolen minimum voor WooCommerce-sites, inclusief sites die het Wholesale Order Form gebruiken, is 256 MB.

Om uw huidige limiet te controleren, gaat u naar WooCommerce → Status → Systeemstatus en zoekt u naar de rij PHP Memory Limit. Als deze lager is dan 256 MB, neem dan contact op met uw hostingprovider om deze te verhogen, of voeg de volgende regel toe aan wp-config.php:

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

Stap 3: schakel over naar een standaardthema

Een thema dat conflicterende JavaScript toevoegt of WooCommerce-sjablonen overschrijft, kan het bestelformulier breken. Overstappen naar een standaardthema sluit dit snel uit.

1. Ga naar Weergave → Thema's in het WordPress-beheer.
2. Activeer Storefront of Twenty Twenty-Four.
3. Laad de pagina met de shortcode opnieuw.

Als de fout verdwijnt met het standaardthema actief, is uw oorspronkelijke thema de oorzaak van het conflict. Activeer het opnieuw en deel het debug-logboek met het ondersteuningsteam van uw thema.

Stap 4: isoleer de conflicterende plugin

1. Ga naar Plugins → Geïnstalleerde Plugins.
2. Deactiveer alle plugins behalve WooCommerce en WooCommerce Wholesale Order Form.
3. Laad de pagina met de shortcode opnieuw. Als de fout weg is, is een pluginconflict de oorzaak.
4. Activeer plugins één voor één opnieuw, laad de pagina na elke keer opnieuw. De laatste plugin die u activeerde toen de fout opnieuw verscheen, is de conflicterende.

Bekende pluginconflicten en oplossingen

Verschillende optimalisatie- en cachingplugins vereisen speciale behandeling om samen te werken met het bestelformulier. De plugin bevat ingebouwde compatibiliteit voor sommige hiervan, wat betekent dat er geen handmatige stappen voor nodig zijn.

WP Rocket. Het Wholesale Order Form sluit automatisch pagina's met zijn shortcode uit van de paginacache van WP Rocket. Geen handmatige uitsluitingsregel nodig.

SiteGround Optimizer. De plugin sluit automatisch zijn scripts uit van de combinatie en minificatie van JavaScript- en CSS-bestanden van SiteGround Optimizer. Als u nog steeds problemen ondervindt na het bevestigen dat dit het conflict is, schakel dan handmatig Combineer JavaScript-bestanden en Minimaliseer JavaScript-bestanden (en de equivalente opties voor het combineren en minimaliseren van CSS) uit voor de pagina met het bestelformulier.

Andere cachingplugins (WP Super Cache, W3 Total Cache, LiteSpeed Cache, etc.). Voeg de URL van de bestelformulierpagina toe aan de cache-uitsluitingslijst van de plugin en schakel het minimaliseren en combineren van JavaScript uit voor die pagina.

Pagina-bouwers (Elementor, Divi, WPBakery). Als de shortcode wordt geplaatst in een shortcode-element van een pagina-bouwer en het formulier niet wordt geladen, probeer deze dan rechtstreeks in de WordPress-blokeditor te plaatsen. Voor Breakdance is native shortcode-ondersteuning beschikbaar vanaf WooCommerce Wholesale Order Form versie 3.1.0.

Wat mee te nemen bij het contacteren van support

Als de fout aanhoudt na het doorlopen van de bovenstaande stappen, heeft het supportteam van Wholesale Suite de volgende gegevens nodig om dit te onderzoeken:

• Het exacte foutbericht uit wp-content/debug.log
• Een lijst van uw actieve plugins op het moment van de fout
• Uw PHP-versie en huidige geheugenlimiet (zichtbaar onder WooCommerce → Status → Systeemstatus)
• De naam en versie van het actieve thema
• Eventuele wijzigingen die kort voor het verschijnen van de fout aan de site zijn aangebracht

Veelgestelde vragen

Wat is de juiste shortcode voor het Bestelformulier voor groothandel?

De juiste shortcode in versie 3 is [wwof_product_listing id="XX"], waarbij XX de ID van het bestelformulier is. Kopieer deze rechtstreeks uit de formulier-editor onder Wholesale Suite → Order Forms.

Waarom toont het bestelformulier "Er is een configuratiefout op dit formulier"?

Dit bericht verschijnt wanneer het id-attribuut ontbreekt in de shortcode, of wanneer de opgegeven ID van het bestelformulier niet bestaat. Controleer of uw shortcode de juiste id bevat die is gekopieerd uit de formulier-editor.

Waarom verschijnt mijn bestelformulier niet, ook al is de shortcode correct?

De meest voorkomende oorzaak is dat het formulier nog steeds als Concept is opgeslagen. Een bestelformulier wordt pas op de front-end weergegeven als de status Gepubliceerd is. Open het formulier onder Wholesale Suite → Order Forms en klik op Publiceren. Bezoekers die niet zijn ingelogd, kunnen ook een "Toegang geweigerd"-bericht zien als het formulier beperkt is tot specifieke rollen.

Moet ik mijn caching-plugin configureren om met het bestelformulier te werken?

Voor WP Rocket en SiteGround Optimizer is geen handmatige configuratie nodig. De plugin regelt de compatibiliteit automatisch. Voor andere caching-plugins voegt u de pagina van het bestelformulier toe aan de uitsluitingslijst van de cache en schakelt u JavaScript-minificatie voor die pagina uit.

Hulp nodig?

Als je een vraag hebt of tegen problemen aanloopt, staan we klaar om te helpen.

• Premium gebruikers: Open een ondersteuningsticket
• Gratis gebruikers: Bezoek ons communityforum