This QuickCode Tag is used to display all of the product fields and their values associated with a specific product in an order.

Because product field values are entered by the customer, and saved in the order record when the customer completes the order, product field values may only be displayed within the context of a specific order.

The {PRODUCT-FIELD-VALUES} QuickCode Tag may be used in the HTML templates for the basket page (basket.template.php), the checkout pages (checkout_X.template.php), the receipt pages (checkout_receipt.template.php, checkout_receipt_print.template.php, packing_slip.template.php), and the purchase history page of the customer account area (customer_account_1.template.php).

The {PRODUCT-FIELD-VALUES} QuickCode Tag may also be used in the related email templates (SID 100: Order Receipt, SID 104: New Order Notification, SID 501: Shipping Update, SID 502: Fulfillment Report).

The {PRODUCT-FIELD-VALUES} QuickCode Tag must be used within the product block appropriate to the template, and may be used within the {IF-PRODUCT-FIELDS-BEGIN}{IF-PRODUCT-FIELDS-END} block. The product blocks for each template are as follows:

To display the list of product field values for a product in an order, insert the {PRODUCT-FIELD-VALUES} QuickCode Tag at the desired location within the appropriate product block (product block tags for each template are listed above).

For example, the following code in the SID 100: Order Receipt email template would insert the list of product field values on the line below the product name:

Products in this order:
{RECEIPT-PRODUCT-BLOCK-BEGIN}
PRODUCT: {PRODUCT-NAME}{IF-PRODUCT-FIELDS-BEGIN}
{PRODUCT-FIELD-VALUES}{IF-PRODUCT-FIELDS-END}
{RECEIPT-PRODUCT-BLOCK-END}

If the order contains a product named "Product A", for which the customer selected the value "1" for product field "Level" and the values "5A", "4B", and "2C" for the product field "Options"; and the product named "Product B", which does not have any product fields assigned, then the order receipt email would display the following:

Products in this order:
PRODUCT: Product A
Level: 1
Options: 5A, 4B, 2C
PRODUCT: Product B