Summary

Properties

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.

Class attribute edit interface for the "Price" datatype.

Parameters and usage

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.)

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.

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.

Object attribute edit interface

The following screenshot shows the object attribute edit interface for this datatype.

Object attribute edit interface for the "Price" datatype.

Raw output

The ".content" of an ezcontentobjectattribute object using this datatype returns an ezprice object.