Difference between revisions of "Customizing Email Templates"

From AbleCommerce Wiki
Jump to: navigation, search
Line 10: Line 10:
 
<code>
 
<code>
 
<pre>
 
<pre>
Object     Type                             Available To
+
Object         Type                     Available To
------------------------------------------------------------------------------------------------------
+
----------------------------------------------------------------------------------------------------
  
store     CommerceBuilder.Stores.Store         All Events
+
store         CommerceBuilder.Stores.Store     All Events
  
order     CommerceBuilder.Orders.Order         OrderStatusUpdated, PaymentAuthorized,
+
order         CommerceBuilder.Orders.Order     OrderStatusUpdated, PaymentAuthorized,
 
                                                 PaymentCaptured, PaymentCapturedPartial,
 
                                                 PaymentCaptured, PaymentCapturedPartial,
 
                                                 PaymentAuthorizationFailed,
 
                                                 PaymentAuthorizationFailed,
Line 24: Line 24:
 
                                                 GiftCertificateValidated, OrderNoteAddedByCustomer
 
                                                 GiftCertificateValidated, OrderNoteAddedByCustomer
  
customer   CommerceBuilder.Users.User           OrderStatusUpdated, PaymentAuthorized,
+
customer       CommerceBuilder.Users.User       OrderStatusUpdated, PaymentAuthorized,
 
                                                 PaymentCaptured, CustomerPasswordRequest,   
 
                                                 PaymentCaptured, CustomerPasswordRequest,   
 
                                                 PaymentCapturedPartial, PaymentAuthorizationFailed,
 
                                                 PaymentCapturedPartial, PaymentAuthorizationFailed,
Line 32: Line 32:
 
                                                 OrderShippedPartial, GiftCertificateValidated,
 
                                                 OrderShippedPartial, GiftCertificateValidated,
 
                                                 OrderNoteAddedByCustomer
 
                                                 OrderNoteAddedByCustomer
 +
 +
oldstatusname  System.String                    OrderStatusUpdated
 +
 +
products      CommerceBuilder.Products.Product LowInventoryItemPurchased
 +
 +
  
 
</pre>
 
</pre>
 
</code>
 
</code>

Revision as of 04:22, 2 September 2008

Merchants can fully customize the customer notification email. It can include plain text, static HTML, and even dynamic information with the help of the full fledged template engine.

NVelocity is used as the template engine to process the email templates. Templates are written in velocity template language (VTL), which is extremely simple and powerful.

In a velocity template, certain objects put in the velocity context, can be accessed directly in a straight forward manner. For example if a ‘Store’ object, named “store” is available in the context, then using $store.Name we will get the name of the store. Similarly any method available in the ‘Store’ object can be called directly.

While writing templates for email messages in AbleCommerce, certain objects are automatically made available to the context, depending on the type of event.

The following table illustrates the objects and their availability for different events.

Object         Type              	        Available To
----------------------------------------------------------------------------------------------------

store          CommerceBuilder.Stores.Store     All Events

order          CommerceBuilder.Orders.Order     OrderStatusUpdated, PaymentAuthorized,
                                                PaymentCaptured, PaymentCapturedPartial,
                                                PaymentAuthorizationFailed,
                                                PaymentCaptureFailed, OrderPlaced, OrderCancelled,
                                                OrderPaidPartial, OrderPaid, OrderPaidNoShipments,
                                                OrderPaidCreditBalance, ShipmentShipped, 
                                                OrderShipped, OrderShippedPartial,  
                                                GiftCertificateValidated, OrderNoteAddedByCustomer

customer       CommerceBuilder.Users.User       OrderStatusUpdated, PaymentAuthorized,
                                                PaymentCaptured, CustomerPasswordRequest,  
                                                PaymentCapturedPartial, PaymentAuthorizationFailed,
                                                PaymentCaptureFailed, OrderPlaced, OrderCancelled,
                                                OrderPaidPartial, OrderPaid, OrderPaidNoShipments,
                                                OrderPaidCreditBalance, ShipmentShipped,OrderShipped,
                                                OrderShippedPartial, GiftCertificateValidated,
                                                OrderNoteAddedByCustomer

oldstatusname  System.String                    OrderStatusUpdated

products       CommerceBuilder.Products.Product LowInventoryItemPurchased