Skip to main content

​
Aperçu

Ce paramètre fait deux choses :
  1. Il met en file d’attente les appels au panier Ajax de Shopify. Lorsque plusieurs scripts sollicitent l’API de panier Ajax de Shopify (/cart/add, /cart/add.js, /cart/update.js, /cart/change.js) en même temps, Shopify perd parfois l’une des modifications. Upcart force ces appels à s’exécuter un par un afin que chaque mise à jour soit prise en compte. C’est l’objectif principal de ce paramètre.
  2. Il se retire de l’ajout au panier. Il désactive également la gestion intégrée de l’ajout au panier d’Upcart, afin qu’une application ou un thème qui a besoin d’un contrôle total sur ce flux n’entre pas en conflit avec elle.
Les deux comportements sont liés à la même case à cocher — vous ne pouvez pas activer la mise en file d’attente des requêtes sans renoncer aussi à la gestion de l’ajout au panier d’Upcart.

​
Où le trouver

Ouvrez l’éditeur de panier, allez dans Settings > Cart settings, puis développez Advanced Settings.
Recherchez « Enhanced Ajax API compatibility ».

​
Fonctionnement

Upcart conserve le contrôle total du processus d’ajout au panier. Cela garantit un comportement cohérent et permet à Upcart d’empêcher d’autres applications ou scripts de remplacer le flux du panier. Il s’agit du paramètre recommandé pour la plupart des boutiques. Laissez-le désactivé, sauf si vous rencontrez des problèmes spécifiques où Upcart n’intercepte pas les événements d’ajout au panier provenant de votre thème ou d’autres applications.

​
Activé

Upcart ne gérera plus le processus d’ajout au panier. Cela permet à d’autres applications, à du JavaScript personnalisé ou à votre thème de modifier le panier sans interférence. Activez ce paramètre UNIQUEMENT lorsque :
  • Votre boutique utilise une API de panier AJAX non standard
  • Upcart n’intercepte pas les événements d’ajout au panier provenant de votre thème ou d’autres applications
  • Vous avez besoin que des applications tierces aient un contrôle direct sur le comportement du panier
Compromis importants lorsqu’il est activé :
  • D’autres applications peuvent rediriger les clients vers la page de panier Shopify au lieu d’ouvrir le tiroir Upcart
  • Vous pouvez rencontrer des boucles de redirection ou un comportement inattendu du panier
  • Upcart ne peut pas empêcher les applications externes de modifier le comportement du panier
Si l’activation provoque des boucles de redirection :
  1. Désactivez ce paramètre
  2. Utilisez plutôt l’API manuelle d’Upcart (upcartRegisterAddToCart)
  3. Consultez les guides d’intégration pour des applications spécifiques (par ex. Replo)

​
Tests

Après avoir modifié ce paramètre :
  1. Cliquez sur Save
  2. Testez l’ajout de produits à votre panier
  3. Vérifiez que le tiroir Upcart s’ouvre correctement
  4. Vérifiez que vous n’êtes pas redirigé vers la page de panier Shopify
Si vous rencontrez des problèmes après l’activation, désactivez le paramètre et contactez le support pour des solutions alternatives.