Dépannage du shortcode du formulaire de commande en gros

Vous avez ajouté le shortcode du formulaire de commande en gros à une page, et maintenant le formulaire est manquant, affiche une erreur ou casse la page ? La plupart des cas se résument au shortcode lui-même, au statut du formulaire, à un modèle de constructeur de page ou à un conflit avec un autre plugin. Ce guide vous guide à travers chaque symptôme afin que vous puissiez trouver la cause et faire réapparaître le formulaire.

Avant de commencer : vérifiez la syntaxe de votre shortcode

Dans la version 3 de WooCommerce Wholesale Order Form, le format de shortcode correct est :

[wwof_product_listing id="XX"]

où XX est l’ID numérique de votre formulaire de commande. Un shortcode placé sans l’attribut id, ou utilisant un ID incorrect, affiche un message d’erreur ou ne montre rien du tout.

Pour trouver le shortcode correct pour votre formulaire :

1. Accédez à Vente en gros → Formulaires de commande dans votre administration WordPress.
2. Ouvrez le formulaire que vous souhaitez intégrer.
3. Copiez le shortcode affiché dans l'éditeur de formulaire.
4. Collez-le sur la page où vous souhaitez que le formulaire apparaisse.

Si vous utilisiez [wwof_order_form] sans attribut id, ce format de shortcode n'est plus utilisé. Remplacez-le par le shortcode copié depuis l'éditeur de formulaire.

Problèmes courants et solutions

La page affiche « Aucun ID de formulaire de commande spécifié », « n’existe pas » ou « Il y a une erreur de configuration »

Les administrateurs qui voient « Aucun ID de formulaire de commande spécifié. » utilisent le shortcode sans l’attribut id requis. Les administrateurs qui voient un message comme « L’ID du formulaire de commande 123 n’existe pas ! » utilisent un ID qui ne correspond à aucun formulaire de commande, par exemple l’ID d’un formulaire qui a été supprimé. Dans les deux cas, remplacez le shortcode par celui copié depuis Ventes en gros → Formulaires de commande.

Les visiteurs non-administrateurs voient « Il y a une erreur de configuration sur ce formulaire. Veuillez contacter l’administrateur du site. » à la place, pour un ID manquant et pour un ID erroné. C’est le même problème sous-jacent. Corrigez le shortcode et le message disparaît pour les deux.

Le formulaire de commande ne s'affiche pas du tout

Les clients ne peuvent voir un formulaire de commande que lorsque son statut est Publié. Un formulaire brouillon s’affiche toujours aux administrateurs et aux responsables de boutique, donc la page peut sembler correcte lorsque vous êtes connecté. Les clients et les visiteurs déconnectés voient un message « Accès refusé » (« Vous n’avez pas la permission de voir ce formulaire de commande. ») à la place, donc un formulaire brouillon ressemble souvent à un problème de permission plutôt qu’à un formulaire manquant. Pour voir ce que vos clients voient, ouvrez la page dans une fenêtre privée ou incognito.

1. Allez à Wholesale → Order Forms.
2. Vérifiez le statut du formulaire. S'il indique Brouillon, ouvrez-le et cliquez sur Publier.

Le formulaire reste vide dans un modèle de constructeur de page

La page se charge, mais l’espace où le formulaire de commande devrait se trouver reste vide. Cela se produit lorsque le shortcode se trouve dans un modèle de constructeur de thème, tel qu’un modèle Divi Theme Builder ou un modèle Elementor Pro, au lieu du contenu de la page elle-même.

Le formulaire de commande en gros charge son script de formulaire uniquement lorsqu’il trouve le shortcode dans le contenu de la page consultée. Un modèle est stocké séparément de la page, donc le plugin ne voit pas le shortcode là-bas. Le conteneur de formulaire vide s’imprime, mais le script qui le remplit ne se charge jamais.

La solution la plus simple est de placer le shortcode dans le contenu de la page elle-même, par exemple dans l’éditeur de blocs ou dans un module de constructeur sur cette page. Si vous souhaitez conserver le formulaire dans le modèle, ajoutez un extrait de shortcode qui indique au plugin de charger le formulaire sur cette page.

Pour ajouter l’extrait :

1. Accédez à WooCommerce → Formulaires de commande et notez l’ID de votre formulaire. C’est le numéro dans le shortcode du formulaire, par exemple 123 dans [wwof_product_listing id="123"].
2. Notez le slug de la page qui affiche le modèle, par exemple wholesale-ordering pour votrestore.com/wholesale-ordering/. L’ID de la page fonctionne aussi.
3. Ajoutez l’extrait ci-dessous avec un plugin d’extraits de code tel que WPCode, ou ajoutez-le au fichier functions.php de votre thème enfant.
4. Remplacez wholesale-ordering par le slug de votre page et 123 par l’ID de votre formulaire, puis enregistrez.
5. Videz le cache de votre site et rechargez la page.

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;
} );

Un extrait peut charger autant de formulaires que nécessaire. Ajoutez une ligne par formulaire à l’intérieur de la vérification pour la page qui l’affiche :

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;
} );

Sur une page où l’extrait charge des formulaires, le plugin utilise la liste de l’extrait et arrête de rechercher des shortcodes dans le contenu de la page. Si cette page contient également un formulaire de commande dans son contenu, ajoutez ce formulaire à l’extrait également.

La vérification is_page() correspond aux pages WordPress normales. Si votre modèle s’affiche sur un autre type d’écran, modifiez la vérification pour qu’elle corresponde à cet écran.

Une erreur PHP critique apparaît lorsque le shortcode est sur la page

Les erreurs critiques qui n'apparaissent que lorsque le shortcode est présent sont causées par un conflit de plugin, un plugin de mise en cache ou d'optimisation qui gère mal le bundle JavaScript du formulaire de commande, ou une limite de mémoire PHP trop basse. Suivez les étapes ci-dessous dans l'ordre.

Étape 1 : activer WP_DEBUG pour voir l'erreur réelle

1. Ouvrez le fichier wp-config.php de votre site (situé dans le répertoire racine de WordPress).
2. Trouvez la ligne define( 'WP_DEBUG', false ); et remplacez false par true.
3. Juste en dessous de cette ligne, ajoutez : define( 'WP_DEBUG_LOG', true );
4. Enregistrez le fichier et rechargez la page qui déclenche l'erreur.
5. Ouvrez wp-content/debug.log.
6. Notez le message d'erreur exact et le chemin du fichier auquel il fait référence.

Conservez ce message d’erreur et ce chemin de fichier à portée de main. Vous en aurez besoin si vous contactez le support.

Voir Débogage dans WordPress pour plus de détails sur les constantes disponibles.

Étape 2 : vérifier la limite de mémoire PHP

Le formulaire de commande charge une application JavaScript qui effectue plusieurs requêtes en arrière-plan vers votre serveur. Si PHP manque de mémoire pendant ce processus, une erreur fatale peut survenir. Le minimum recommandé pour les sites WooCommerce, y compris ceux exécutant le formulaire de commande de gros, est de 256 Mo.

Pour vérifier votre limite actuelle, accédez à WooCommerce → Statut, ouvrez l’onglet État du système et recherchez la ligne Limite de mémoire WordPress. Si elle est inférieure à 256 Mo, contactez votre fournisseur d’hébergement pour l’augmenter, ou ajoutez la ligne suivante à wp-config.php :

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

Étape 3 : passer à un thème par défaut

Un thème qui ajoute du JavaScript conflictuel ou surcharge les modèles WooCommerce peut casser le formulaire de commande. Passer à un thème par défaut permet d'éliminer rapidement ce problème.

1. Allez dans Apparence → Thèmes dans l'administration WordPress.
2. Activez Storefront ou Twenty Twenty-Four.
3. Rechargez la page avec le shortcode.

Si l'erreur disparaît avec le thème par défaut actif, votre thème d'origine est la source du conflit. Réactivez-le et partagez le journal de débogage avec l'équipe de support de votre thème.

Étape 4 : isoler le plugin conflictuel

1. Allez dans Extensions → Extensions installées.
2. Désactivez tous les plugins sauf WooCommerce et vos plugins Wholesale Suite : WooCommerce Wholesale Prices, WooCommerce Wholesale Order Form et WooCommerce Wholesale Prices Premium si vous l’utilisez.
3. Rechargez la page avec le shortcode. Si l'erreur a disparu, un conflit de plugin en est la cause.
4. Réactivez les extensions une par une, en rechargeant la page après chacune. La dernière extension que vous avez activée lorsque l'erreur réapparaît est celle qui pose conflit.

Conflits de plugins connus et solutions de contournement

Plusieurs plugins d'optimisation et de mise en cache nécessitent une manipulation spéciale pour fonctionner avec le formulaire de commande. Le plugin inclut une compatibilité intégrée pour certains d'entre eux, ce qui signifie qu'aucune étape manuelle n'est nécessaire pour ceux-ci.

WP Rocket. Le formulaire de commande de gros exclut automatiquement les pages contenant son shortcode de la mise en cache de page de WP Rocket. Aucune règle d'exclusion manuelle n'est nécessaire.

SiteGround Optimizer. Le plugin exclut automatiquement ses scripts de la combinaison et de la minification JavaScript et CSS de SiteGround Optimizer. Si vous rencontrez toujours des problèmes après avoir confirmé qu’il s’agit du conflit, désactivez manuellement Combiner les fichiers JavaScript et Minifier les fichiers JavaScript (et les options équivalentes de combinaison et de minification CSS) pour la page contenant le formulaire de commande.

Autres plugins de mise en cache (WP Super Cache, W3 Total Cache, LiteSpeed Cache, etc.). Ajoutez l'URL de la page du formulaire de commande à la liste d'exclusion de cache du plugin et désactivez la minification et la combinaison JavaScript pour cette page.

Constructeurs de pages (Elementor, Divi, WPBakery). Si le formulaire se trouve dans un modèle de constructeur de thème et reste vide, suivez les étapes de la section Le formulaire reste vide dans un modèle de constructeur de page ci-dessus. Pour Breakdance, le plugin lit les shortcodes des éléments Breakdance à partir de la version 3.0.9 de WooCommerce Wholesale Order Form, donc aucune étape supplémentaire n’est nécessaire.

Ce qu'il faut inclure lors de la prise de contact avec le support

Si l’erreur persiste après avoir suivi les étapes ci-dessus, l’équipe de support de Wholesale Suite a besoin des détails suivants pour enquêter :

• Le message d'erreur exact de wp-content/debug.log
• Une liste de vos plugins actifs au moment de l'erreur
• Votre version de PHP et votre limite de mémoire actuelle (visibles dans l’onglet État du système sous WooCommerce → Statut)
• Le nom et la version du thème actif
• Toutes les modifications apportées au site peu de temps avant l'apparition de l'erreur

Questions fréquemment posées

Quel est le shortcode correct pour le formulaire de commande de gros ?

Le shortcode correct dans la version 3 est [wwof_product_listing id="XX"], où XX est l'ID du formulaire de commande. Copiez-le directement depuis l'éditeur de formulaire dans Wholesale → Order Forms.

Pourquoi le formulaire de commande affiche-t-il "Il y a une erreur de configuration sur ce formulaire" ?

Ce message apparaît lorsque l'attribut id est manquant dans le shortcode, ou lorsque l'ID du formulaire de commande spécifié n'existe pas. Vérifiez que votre shortcode inclut le bon id copié depuis l'éditeur de formulaire.

Pourquoi mon formulaire de commande n'apparaît-il pas même si le shortcode est correct ?

La cause la plus fréquente est que le formulaire est toujours enregistré comme Brouillon. Un formulaire brouillon s'affiche pour les administrateurs et les responsables de boutique, mais les clients et les visiteurs non connectés voient un message « Accès refusé » jusqu'à ce que le formulaire soit Publié. Ouvrez le formulaire dans Wholesale → Order Forms et cliquez sur Publier. Les visiteurs non connectés peuvent également voir un message « Accès refusé » si le formulaire est restreint à des rôles spécifiques.

Dois-je configurer mon plugin de mise en cache pour qu'il fonctionne avec le formulaire de commande ?

Pour WP Rocket et SiteGround Optimizer, aucune configuration manuelle n'est nécessaire. Le plugin gère automatiquement la compatibilité. Pour les autres plugins de mise en cache, ajoutez la page du formulaire de commande à la liste d'exclusion de cache et désactivez la minification JavaScript pour cette page.

Pourquoi le formulaire de commande reste-t-il vide dans mon modèle Divi ou Elementor ?

Le plugin ne charge le formulaire que lorsqu'il trouve le shortcode dans le contenu de la page elle-même, et un modèle de constructeur de thème est stocké séparément. Déplacez le shortcode dans la page, ou ajoutez l'extrait wwof_force_load_form_posts de la section Le formulaire reste vide dans un modèle de constructeur de page ci-dessus.

Puis-je utiliser le formulaire de commande pour passer une commande pour l'un de mes clients ?

Non. Le formulaire de commande affiche toujours les prix du compte connecté, et il n'existe aucun mode pour acheter en tant que client sur le front-end. Si vous ouvrez le formulaire connecté en tant qu'administrateur, vous voyez les prix de votre propre compte. Pour passer une commande au prix de gros d'un client, utilisez plutôt une commande backend. Avec Wholesale Prices Premium actif, allez dans WooCommerce → Orders, cliquez sur Add order, sélectionnez le client et cochez Apply Wholesale Pricing. Pour les étapes complètes, consultez comment créer des commandes de gros manuelles.

Besoin d'aide ?

Si vous avez une question ou rencontrez des problèmes, nous sommes là pour vous aider.

• Utilisateurs premium : Ouvrir un ticket de support
• Utilisateurs gratuits : Visitez notre forum communautaire