Email Message Macros

Table of Contents:

For available macros, right-click in the message body when setting up your email in Lab 50.

General Macros

{%dealer_name%}
{%dealer_web_site%}
{%dealer_phone%}
{%dealer_email%}
{%dealer_unsubscribe_url%}

{%dealer_logo_header%}
{%dealer_logo_footer%}
{%dealer_logo_thumbnail%}
{%dealer_logo_invoice%}

{%customer_email%}
{%customer_first_name%}
{%customer_last_name%}

{%billing_address%}
{%billto_street%}
{%billto_city%}
{%billto_region%}
{%billto_postalcode%}
{%billto_country%}
{%billto_phone%}

{%shipping_address%}
{%shipto_first_name%}
{%shipto_last_name%}
{%shipto_company%}
{%shipto_street%}
{%shipto_city%}
{%shipto_region%}
{%shipto_postalcode%}
{%shipto_country%}
{%shipto_phone%}
{%shipto_email%}

{%item_name%}
{%item_description%}
{%item_quantity%}
{%item_price%}
{%item_total%}

{%order_number%}
{%order_date%}
{%order_total%}
{%order_discount%}
{%order_service_fee%}
{%order_status_url%} >> for subscribers to the Shipment & Delivery Master Bundle this links to your PF site's order status page with detailed tracking and delivery info. If you do not have this Bundle, the order status page will have a link to the carrier's website.

{%rush_order_fee%}
{%order_subtotal%}
{%order_tax%}
{%order_shipping_total%}
{%order_details%}
{%order_source%}
{%shipping_method%}
{%store_location%}
{%store_name%}
{%store_number%}
{%store_phone%}
{%store_address%}
{%store_hours%}
{%apple_wallet_id%}

{%date%}
{%today%}

Shipping and Delivery Macros

>> Go to this page for these macros https://wiki.photofinale.com/pages/viewpage.action?pageId=159875136

Order Details Macros

These macros are used for the repeating section where the order details are displayed.

Aggregated-Items Global Macros

• {%item_name%}
• {%item_quantity%}
• {%item_baseprice%}
• {%item_baseprice_qty%}
• {%item_baseprice_subtotal%}
• {%item_subtotal%}

Aggregated-Item-Discount Subsection Macros

• {%discount_name%}
• {%discount_quantity%}
• {%discount_price%}
• {%discount_savings%}
• {%discount_subtotal%}

Aggregated-Item-Personalization Subsection Macros

• {%personalization%}

Region Macros

Region macros allow you to include/exclude a section of an email message based on a real-time order value.  Examples:

• If one pickup location is closed on Sundays, your Order Confirmation and Order Ready for Pickup emails could show a special "Reminder: This location is closed on Sundays" message for orders that are destined for pickup there.
• You could include a message about a special discount code for future orders in the Order Confirmation message for members only.
• You can include separate information on production times if an order contains supplier-fulfilled products that are produced offsite and shipped.

Syntax

A region macro requires a matching start region tag and end region tag.  The tags are matched using the name parameter.  The name is only used for matching the start and end, so it can be anything that is unique within the email message. 

<!-- pf-region name="XXX" -->
      HTML CONTENT HERE
<!-- pf-region-end name="XXX" --> 

The start region tag also includes a variable parameter which indicates what variable is the comparison criteria, and a value parameter which is the value to match.  For example:

<!-- pf-region name="PickupOrders" variable="OrderType" value="pickup" -->
      HTML CONTENT HERE
<!-- pf-region-end name="PickupOrders" --> 

Reference Guide

The complete list of available variables and associated values:

Nested Regions

Nested Regions are supported, for example:

<!-- pf-region name="PickupOrders" variable="OrderType" value="pickup" -->

    <!-- pf-region name="SupplierOrders" variable="ProductMix" value="supplier" -->

        HTML CONTENT: Your order is being fulfilled by a supplier, we'll call you when your order is ready for pickup in 7-10 business days.
 
    <!-- pf-region-end name="SupplierOrders" --> 

<!-- pf-region-end name="PickupOrders" --> 

Else Statements

A region can include an "ELSE" clause, which will be shown if the region criteria is false, for example:

<!-- pf-region name="LongLeadTimeProducts" variable="IncludesProductTag" value="slow-products" -->

    HTML CONTENT: Your order will be ready in 7-10 days.
 
<!-- pf-region-else name="LongLeadTimeProducts" --> 

     HTML CONTENT: Your order will be ready in 3-4 days.

<!-- pf-region-end name="LongLeadTimeProducts" -->