Email Templates for AbleCommerce 7.0.1

Title: Email Template Modifications for Order Number

Version: AbleCommerce 7.0.1 Asp.Net

Applies to: Upgrading from version 7.0.0 to 7.0.1

Date:  11/14/2008

Download: AC71_email_templates.zip

DETAILS

Email Template Modifications for Order Number

PART ONE)

After upgrading from AbleCommerce 7.0 to 7.0.1, you will need to modify any email templates that reference Order ID.  In this upgrade, the Order ID has been replaced by Order Number.  In the list below, we have shown which templates require modification.  

• Customer Order Notification

• Vendor Notification

• Gift Certificate Validated

• Order Shipped Partial

• Order Shipped

• ESD file is activated

• License key is fulfilled

• Note added by customer

• Note added by merchant

Depending on your abilities, we have three instructional options for updating your templates:

• Basic - the basic criteria that will be used to search and replace within all templates listed above.

• Detailed - line-by-line instructions for all changes, categorized using the name of each email template.

• Re-install - use these instructions to re-install any modified templates.  This assumes you have made little to no changes to the existing templates.

PART TWO)

Next, you will need to change the Subject line for any email template that references Order ID.  The detailed changes are shown in the table below or you can find all instances of $order.OrderID and change each of them to $order.OrderNumber

This change impacts the subject line of the following four templates:  

• Customer Order Notification

• Gift Certificate Validated

• Note added by customer

• Note added by merchant

PART THREE)

This last step is optional.  It includes some additional modifications that will show coupons itemized and summarized in the emailed order notifications.  The changes are detailed in the Coupon section below.  The changes should be made to the following three templates:

• Customer Order Notification

• Order Shipped

• Order Shipped Partial

BASIC INSTRUCTIONS:

These instructions are intended for a customer who is capable of finding the necessary code within each email template and adjusting accordingly.  If you would like to have a line by line detail of each adjustment for each template, skip to the next section.

For each of the affected email templates.

1. First replace URLs:
   
   FIND: aspx?OrderId=$order.OrderId
   
   REPLACE: aspx?OrderNumber=$order.OrderNumber&OrderId=${order.OrderId}

2. Next, replace displayed number:
   
   FIND: $order.OrderId
   
   REPLACE: $order.OrderNumber

DETAILED INSTRUCTIONS:

These instructions are intended for a customer who needs step-by-step detail of each change.  The itemization of each code modification is shown in the sections below.  The heading of each section is the name of the email template.  To begin, login to your merchant menu and go to Configure > Email > Templates.  Find the name of the email template you wish to modify and click the EDIT icon.

Since we have used line numbers as a guide to the location of each change, you may wish to copy the entire text into an editor that provides line numbering.  After making changes, just copy and paste the entire text back into the email template text field and save.

Make sure to remove any extraneous line breaks that may result from copying from this document.

Customer Order Notification

On, or near line 57, find:

<td class="Email" width="500"><p>$order.OrderId</p></td>

Replace line above with:

<td class="Email" width="500"><p>$order.OrderNumber</p></td>

On, or near line 73, find:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">View Online</a></td>

Replace line above with:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">View Online</a></td>

Vendor Notification

On, or near line 45, find:

<strong>Order Number</strong>: $order.OrderId<br>

Replace line above with:

<strong>Order Number</strong>: $order.OrderNumber<br>

Gift Certificate Validated

On, or near line 62, find:

<td class="Email" width="500"><p>$order.OrderId</p></td>

Replace line above with:

<td class="Email" width="500"><p>$order.OrderNumber</p></td>

On, or near line 78, find:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">View Online</a></td>

Replace line above with:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">View Online</a></td>

Order Shipped Partial

On, or near line 59, find:

<td class="Email" width="500"><p>$order.OrderId</p></td>

Replace line above with:

<td class="Email" width="500"><p>$order.OrderNumber</p></td>

On, or near line 74, find:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">View Online</a></td>

Replace line above with:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">View Online</a></td>

Order Shipped

On, or near line 61, find:

<td class="Email" width="500"><p>$order.OrderId</p></td>

Replace line above with:

<td class="Email" width="500"><p>$order.OrderNumber</p></td>

On, or near line 74, find:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">View Online</a></td>

Replace line above with:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">View Online</a></td>

ESD file is activated

On, or near line 40, find:

<p><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">  View your Order Online</a>

Replace line above with:

<p><a  href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">  View your Order Online</a>

On, or near line 63, find:

<td class="Email" width="500"><p>$order.OrderId</p></td>

Replace line above with:

<td class="Email" width="500"><p>$order.OrderNumber</p></td>

On, or near line 79, find:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">View Online</a></td>

Replace line above with:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">View Online</a></td>

License key is fulfilled

On, or near line 40, find:

<p><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">  View your Order Online</a>

Replace line above with:

<p><a  href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">  View your Order Online</a>

On, or near line 67, find:

<td class="Email" width="500"><p>$order.OrderId</p></td>

Replace line above with:

<td class="Email" width="500"><p>$order.OrderNumber</p></td>

On, or near line 83, find:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=$order.OrderId">View Online</a></td>

Replace line above with:

<td class="Email"><a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">View Online</a></td>

Note added by customer

On, or near line 29, find:

<p><strong>On ${note.CreatedDate}, a new message&nbsp;was added to <a href="${store.StoreUrl}Admin/Orders/OrderHistory.aspx?OrderId=$order.OrderId">Order Number $order.OrderId</a></strong></p>

Replace line above with:

<p><strong>On ${note.CreatedDate}, a new message&nbsp;was added to <a href="${store.StoreUrl}Admin/Orders/OrderHistory.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">Order Number $order.OrderNumber</a></strong></p>

Note added by merchant

On, or near line 29, find:

<p>A message has been added to your Order Number $order.orderId.&nbsp;</p>

Replace the line above with:

<p>A message has been added to your Order Number $order.orderNumber.&nbsp;</p>

On, or near line 32, find:

<p><strong>To respond to this message, you will need to login and <a href="${store.StoreUrl}Members/MyOrder.aspx?OrderId=${order.OrderId}">view Order $order.OrderId.</a></strong></p>

Replace the line above with:

<p><strong>To respond to this message, you will need to login and <a href="${store.StoreUrl}Members/MyOrder.aspx?OrderNumber=$order.OrderNumber&OrderId=$order.OrderId">view Order $order.OrderNumber.</a></strong></p>

Modifications to show Coupons (optional)

The following changes are optional.  If applied, they will show coupons itemized in the invoice display and also summarized in the order sub-total.

The three changes below are applicable to 3 email templates so line number may vary.  The templates are:

• Customer Order Notification

• Order Shipped

• Order Shipped Partial (does not include last change)

On, or near line 148, find:

#if (($orderItem.OrderItemType == "Product") || ($orderItem.OrderItemType == "Discount") || ($orderItem.OrderItemType == "GiftWrap") )

Replace line above with:

#if (($orderItem.OrderItemType == "Product") || ($orderItem.OrderItemType == "Discount") ||  ($orderItem.OrderItemType == "Coupon") || ($orderItem.OrderItemType == "GiftWrap") )

On, or near line 154, find the following lines of code:

#elseif (($orderItem.OrderItemType == "Discount"))
DISCOUNT

ADD the following lines of code after DISCOUNT:

#elseif (($orderItem.OrderItemType == "Coupon"))
COUPON

On, or near line 267, ADD the following lines of code after the ending </tr> for Discounts and before the beginning <tr> for Total:

<tr>
<td width="40%" style="background:#cccccc; color:#00000; text-align: right;">
<strong>Coupons:</strong>
</td>
<td width="15%" class="Email" style="text-align: right;">
$order.Items.TotalPriceById(5).ToString("C")
</td>
</tr>

RE-INSTALLING AN EMAIL TEMPLATE:

If you choose to re-install the already modified AbleCommerce 7.0.1 email templates.

1. Login to AbleCommerce Merchant Admin.

2. Go to Configure > Email > Templates.

3. Find the email template you wish to change and click the EDIT icon.

4. Change the Subject line as noted in the table below. (4 modifications necessary)

5. Copy and Paste the full html text from each modified template in the available download.  Be sure to remove the existing html from the field first.

6. Click the SAVE button when finished.

7. Repeat for each modified template as indicated.

Stock Email Template Configurations for AbleCommerce 7.0.1

The templates which are highlighted have been modified since AbleCommerce 7.0.  The subject line, also shown with highlighted text, has been modified to replace $order.OrderID with $order.OrderNumber.