Cette classe doit être utilisée dans vos modèles personnalisés de panier ou de passage à la caisse. Celle-ci sert à contrôler les détails et paramètres du formulaire dans le panier de commande. Les différents URL de contrôle se retrouveront parmi les propriétés dans la classe Cart ainsi que ceux nécessaires pour l'affichage du coupon-rabais.

> Le formulaire comprend plusieurs champs. Il pourrait être utile que vous en connaissiez leur utilisation, quoi qu'il sera généralement plus approprié d'utiliser les méthodes contrôlant l'affichage de ces champs.

• b: ce champ représente votre identificateur de marchand. C'est un numéro unique vous représentant. Normalement, vous devriez vous servir de la méthode Cart.Form.Begin qui va insérer ce champ automatiquement dans le formulaire.

• Language: ce champ indique dans quelle langue on veut afficher le panier de commande. Normalement ce paramètre provient des pages de produits et ne devrait pas être changé puisqu'il représente la langue dans laquelle le client a navigué dans votre site. Vous devriez vous servir de la méthode Cart.Form.Begin qui va insérer ce champ automatiquement dans le formulaire.

• URLEnd: ce champ représente l'adresse de retour, i.e. la page de laquelle le client est parti avant d'arriver au panier de commande. Cet URL sera utilisé par la méthode Cart.Form.ReturnURL. Normalement, vous devriez vous servir de la méthode Cart.Form.Begin qui va insérer ce champ automatiquement dans le formulaire. Lors de l'ajout d'un produit dans le panier, si URLEnd est égal à cart, on dirigera automatiquement vers le panier de commande, puis le bouton de retour ramènera à la page du produit.

• URLEnd2: ce champ a la même utilité que le champ URLEnd, sauf qu'il ne sera utilisé que dans l'affichage du panier, ce qui laissera la possibilité de passer le paramètre URLEnd=cart envoyant ainsi le client vers le panier pour ensuite le diriger vers URLEnd2.

• m: ce champ indique si on est en mode aperçu ou non. Si m est vide, on est en utilisation normale. Si m=1, on est en mode aperçu. Normalement, vous devriez vous servir de la méthode Cart.Form.Begin qui va insérer ce champ automatiquement dans le formulaire.

• P1: ce champ indique que l'on veut demander un recalcul du panier. De base, le formulaire va toujours renvoyer au recalcul du panier. Normalement, vous devriez vous servir de la méthode Cart.Form.Begin qui va insérer ce champ automatiquement dans le formulaire.

• Item: ce champ représente l'identificateur de produit que vous affichez. Ce champ ne sera utile que si vous affichez la quantité achetée en utilisant un champ texte modifiable. Si vous utilisez ce champ dans votre formulaire, on devra retrouver celui-ci autant de fois qu'il y a de produits dans le panier. Utilisez la propriété Item.ID pour obtenir cette valeur.

• Option: ce champ représente les options du produit commandé. Ce champ ne sera utile que si vous affichez la quantité achetée en utilisant un champ texte modifiable. La valeur de ce champ doit correspondre à tous les identifiants de valeurs d'options (Item.Option.Value.ID) qui ont été choisies, séparés par des symboles +. Par exemple, un produit qui a été choisi avec les valeurs d'options 123 et 456 (Item.Option.Value.ID) devra avoir un champ Options="123+456" (dans un formulaire, vous aurez seulement besoin d'avoir 2 champs Options; ceux-ci s'additionneront automatiquement). Par contre, si l'option était falculative (vous pouvez tester cette propriété avec Item.Option.Value.Required) et que cette option n'a pas été choisie, la valeur d'option à insérer devra plutôt correspondre à la valeur négative de l'identifiant d'option (-Item.Option.ID).

• Q: ce champ représente la quantité commandée d'un produit. Ce champ ne sera utile que si vous affichez la quantité achetée en utilisant un champ texte modifiable. Utilisez la propriété Cart.Form.Item.Quantity pour afficher en entier ce champ. Vous pouvez également utiliser la propriété Cart.Form.Item.ChangeQuantityURL pour modifier la quantité d'un produit dans le panier. Si vous utilisez ce champ dans votre formulaire, on devra retrouver celui-ci autant de fois qu'il y a de produits dans le panier.

Voici les méthodes et propriétés de la classe Cart:

• AddToTotal (méthode)
• Form (objet)
  • Begin (méthode)
  • Currency (propriété)
    • Code (propriété)
    • ID (propriété)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • Name (propriété)
  • End (méthode)
  • Item (objet)
    • ChangeQuantityURL (propriété)
    • DeleteURL (propriété)
    • Quantity (propriété)
  • Language (objet)
    • Code (propriété)
    • ID (propriété)
    • Name (propriété)
  • ReturnURL (propriété)
• Inventory (objet)
  • Message (propriété)
• NbFiles (propriété)
• NbItems (propriété)
• NbKeys (propriété)
• NbServices (propriété)
• Promotion (objet)
  • Coupon (objet)
    • AddToTotal (méthode)
    • Code (propriété)
    • DeleteURL (propriété)
    • Discarded (propriété)
    • Rebate (propriété)
    • Support (propriété)
• Quantity (propriété)
• Saved (objet)
  • CustomerName (propriété)
  • DateCreated (propriété)
  • Description (propriété)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • URL (propriété)
• Section (objet)
  • AskForCurrency (méthode)
  • AskForMinimum (méthode)
  • Begin (méthode)
  • End (méthode)
• SubTotal (propriété)
• Weight (propriété)