Modular Merchant
QuickCode™ Glossary
{PRODUCT-FIELD-VALUES}
QuickCode Tag Glossary Home
See also:
Knowledge Base
Articles in this category:
{COMPOSITE-PRODUCT-IMAGE-SWAP}

{DIGITAL-SAMPLE-BLOCK-BEGIN}

{DIGITAL-SAMPLE-BLOCK-END}

{DIGITAL-SAMPLE-FILE}

{DIGITAL-SAMPLE-NAME}

{IF-BASKET-CONTAINS-SUBSCRIPTION-PRODUCTS-BEGIN}

{IF-DIGITAL-FILE-ELIGIBLE-BEGIN}

{IF-DIGITAL-FILE-ELIGIBLE-END}

{IF-DIGITAL-FILE-RELEASED-BEGIN}

{IF-DIGITAL-FILE-RELEASED-END}

{IF-DIGITAL-SAMPLE-BEGIN}

{IF-DIGITAL-SAMPLE-END}

{IF-PRODUCT-ATTRIBUTE-DESCRIPTION-BEGIN}

{IF-PRODUCT-ATTRIBUTE-DESCRIPTION-END}

{IF-PRODUCT-ATTRIBUTES-BEGIN}

{IF-PRODUCT-ATTRIBUTES-END}

{IF-PRODUCT-FIELD-DESCRIPTION-BEGIN}

{IF-PRODUCT-FIELD-DESCRIPTION-END}

{IF-PRODUCT-IN-ORDER-BEGIN}

{IF-PRODUCT-IN-ORDER-END}

{IF-PRODUCT-IN-SUBSCRIPTION-BEGIN}

{IF-PRODUCT-IN-SUBSCRIPTION-END}

{IF-PRODUCT-MSRP-SAVINGS-BEGIN}

{IF-PRODUCT-MSRP-SAVINGS-END}

{IF-PRODUCT-USES-STOCK-BEGIN}

{IF-PRODUCT-USES-STOCK-END}

{IF-RESULT-BEGIN}

{IF-RESULT-END}

{LIST-CATEGORIES}

{NEWEST-PRODUCT-BLOCK-BEGIN}

{NEWEST-PRODUCT-BLOCK-END}

{PRODUCT-ACTIVE}

{PRODUCT-ADD-TO-BASKET-BUTTON}

{PRODUCT-ATTRIBUTE-DESCRIPTION}

{PRODUCT-ATTRIBUTE-TITLE}

{PRODUCT-ATTRIBUTE-VALUE}

{PRODUCT-BREADCRUMB-LINKS}

{PRODUCT-FIELD-DESCRIPTION}

{PRODUCT-FIELD-TITLE}

{PRODUCT-FIELD-VALUES}

{PRODUCT-FIELD}

{PRODUCT-IMAGE-CAPTION}

{PRODUCT-IMAGE-TAG}

{PRODUCT-IMAGE-URL}

{PRODUCT-IN-SUBSCRIPTION-SUMMARY}

{PRODUCT-LINE-PRICE}

{PRODUCT-LONG-DESCRIPTION}

{PRODUCT-MODIFIER-MENUS}

{PRODUCT-MODIFIER-PRICE-ADJUSTMENT}

{PRODUCT-MODIFIER-VERSION}

{PRODUCT-MSRP-SAVINGS}

{PRODUCT-MSRP}

{PRODUCT-NAME}

{PRODUCT-ORIGINAL-PRICE}

{PRODUCT-PART-NUMBER}

{PRODUCT-PRICE-ORIGINAL}

{PRODUCT-PRICE-SUFFIX}

{PRODUCT-PRICE}

{PRODUCT-QUANTITY-FIELD}

{PRODUCT-REBILL-TERM-TEXT}

{PRODUCT-SHORT-DESCRIPTION}

{PRODUCT-SID}

{PRODUCT-STATUS}

{PRODUCT-UNITS-IN-STOCK}

{PRODUCT-UNITS-IN-STOCK}

{PRODUCT-WEIGHT}

{RECENTLY-VIEWED-PRODUCT-BLOCK-BEGIN}

{RECENTLY-VIEWED-PRODUCT-BLOCK-END}

{RELATED-PRODUCT-BLOCK-BEGIN}

{RELATED-PRODUCT-BLOCK-END}

{SUBCATEGORY-ACTIVE}

{VENDOR-ATTRIBUTE-TITLE}

{XSELL-BLOCK-BEGIN}

{XSELL-BLOCK-END}

Products > {PRODUCT-FIELD-VALUES}
<< {PRODUCT-FIELD-TITLE} {PRODUCT-FIELD} >>
{PRODUCT-FIELD-VALUES} Updated: 01/28/2013

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

Requirements / Prerequisites

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:

basket.template.php {BASKET-PRODUCT-BLOCK-BEGIN}{BASKET-PRODUCT-BLOCK-END}
checkout_x.template.php {BASKET-PRODUCT-BLOCK-BEGIN}{BASKET-PRODUCT-BLOCK-END}
checkout_receipt.template.php {RECEIPT-PRODUCT-BLOCK-BEGIN}{RECEIPT-PRODUCT-BLOCK-END}
checkout_receipt_print.template.php {RECEIPT-PRODUCT-BLOCK-BEGIN}{RECEIPT-PRODUCT-BLOCK-END}
packing_slip.template.php {RECEIPT-PRODUCT-BLOCK-BEGIN}{RECEIPT-PRODUCT-BLOCK-END}
customer_account_1.template.php {ORDER-HISTORY-PRODUCT-BLOCK-BEGIN}{ORDER-HISTORY-PRODUCT-BLOCK-END}
Email Template SID 100: Order Receipt {RECEIPT-PRODUCT-BLOCK-BEGIN}{RECEIPT-PRODUCT-BLOCK-END}
Email Template SID 104: New Order Notification {RECEIPT-PRODUCT-BLOCK-BEGIN}{RECEIPT-PRODUCT-BLOCK-END}
Email Template SID 501: Shipping Update {SHIPMENT-PRODUCT-BLOCK-BEGIN}{SHIPMENT-PRODUCT-BLOCK-END}
Email Template SID 502: Fulfillment Report {FULFILLMENT-REPORT-PRODUCT-BLOCK-BEGIN}{FULFILLMENT-REPORT-PRODUCT-BLOCK-END}

 

 

Example of Use

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

Source Code Source Code Updated:
When a web page using a template that contains this QuickCode Tag is viewed in the storefront, the {PRODUCT-FIELD-VALUES} QuickCode Tag is changed into the source code below prior to the web page being displayed.
LOG IN TO ADD COMMENTS
  Copyright © 2001 - 2024 Modular Merchant™. All rights reserved.
Modular Merchant | Privacy Policy | Legal Statement | Terms of Service | Contact Us | Site Map