Home > General
Help > The Control Panel > Email
messages and formatting
Email messages and formatting
Visual editing of email messages
was introduced in Version 5.6.0, making it simpler to format the
headers, footers and contents of the various emails generated
by the store. This means they no longer need to be added to the
vsadmin/includes
file and that it is possible to take advantage of the FCK HTML
Editor for quick and easy formatting.
Accessing the Email message admin
On the admin home page of the control panel there
is link entitled Email Message Admin. Clicking on the link will
bring you to the page to select the email you would like to edit.

You will see a message here telling you if you have set
HTML Emails to on or off If you want to switch them on and send
HTML emails rather than plain text mails then you will need the
following addition
to vsadmin/includes.asp
htmlemails=TRUE
or vsadmin/includes.php
$htmlemails=TRUE;
If you are going to send HTML enriched emails then you may
want to use the FCK HTML Editor which gives you a wysiwyg
interface. If you don't already have it installed then it is
available for download on our free
downloads page
Editing
the order status email
The order status email can be sent out to customers when
you change the status of their order through the admin orders
page. You may want to inform customers for example that the
status has changed from "Order Received" to "Packing" for
example. To always send out an order status email you will
need the following addition
to vsadmin/includes.asp
alwaysemailstatus=true
or vsadmin/includes.php
$alwaysemailstatus=true;
When you select Order Status Email from the drop down
above you should see the following screen 
The screen explained
Subject: - This is the subject line of
the order status email
Replacement fields: - These are the variables
that can be used and will be replaced by the following:-
%orderid% - The order number
%ordername%
- The name the customer used on the order
%orderdate% - The date the original order was made
%oldstatus% - The previous status of the order
%newstatus% - The new order status
%date% - The date the order status was updated
%statusinfo% - Any information added to the Status Info field of the
order.
%trackingnum% - The tracking number added to the Tracking field on the order.
%reviewlinks% - The link to the product review feature
Note: Those in {curly brackets} are
conditional. Anything inside those curly brackets will not
appear if the value itself
is not set. For example if the order has no tracking number then
it will be ignored.
Message: - This is the body of the email
sent when the order status is changed.
Email headers and footers
This is where you can add a header and footer to the email
that is sent out to a customer following a successful purchase.
The header and footer will be included on all confirmation emails
so if you want to a different combination depending on the payment
method chosen then you would need to edit them separately through
the payment provider admin pages.
When you select Email headers and footers you should see
a screen like this

The screen explained
Replacement Fields:
%ordername% - This
is the name the customer used on purchase and can be included
in the email subject
%orderdate% - The date the order took place.
Subject: - This is the subject line of
the email confirmation
Replacement Fields: %emailmessage% -
This is the main body of the email which contains the summary
of the buyers details, items ordered, shipping, tax and grand
total etc.
Message: - Anything you add here before
%emailmessage% will be used for the header of the confirmation
mail. Anything added after %emailmessage% will be used as the
footer of the
confirmation email. You shouldn't remove the instance of %emailmessage%.
You can add HTML to format the header and footer.
Dropshipper header and footer
If you are using the dropshipper
feature then you may
want to include a header and / or footer in the email that the
dropshipper receives when an order is placed on your store for
one of their
marked items. It is also possible to have different headers
and footers depending on the payment method chosen, in this
case you would
want to make
the edits in the payment provider admin page.
When you select Dropshipper headers and footers you should
see a screen like this
The screen explained
Subject: - This is the subject line of
the email that the drop shipper receives
Replacement Fields:
%emailmessage% - This
is the main body of the email which contains the summary of the
order details received by the drop shipper.
%orderdate% - The date the order took place.
Message: - Anything you add here before
%emailmessage% will be used for the header of the dropshipper
mail. Anything added after %emailmessage% will be used as the
footer of the dropshipper email. You shouldn't remove the instance
of %emailmessage%. You
can add HTML to format the header and footer.
Gift certificate email
If you are using the Gift
Certificate feature you can format
the email sent to the recipient of the gift certificate.
When you select Gift certificate email you should
see a screen like this
The screen explained
Replacement fields: %fromname% - This
is the name of the person who originally purchased the gift certificate
and can be added to
the subject line of the email.
Subject: - The subject line of the email received by person
the gift certificate was purchased for.
Replacement fields: - These are the variables
that can be used in the email and will be replaced by the following:-
%toname% - The name of the person who will receive
the gift certificate email
%fromname% - The name of the person who originally purchased the gift
certificate
%value% - The monetary value of the gift certificate purchased
%certificateid% - The unique code that needs to be entered on checkout to
redeem the certificate
%storeurl% - The URL of the store where the certificate can be redeemed
%message% - The message that the buyer entered on purchasing the gift certificate
Note: Those in {curly brackets}
are conditional. Anything inside those curly brackets will not
appear if the value itself is not set. For example if the email
has no message then it will be ignored.
Message: - This is the body of the email
sent to the recipient of the gift certificate. This can be formatted
with HTML.
Gift Certificate sender
This is the confirmation email that the purchaser of the
Gift Certificate will receive.
When you select Gift certificate sender you should see
a screen like this

The screen explained
Replacement fields: %toname% - This
is the name of the person who will receive the gift certificate
and can be added to the subject line of the email.
Subject: - The subject line of the email
received by the person who purchased the gift certificate.
Replacement fields: %toname% - This is
the name of the person who will receive the gift certificate and
can be added to the body of the email.
Message: - This is the email that the
sender of the gift certificate will receive. You can edit the introduction
and this
will be followed by a copy of the text received by the recipient
of the gift certificate. You can add HTML to the message for formatting.
|