Date de publication: le mardi 14 août 2007 à 15h21
Dernière modification: par Pascal BOYER le jeudi 24 février 2011 à 00h54

05/05/2006 3:37

Summary / Résumé

Stores a price (inc/ex VAT). [Webshop]
Stocke un prix (incluant/excluant la TVA). (datatype spécifique au système d'e-commerce)

Properties / Propriétés

Description

This datatype allows the storage of a price and thus makes it possible to connect content objects with the e-commerce subsystem. The e-commerce features of eZ Publish are described in the "Webshop" section of the "Concepts and basics" chapter. The following screenshot shows the class attribute edit interface for this datatype.
Ce datatype permet de stocker un prix et donc de connecter des objets de contenus au sous-système de e-commerce. La fonction de commerce en ligne de eZ Publish est décrite par le document Commerce en ligne de la section Concepts et bases . La capture d'écran ci-dessous montre l'interface d'édition des attributs de classe dans le cas du datatype Prix

Class attribute edit interface for the "Price" datatype.
Interface d'édition des attributs de classe dans le cas du datatype Prix

Parameters and usage / Paramètres et utilisation

This is a special datatype which plugs more deeply into the system. Instances of any class containing the price datatype will automatically be treated as products. This datatype does not support prices in multiple currencies. It makes possible to set only one price value for each product (the system will use your locale currency for this price). However, you can use the "Multi-price" datatype for multi-currency support. (Please note that price and multi-price datatypes are incompatible. A content class can only contain one price attribute or one multi-price attribute.)
Ce datatype particulier est profondément lié au système. Les instances de n'importe quelle classe contenant un datatype Prix seront automatiquement traitées comme un produit. Ce datatype ne permet pas de définir des prix exprimés dans plusieurs devises. Par conséquent, il ne permet de définir qu'un seul prix pour chacun des produits (le système utilisera la devise liée à votre locale pour le prix). Par contre, vous pouvez recourir au datatype Prix multiple si vous souhaitez exprimer des prix dans plusieurs monnaies. Retenez que les deux datatypes Prix et Prix multiple sont incompatibles. Une classe de contenu ne peut contenir qu'un attribut Prix ou qu'un attribut Prix multiple.

A class attribute represented by the price datatype makes use of one of the predefined VATs. There are two ways in which the selected VAT can be used. This configuration depends on how the product prices are entered when the objects are created. The first alternative (Price inc. VAT) is to be used if the prices that are entered already include the value added tax. The second alternative (Price ex. VAT) should be used if the prices that are entered do not contain the value added tax. When the first alternative is used and the product is viewed, the price that was entered will be shown.
Un attribut de classe basé sur le datatype Prix utilise l'une des TVA prédéfinies et il existe deux moyens d'utiliser la TVA sélectionnée. Cette configuration dépend de la manière avec laquelle les prix sont définis lors de la création des objets. La première possibilité (Prix incluant la TVA) est utilisée lorsque les prix définis incluent déjà la TVA. La seconde possibilité (Prix excluant la TVA) est utilisée lorsque les prix définis n'incluent pas la TVA. Avec la première solution, le prix apparaît, tel qu'il a été défini, lorsque le produit associé est affiché.

When the second alternative is used and the product is viewed, the price will be the price that was entered plus the VAT. When the object is in the basket and the basket is viewed, it is possible to see the price of the products with and without the VATs (regardless of which approach that was used). The VAT parameters on the class level only control the default VAT settings that will be used when a new object is created. In other words, the VAT settings may be modified for each individual product / object.
Avec la seconde solution, lorsque le produit est affiché, le prix vu correspond au prix défini augmenté de la TVA. Lorsque le produit est placé dans le panier d'achat et que l'on affiche le contenu de ce dernier, alors on peut voir le prix avec et sans la TVA (indépendamment de l'approche utilisée). Au niveau de la classe, les paramètres de TVA ne définissent que la TVA par défaut à utiliser lors de la création de nouveaux objets. En d'autres termes, cela signifie que les paramètres de TVA peuvent être modifiés pour chacun des produits/objets.

Object attribute edit interface / Interface d'édition des attributs d'objet

The following screenshot shows the object attribute edit interface for this datatype.
La capture d'écran ci-dessous montre l'interface d'édition des attributs d'objet dans le cas du datatype Prix.

Object attribute edit interface for the "Price" datatype.
 Interface d'édition des attributs d'objet dans le cas du datatype Prix

Raw output / Sortie brute

The ".content" of an ezcontentobjectattribute object using this datatype returns an ezprice object.
La partie .content d'un objet ezcontentobjectattribute utilisant un attribut basé sur ce datatype renvoie un objet ezprice .