Difference between revisions of "X-Cart:Email Notifications Options"

From X-Cart 4 Classic
Jump to: navigation, search
(→‎Provider notifications)
m (→‎Orders department notifications)
 
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
The '<u>General settings/Email Notifications options</u>' page allows you to define, which of the available email notifications should be sent to the customers, administrator(s), provider(s), users department and orders department of your store.
+
== Email Notifications ==
  
 +
You can choose to automatically notify your store's users about different types of events by enabling the respective types of email notifications.
  
−
== Site administrator notifications ==
+
Any email notifications sent by your store can be changed/customized using X-Cart templates. These templates can be found under the following directories of your X-Cart installation:
 +
 
 +
''X-Cart 4.4.х-4.5.х:''<br />
 +
<u><xcart_dir>/skin/common_files/mail</u> - plain text email templates<br />
 +
<u><xcart_dir>/skin/common_files/mail/html</u> - html formatted email templates<br />
 +
 
 +
''X-Cart 4.3.2 and earlier versions:''<br />
 +
<u><xcart_dir>/skin1/mail</u> - plain text email templates<br />
 +
<u><xcart_dir>/skin1/mail/html</u> - html formatted email templates<br />
 +
 
 +
Note that some skins also have their own email templates located in the <u><xcart_dir>/skin/<skin_dir></u> folder, for example <u><xcart_dir>/skin/ideal_comfort/mail/html/order_invoice.tpl</u>
 +
 
 +
See also:
 +
* [[X-Cart:Editing_Skin_Files | Editing Skin Files]]
 +
 
 +
== Adjusting Email Notifications options ==
 +
 
 +
The '<u>General settings/Email Notifications options</u>' page allows you to define which types of email notifications should be sent to the users of your store.
 +
 
 +
=== Site administrator notifications ===
  
 
Select all the notifications that you wish to be sent to the store administrator:
 
Select all the notifications that you wish to be sent to the store administrator:
  
−
* <u>Notify the site administrator by email if unallowed request to site occurs</u>: If selected, the store administrator gets an email notification if the system detects a potentially harmful GET or POST request to the store site (which may be a sign of a hacker attack).
+
* <u>Notify the site administrator by email if unallowed request to site occurs</u>: If selected, the store administrator receives an email notification if the system detects a potentially harmful GET or POST request to the store site (which may be a sign of a hacker attack).
  
 
<div>
 
<div>
Line 19: Line 39:
  
  
−
* Notify the site administrator about SQL errors in the store by email: If selected, the store administrator gets notifications about any SQL errors that occur in the store.
+
* <u>Notify the site administrator about SQL errors in the store by email</u>: If selected, the store administrator receives notifications about any SQL errors that occur in the store.
  
 
<div>
 
<div>
Line 32: Line 52:
  
  
−
* <u>Login error notification to site administrator</u>: If selected, the store administrator gets an email notification if somebody tries to log in to the store as administrator with a password that does not match the actual administrator password.
+
* <u>Login error notification to site administrator</u>: If selected, the store administrator receives email notifications about failed login attempts to his administrator account.
  
 
<div>
 
<div>
Line 49: Line 69:
 
: mail/html/mail_header.tpl
 
: mail/html/mail_header.tpl
  
−
mail/html/signature.tpl
+
: mail/html/signature.tpl
 +
 
 +
mail/login_error_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
 +
{{XC_4.2}}
 +
* <u>All login error notifications to site administrator</u>: If selected, the store administrator receives email notifications about failed login attempts to customer, partner (Affiliate module) and provider (X-Cart PLATINUM or PRO) accounts.<br /><br />
 +
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center"
 +
! Plain text mail templates for this notification
 +
! HTML mail templates for this notification
 +
|-
 +
| Same as for "Login error notification to site administrator"
 +
| Same as for "Login error notification to site administrator"
 +
|}
 +
</div>
 +
 +
{{XC_4.3}}
 +
* <u>Notify the site administrator if the blowfish key is wrong</u>:  If selected, the store administrator receives an email notification if the  value of the $blowfish_key variable in config.php is changed. Important: You should remember that the Blowfish key must never be changed by editing config.php. The notification enabled by the option '<u>Notify the site administrator if the blowfish key is wrong</u>' was implemented in X-Cart to help you track down the change if it happens by accident. It is recommended that you keep this notification enabled. If you receive a notification saying the blowfish key is wrong, you should open config.php for editing and replace the wrong blowfish key value with the correct one.
 +
 +
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center" valign="top"
 +
! Plain text mail templates for this notification
 +
! HTML mail templates for this notification
 +
|-
 +
| mail/wrong_bf_key.tpl
 +
 +
: mail/mail_header.tpl
 +
 +
: mail/signature.tpl
 +
 +
mail/wrong_bf_key_subj.tpl
 +
| mail/html/wrong_bf_key.tpl
 +
: mail/html/mail_header.tpl
 +
 +
: mail/html/signature.tpl
 +
 +
mail/wrong_bf_key_subj.tpl
 +
|}
 +
</div>
  
−
== Orders department notifications ==
+
=== Orders department notifications ===
  
 
Select all the notifications which you want to be sent to the orders department of your store:
 
Select all the notifications which you want to be sent to the orders department of your store:
  
−
* <u>Enable email notifications for orders department about placed orders (online payment methods)</u>: If selected, a notification is sent to the store orders department when an order gets initially placed using an online payment method. The order gets the status 'I' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|Not finished]]) - the transaction is neither failed nor successful yet.
+
* <u>'Order is placed' notification to orders department</u>: If selected, a notification is sent to the store orders department when an order gets initially placed using an online payment method. The order gets the status 'I' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|Not finished]]), which means the transaction is neither failed nor successful yet.
  
−
{{Note1|This option is formerly known as ''Enable email notifications for orders department/providers about initially placed orders''.}}
+
{{Note1|Before X-Cart 4.6.1, this option was named, depending on the version, '''Enable email notifications for orders department about placed orders (online payment methods)''' or '''Enable email notifications for orders department/providers about initially placed orders'''.}}
  
 
<div>
 
<div>
Line 80: Line 137:
  
 
mail/init_order_notification_subj.tpl
 
mail/init_order_notification_subj.tpl
−
 
 
| mail/html/order_notification_admin.tpl
 
| mail/html/order_notification_admin.tpl
  
Line 91: Line 147:
 
:: mail/html/order_data.tpl
 
:: mail/html/order_data.tpl
  
−
mail/html/signature.tpl
+
: mail/html/signature.tpl
  
 +
mail/init_order_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
  
−
* <u>Enable email notifications for orders department about placed orders (offline payment methods)</u>: If selected, an email notification is sent to the store orders department when an order gets initially placed using an offline payment method. The order gets the status 'Q' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_offline_payment_methods|Queued]]) and is supposed to be processed manually by the store admin afterwards.
+
* <u>'Order is queued/pre-authorized' notification to orders department</u>: If selected, an email notification is sent to the store orders department when an order gets initially placed using an offline payment method and gets the status 'Q' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_offline_payment_methods|Queued]]), or when an order being placed using an online payment method gets the status 'A' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|Pre-authorized]]).
  
 
{{Note1|This option is formerly known as ''Enable email notifications to the orders department about placed orders''.}}
 
{{Note1|This option is formerly known as ''Enable email notifications to the orders department about placed orders''.}}
Line 103: Line 160:
 
<div>
 
<div>
 
{| cellspacing="0" cellpadding="4" border="1" align="center"
 
{| cellspacing="0" cellpadding="4" border="1" align="center"
−
! Plain text mail templates for this notification
+
! Plain text mail templates for 'Order is queued' notification
−
! HTML mail templates for this notification
+
! HTML mail templates for 'Order is queued' notification
 
|-
 
|-
 
| mail/order_notification_admin.tpl
 
| mail/order_notification_admin.tpl
Line 123: Line 180:
 
: mail/html/mail_header.tpl
 
: mail/html/mail_header.tpl
  
−
:: mail/html/order_invoice.tpl
+
: mail/html/order_invoice.tpl
 +
 
 +
:: main/order_status.tpl
 +
 
 +
:: mail/html/order_data.tpl
 +
 
 +
: mail/html/signature.tpl
 +
 
 +
mail/order_notification_subj.tpl
 +
|}
 +
</div>
 +
 
 +
 
 +
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center"
 +
! Plain text mail templates for 'Order is pre-authorized' notification
 +
! HTML mail templates for 'Order is pre-authorized' notification
 +
|-
 +
| mail/preauth_order_notification.tpl
 +
 
 +
: mail/mail_header.tpl
 +
 
 +
: mail/order_invoice.tpl
  
 
:: main/order_status.tpl
 
:: main/order_status.tpl
  
−
: mail/html/order_data.tpl
+
:: mail/order_data.tpl
 +
 
 +
: mail/signature.tpl
 +
 
 +
mail/preauth_order_notification_subj.tpl
 +
| mail/html/preauth_order_notification.tpl
 +
 
 +
: mail/html/mail_header.tpl
 +
 
 +
: mail/html/order_invoice.tpl
 +
 
 +
:: main/order_status.tpl
  
−
mail/html/signature.tpl
+
:: mail/html/order_data.tpl
  
 +
:mail/html/signature.tpl
  
 +
mail/preauth_order_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
  
−
* <u>'Order is processed' notification to orders department</u>: If selected, a notification is sent to the orders department of your store when an order gets processed.
+
* <u>'Order is processed' notification to orders department</u>: If selected, a notification is sent to the orders department of your store when an order gets the status 'P' ([[X-Cart:Orders#Order_Statuses|Processed]]).
  
 
<div>
 
<div>
Line 147: Line 239:
 
: mail/mail_header.tpl
 
: mail/mail_header.tpl
  
−
:: mail/order_invoice.tpl
+
: mail/order_invoice.tpl
  
 
:: main/order_status.tpl
 
:: main/order_status.tpl
  
−
: mail/order_data.tpl
+
:: mail/order_data.tpl
  
 
: mail/signature.tpl
 
: mail/signature.tpl
Line 160: Line 252:
 
: mail/html/mail_header.tpl
 
: mail/html/mail_header.tpl
  
−
:: mail/html/order_invoice.tpl
+
: mail/html/order_invoice.tpl
  
 
:: main/order_status.tpl
 
:: main/order_status.tpl
  
−
: mail/html/order_data.tpl
+
:: mail/html/order_data.tpl
−
 
 
−
mail/html/signature.tpl
 
  
 +
:mail/html/signature.tpl
  
 +
mail/order_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
  
−
* <u>Low limit warning to orders department</u>: If selected, a low limit warning message is sent to the orders department when the quantity in stock of any of the products reaches the 'low limit'.
+
* <u>Enable low limit warning to orders department</u>: If selected, a low limit warning message is sent to the orders department when the quantity in stock of any of the products reaches the 'low limit'.
  
 
<div>
 
<div>
Line 193: Line 285:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/lowlimit_warning_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
−
== Users department notifications ==
+
=== Users department notifications ===
  
 
Select all the notifications which you want to be sent to the users department of your store:
 
Select all the notifications which you want to be sent to the users department of your store:
Line 226: Line 318:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/signin_admin_notif_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 255: Line 347:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/profile_admin_modified_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 284: Line 376:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/profile_admin_deleted_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
−
 
+
=== Provider notifications ===
−
== Provider notifications ==
+
{{XC Platinum}}{{XC Pro}}<br />
−
 
 
 
Select all the notifications which you want to be sent to the store provider(s):
 
Select all the notifications which you want to be sent to the store provider(s):
  
−
* <u>Send email notifications about placed orders to providers who uploaded the purchased products (in addition to the orders department)</u>: If selected, when an order gets placed, notifications are sent not only to the orders department, but also to individual providers who own the products included into the order.
+
* <u>Send email notifications about placed orders to providers who uploaded the purchased products (in addition to the orders department)</u>: If selected, when an order gets initially placed, notifications are sent not only to the orders department, but also to individual providers who own the products included into the order.
  
−
{{Note1| Note: This option takes effect only if options <u>Enable email notifications for orders department about placed orders (online payment methods)</u> and/or <u>Enable email notifications for orders department about placed orders (offline payment methods)</u> are enabled.}}
+
{{Note1| Note: This option takes effect only if the options <u>Enable email notifications for orders department about placed orders (online payment methods)</u> and/or <u>Enable email notifications for orders department about placed orders (offline payment methods)</u> are enabled.}}
  
 
<div>
 
<div>
Line 327: Line 418:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/order_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 364: Line 455:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/order_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 389: Line 480:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/lowlimit_warning_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
 +
{{XC_4.4}}
 +
* <u>'Provider profile is created' notification to profile owner</u>:  If selected, any user for whom a provider profile is created receives the 'Provider profile is created' notification.
  
−
== Customer notifications ==
+
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center"
 +
! Plain text mail templates for this notification
 +
! HTML mail templates for this notification
 +
|-
 +
| mail/signin_provider_notif.tpl
  
−
Select all the customer notifications which you want to be sent:
+
: mail/mail_header.tpl
  
−
* <u>'Order is queued/pre-authorized'</u> notification to customer: If selected, a customer gets a notification when his or her order gets queued (the status 'Q') or pre-authorized. The look and content of such email notifications is defined by these templates:
+
: mail/salutation.tpl
 +
 
 +
: mail/profile_data.tpl
 +
 
 +
: mail/signature.tpl
 +
 
 +
mail/signin_notification_subj.tpl
 +
| mail/html/signin_provider_notif.tpl
 +
 
 +
: mail/html/mail_header.tpl
 +
 
 +
: mail/salutation.tpl
 +
 
 +
: mail/html/profile_data.tpl
 +
 
 +
: mail/html/signature.tpl
 +
 
 +
mail/signin_notification_subj.tpl
 +
|}
 +
</div>
 +
 
 +
{{XC_4.4}}
 +
* <u>'Provider account is approved' notification to provider</u>: If selected, any user whose provider profile is approved receives the 'Provider profile is approved' notification.
  
 
<div>
 
<div>
Line 404: Line 524:
 
! HTML mail templates for this notification
 
! HTML mail templates for this notification
 
|-
 
|-
−
| mail/order_customer.tpl
+
| mail/provider_approved.tpl
  
 
: mail/mail_header.tpl
 
: mail/mail_header.tpl
  
−
: mail/order_invoice.tpl
+
: mail/salutation.tpl
  
−
:: main/order_status.tpl
+
: mail/profile_data.tpl
−
 
 
−
:: mail/order_data.tpl
 
  
 
: mail/signature.tpl
 
: mail/signature.tpl
  
−
mail/order_customer_subj.tpl
+
mail/provider_approved_subj.tpl
−
| mail/html/order_customer.tpl
+
| mail/html/provider_approved.tpl
  
 
: mail/html/mail_header.tpl
 
: mail/html/mail_header.tpl
  
−
: mail/html/order_invoice.tpl
+
: mail/salutation.tpl
 +
 
 +
: mail/html/profile_data.tpl
 +
 
 +
: mail/html/signature.tpl
 +
 
 +
mail/provider_approved_subj.tpl
 +
|}
 +
</div>
 +
 
 +
{{XC_4.4}}
 +
* <u>'Provider account is declined' notification to provider</u>:  If selected, any user whose provider profile is declined receives the 'Provider profile is declined' notification.
 +
 
 +
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center"
 +
! Plain text mail templates for this notification
 +
! HTML mail templates for this notification
 +
|-
 +
| mail/provider_declined.tpl
 +
 
 +
: mail/mail_header.tpl
 +
 
 +
: mail/salutation.tpl
 +
 
 +
: mail/signature.tpl
 +
 
 +
mail/provider_declined_subj.tpl
 +
| mail/html/provider_declined.tpl
  
−
:: main/order_status.tpl
+
: mail/html/mail_header.tpl
  
−
:: mail/html/order_data.tpl
+
: mail/salutation.tpl
  
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/provider_declined_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
 +
=== Customer notifications ===
  
−
* <u>Enable email notifications for customers about initially placed orders</u>: If selected, a customer gets a notification when his or her order becomes initially placed. An order is considered initially placed when a customer goes to an online payment processor to pay for an order using an online payment method and the order gets pre-placed with the status 'I' (Not finished), which means that the transaction is neither failed nor successful yet.
+
Select all the customer notifications that you want to be sent:
 +
 
 +
* <u>Enable email notifications for customers about placed orders (online payment methods)</u>: If selected, a customer gets a notification when his or her order gets initially placed using an online payment method. The order gets the status 'I' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|Not finished]]), which means that the transaction is neither failed nor successful yet.
 +
 
 +
{{Note1|This option is formerly known as ''Enable email notifications for customers about initially placed orders''.}}
  
 
<div>
 
<div>
Line 454: Line 604:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/init_order_customer_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
−
 
+
* <u>'Order is processed' notification to customer</u>: If selected, a customer gets a notification when his or her order gets processed (the status 'P' or [[X-Cart:Orders#Order_Statuses|Processed]]).
−
* <u>'Order is processed' notification to customer</u>: If selected, a customer gets a notification when his or her order gets processed (the status 'P').
 
  
 
<div>
 
<div>
Line 483: Line 632:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/order_cust_processed_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
  
−
* <u>'Order is completed' notification to customer</u>: If selected, a customer gets a notification when his or her order gets completed (the status 'C').
+
* <u>'Order is completed' notification to customer</u>: If selected, a customer gets a notification when his or her order gets completed (the status 'C' or [[X-Cart:Orders#Order_Statuses|Complete]]).
  
 
<div>
 
<div>
Line 512: Line 661:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/order_cust_complete_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
  
  
−
* <u>'Order is declined' notification to customer</u>: If selected, a customer gets a notification when his or her order gets declined (the status 'D').
+
* <u>'Order is declined' notification to customer</u>: If selected, a customer gets a notification when his or her order gets declined (the status 'D' or [[X-Cart:Orders#Order_Statuses|Declined]]).
  
 
<div>
 
<div>
Line 541: Line 690:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
 +
mail/decline_notification_subj.tpl
 +
|}
 +
</div>
 +
 +
 +
* <u>'Order is queued/pre-authorized'</u> notification to customer: If selected, a customer gets a notification when his or her order gets initially placed using an offline payment method and gets the status 'Q' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_offline_payment_methods|Queued]]), or when his or her order being placed using an online payment method gets the status 'A' ([[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|Pre-authorized]]).
  
 +
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center"
 +
! Plain text mail templates for 'Order is queued' notification
 +
! HTML mail templates for 'Order is queued' notification
 +
|-
 +
| mail/order_customer.tpl
 +
 +
: mail/mail_header.tpl
 +
 +
: mail/order_invoice.tpl
 +
 +
:: main/order_status.tpl
 +
 +
:: mail/order_data.tpl
 +
 +
: mail/signature.tpl
 +
 +
mail/order_customer_subj.tpl
 +
| mail/html/order_customer.tpl
 +
 +
: mail/html/mail_header.tpl
 +
 +
: mail/html/order_invoice.tpl
 +
 +
:: main/order_status.tpl
 +
 +
:: mail/html/order_data.tpl
 +
 +
: mail/html/signature.tpl
 +
 +
mail/order_customer_subj.tpl
 +
|}
 +
</div>
 +
 +
 +
<div>
 +
{| cellspacing="0" cellpadding="4" border="1" align="center"
 +
! Plain text mail templates for 'Order is pre-authorized' notification
 +
! HTML mail templates for 'Order is pre-authorized' notification
 +
|-
 +
| mail/preauth_order_customer.tpl
 +
 +
: mail/mail_header.tpl
 +
 +
: mail/order_invoice.tpl
 +
 +
:: main/order_status.tpl
 +
 +
:: mail/order_data.tpl
 +
 +
: mail/signature.tpl
 +
 +
mail/preauth_order_customer_subj.tpl
 +
| mail/html/preauth_order_customer.tpl
 +
 +
: mail/html/mail_header.tpl
 +
 +
: mail/html/order_invoice.tpl
 +
 +
:: main/order_status.tpl
 +
 +
:: mail/html/order_data.tpl
 +
 +
: mail/html/signature.tpl
 +
 +
mail/preauth_order_customer_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 570: Line 791:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/signin_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 599: Line 820:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/profile_modified_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 624: Line 845:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
−
 
+
mail/profile_deleted_subj.tpl
 
|}
 
|}
  
 
==FAQ==
 
==FAQ==
  
−
=== When an order fails (is declined by payment gateway), the inventory stays not decreased, but the administrator receives the low limit notification email entitled "Product #1 quantity decreased!" Don't understand, why? ===
+
'''Q: When an order fails (is declined by payment gateway), the inventory stays not decreased, but the administrator receives the low limit notification email entitled "Product #1 quantity decreased!" Don't understand, why?'''
  
−
Let's say, you have 3 items in stock and the low limit is 2.
+
'''A:''' Let's say, you have 3 items in stock, and the low limit is 2.
  
−
# Let's say, a customer adds 1 item to cart, then goes to checkout.
+
# A customer adds 1 item to cart, then goes to checkout.
 
# When the customer clicks on '''Submit''' button at the last checkout page, a new order is created with status [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods | "Not finished"]], and the product's quantity in stock is decreased by 1. {{Note1 | The product quantity in stock is decreased in order to prevent the situation when 2 customers simultaneously purchase the last item of the same product in the store.}}
 
# When the customer clicks on '''Submit''' button at the last checkout page, a new order is created with status [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods | "Not finished"]], and the product's quantity in stock is decreased by 1. {{Note1 | The product quantity in stock is decreased in order to prevent the situation when 2 customers simultaneously purchase the last item of the same product in the store.}}
 
# The low limit notification email is sent to the store administrator.
 
# The low limit notification email is sent to the store administrator.
Line 640: Line 861:
 
For more information about order statuses please refer to: [[X-Cart:Orders#Statuses of orders paid for by online payment methods | Statuses of orders paid for by online payment methods]].
 
For more information about order statuses please refer to: [[X-Cart:Orders#Statuses of orders paid for by online payment methods | Statuses of orders paid for by online payment methods]].
  
 +
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Latest revision as of 13:06, 27 September 2013

Email Notifications

You can choose to automatically notify your store's users about different types of events by enabling the respective types of email notifications.

Any email notifications sent by your store can be changed/customized using X-Cart templates. These templates can be found under the following directories of your X-Cart installation:

X-Cart 4.4.х-4.5.х:
<xcart_dir>/skin/common_files/mail - plain text email templates
<xcart_dir>/skin/common_files/mail/html - html formatted email templates

X-Cart 4.3.2 and earlier versions:
<xcart_dir>/skin1/mail - plain text email templates
<xcart_dir>/skin1/mail/html - html formatted email templates

Note that some skins also have their own email templates located in the <xcart_dir>/skin/<skin_dir> folder, for example <xcart_dir>/skin/ideal_comfort/mail/html/order_invoice.tpl

See also:

Adjusting Email Notifications options

The 'General settings/Email Notifications options' page allows you to define which types of email notifications should be sent to the users of your store.

Site administrator notifications

Select all the notifications that you wish to be sent to the store administrator:

  • Notify the site administrator by email if unallowed request to site occurs: If selected, the store administrator receives an email notification if the system detects a potentially harmful GET or POST request to the store site (which may be a sign of a hacker attack).
Plain text mail templates for this notification HTML mail templates for this notification
-- --


  • Notify the site administrator about SQL errors in the store by email: If selected, the store administrator receives notifications about any SQL errors that occur in the store.
Plain text mail templates for this notification HTML mail templates for this notification
-- --


  • Login error notification to site administrator: If selected, the store administrator receives email notifications about failed login attempts to his administrator account.
Plain text mail templates for this notification HTML mail templates for this notification
mail/login_error.tpl
mail/mail_header.tpl
mail/signature.tpl

mail/login_error_subj.tpl

mail/html/login_error.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

mail/login_error_subj.tpl

X-Cart 4.2or above
  • All login error notifications to site administrator: If selected, the store administrator receives email notifications about failed login attempts to customer, partner (Affiliate module) and provider (X-Cart PLATINUM or PRO) accounts.

Plain text mail templates for this notification HTML mail templates for this notification
Same as for "Login error notification to site administrator" Same as for "Login error notification to site administrator"
X-Cart 4.3or above
  • Notify the site administrator if the blowfish key is wrong: If selected, the store administrator receives an email notification if the value of the $blowfish_key variable in config.php is changed. Important: You should remember that the Blowfish key must never be changed by editing config.php. The notification enabled by the option 'Notify the site administrator if the blowfish key is wrong' was implemented in X-Cart to help you track down the change if it happens by accident. It is recommended that you keep this notification enabled. If you receive a notification saying the blowfish key is wrong, you should open config.php for editing and replace the wrong blowfish key value with the correct one.
Plain text mail templates for this notification HTML mail templates for this notification
mail/wrong_bf_key.tpl
mail/mail_header.tpl
mail/signature.tpl

mail/wrong_bf_key_subj.tpl

mail/html/wrong_bf_key.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

mail/wrong_bf_key_subj.tpl

Orders department notifications

Select all the notifications which you want to be sent to the orders department of your store:

  • 'Order is placed' notification to orders department: If selected, a notification is sent to the store orders department when an order gets initially placed using an online payment method. The order gets the status 'I' (Not finished), which means the transaction is neither failed nor successful yet.
Before X-Cart 4.6.1, this option was named, depending on the version, Enable email notifications for orders department about placed orders (online payment methods) or Enable email notifications for orders department/providers about initially placed orders.
Plain text mail templates for this notification HTML mail templates for this notification
mail/order_notification_admin.tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/init_order_notification_subj.tpl

mail/html/order_notification_admin.tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/init_order_notification_subj.tpl


  • 'Order is queued/pre-authorized' notification to orders department: If selected, an email notification is sent to the store orders department when an order gets initially placed using an offline payment method and gets the status 'Q' (Queued), or when an order being placed using an online payment method gets the status 'A' (Pre-authorized).
This option is formerly known as Enable email notifications to the orders department about placed orders.
Plain text mail templates for 'Order is queued' notification HTML mail templates for 'Order is queued' notification
mail/order_notification_admin.tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_notification_subj.tpl

mail/html/order_notification_admin.tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_notification_subj.tpl


Plain text mail templates for 'Order is pre-authorized' notification HTML mail templates for 'Order is pre-authorized' notification
mail/preauth_order_notification.tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/preauth_order_notification_subj.tpl

mail/html/preauth_order_notification.tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/preauth_order_notification_subj.tpl


  • 'Order is processed' notification to orders department: If selected, a notification is sent to the orders department of your store when an order gets the status 'P' (Processed).
Plain text mail templates for this notification HTML mail templates for this notification
mail/order_notification tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_notification_subj.tpl

mail/html/order_notification tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_notification_subj.tpl


  • Enable low limit warning to orders department: If selected, a low limit warning message is sent to the orders department when the quantity in stock of any of the products reaches the 'low limit'.
Plain text mail templates for this notification HTML mail templates for this notification
mail/lowlimit_warning_notification_admin.tpl
mail/mail_header.tpl
mail/signature.tpl

mail/lowlimit_warning_notification_subj.tpl

mail/html/lowlimit_warning_notification_admin.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

mail/lowlimit_warning_notification_subj.tpl

Users department notifications

Select all the notifications which you want to be sent to the users department of your store:


  • 'Profile is created' notification to users department: If selected, a notification is sent to the users department when a new user profile gets created.
Plain text mail templates for this notification HTML mail templates for this notification
mail/signin_admin_notification.tpl
mail/mail_header.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/signin_admin_notif_subj.tpl

mail/html/signin_admin_notification.tpl
mail/html/mail_header.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/signin_admin_notif_subj.tpl


  • 'Profile is modified' notification to users department: If selected, a notification is sent to the users department when a user profile gets modified.
Plain text mail templates for this notification HTML mail templates for this notification
mail/profile_admin_modified.tpl
mail/mail_header.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/profile_admin_modified_subj.tpl

mail/html/profile_admin_modified.tpl
mail/html/mail_header.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/profile_admin_modified_subj.tpl


  • 'Profile is deleted' notification to users department: If selected, a notification is sent to the users department when a user profile gets deleted.
Plain text mail templates for this notification HTML mail templates for this notification
mail/profile_admin_deleted.tpl
mail/mail_header.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/profile_admin_deleted_subj.tpl

mail/html/profile_admin_deleted.tpl
mail/html/mail_header.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/profile_admin_deleted_subj.tpl

Provider notifications

X-CartPlatinum
X-CartPro


Select all the notifications which you want to be sent to the store provider(s):

  • Send email notifications about placed orders to providers who uploaded the purchased products (in addition to the orders department): If selected, when an order gets initially placed, notifications are sent not only to the orders department, but also to individual providers who own the products included into the order.
Note: This option takes effect only if the options Enable email notifications for orders department about placed orders (online payment methods) and/or Enable email notifications for orders department about placed orders (offline payment methods) are enabled.
Plain text mail templates for this notification HTML mail templates for this notification
mail/order_notification.tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_notification_subj.tpl

mail/html/order_notification.tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_notification_subj.tpl


  • 'Order is processed' notification to provider: If selected, a notification is sent to the provider when an order gets processed.
Plain text mail templates for this notification HTML mail templates for this notification
mail/order_notification tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_notification_subj.tpl

mail/html/order_notification tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_notification_subj.tpl


  • Low limit warning to provider: If selected, a notification is sent to the provider when the quantity in stock of any of his products reaches the 'low limit'.
Plain text mail templates for this notification HTML mail templates for this notification
mail/lowlimit_warning_notification_admin.tpl
mail/mail_header.tpl
mail/signature.tpl

mail/lowlimit_warning_notification_subj.tpl

mail/html/lowlimit_warning_notification_admin.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

mail/lowlimit_warning_notification_subj.tpl

X-Cart 4.4or above
  • 'Provider profile is created' notification to profile owner: If selected, any user for whom a provider profile is created receives the 'Provider profile is created' notification.
Plain text mail templates for this notification HTML mail templates for this notification
mail/signin_provider_notif.tpl
mail/mail_header.tpl
mail/salutation.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/signin_notification_subj.tpl

mail/html/signin_provider_notif.tpl
mail/html/mail_header.tpl
mail/salutation.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/signin_notification_subj.tpl

X-Cart 4.4or above
  • 'Provider account is approved' notification to provider: If selected, any user whose provider profile is approved receives the 'Provider profile is approved' notification.
Plain text mail templates for this notification HTML mail templates for this notification
mail/provider_approved.tpl
mail/mail_header.tpl
mail/salutation.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/provider_approved_subj.tpl

mail/html/provider_approved.tpl
mail/html/mail_header.tpl
mail/salutation.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/provider_approved_subj.tpl

X-Cart 4.4or above
  • 'Provider account is declined' notification to provider: If selected, any user whose provider profile is declined receives the 'Provider profile is declined' notification.
Plain text mail templates for this notification HTML mail templates for this notification
mail/provider_declined.tpl
mail/mail_header.tpl
mail/salutation.tpl
mail/signature.tpl

mail/provider_declined_subj.tpl

mail/html/provider_declined.tpl
mail/html/mail_header.tpl
mail/salutation.tpl
mail/html/signature.tpl

mail/provider_declined_subj.tpl

Customer notifications

Select all the customer notifications that you want to be sent:

  • Enable email notifications for customers about placed orders (online payment methods): If selected, a customer gets a notification when his or her order gets initially placed using an online payment method. The order gets the status 'I' (Not finished), which means that the transaction is neither failed nor successful yet.
This option is formerly known as Enable email notifications for customers about initially placed orders.
Plain text mail templates for this notification HTML mail templates for this notification
mail/init_order_customer.tpl
mail/mail_header.tpl
mail/signature.tpl

mail/init_order_customer_subj.tpl

mail/html/init_order_customer.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

mail/init_order_customer_subj.tpl

  • 'Order is processed' notification to customer: If selected, a customer gets a notification when his or her order gets processed (the status 'P' or Processed).
Plain text mail templates for this notification HTML mail templates for this notification
mail/order_customer_processed.tpl
mail/mail_header.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_cust_processed_subj.tpl

mail/html/order_customer_processed.tpl
mail/html/mail_header.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_cust_processed_subj.tpl


  • 'Order is completed' notification to customer: If selected, a customer gets a notification when his or her order gets completed (the status 'C' or Complete).
Plain text mail templates for this notification HTML mail templates for this notification
mail/order_customer_complete.tpl
mail/mail_header.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_cust_complete_subj.tpl

mail/html/order_customer_complete.tpl
mail/html/mail_header.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_cust_complete_subj.tpl


  • 'Order is declined' notification to customer: If selected, a customer gets a notification when his or her order gets declined (the status 'D' or Declined).
Plain text mail templates for this notification HTML mail templates for this notification
mail/decline_notification.tpl
mail/mail_header.tpl
mail/order_data.tpl
mail/signature.tpl

mail/decline_notification_subj.tpl

mail/html/decline_notification.tpl
mail/html/mail_header.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/decline_notification_subj.tpl


  • 'Order is queued/pre-authorized' notification to customer: If selected, a customer gets a notification when his or her order gets initially placed using an offline payment method and gets the status 'Q' (Queued), or when his or her order being placed using an online payment method gets the status 'A' (Pre-authorized).
Plain text mail templates for 'Order is queued' notification HTML mail templates for 'Order is queued' notification
mail/order_customer.tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/order_customer_subj.tpl

mail/html/order_customer.tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/order_customer_subj.tpl


Plain text mail templates for 'Order is pre-authorized' notification HTML mail templates for 'Order is pre-authorized' notification
mail/preauth_order_customer.tpl
mail/mail_header.tpl
mail/order_invoice.tpl
main/order_status.tpl
mail/order_data.tpl
mail/signature.tpl

mail/preauth_order_customer_subj.tpl

mail/html/preauth_order_customer.tpl
mail/html/mail_header.tpl
mail/html/order_invoice.tpl
main/order_status.tpl
mail/html/order_data.tpl
mail/html/signature.tpl

mail/preauth_order_customer_subj.tpl


  • 'Profile is created' notification to profile owner: If selected, an owner of a user profile gets a notification when his or her user profile gets created.
Plain text mail templates for this notification HTML mail templates for this notification
mail/signin_notification.tpl
mail/mail_header.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/signin_notification_subj.tpl

mail/html/signin_notification.tpl
mail/html/mail_header.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/signin_notification_subj.tpl


  • 'Profile is modified' notification to profile owner: If selected, an owner of a user profile gets a notification when his or her user profile gets modified.
Plain text mail templates for this notification HTML mail templates for this notification
mail/profile_modified.tpl
mail/mail_header.tpl
mail/profile_data.tpl
mail/signature.tpl

mail/profile_modified_subj.tpl

mail/html/profile_modified.tpl
mail/html/mail_header.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl

mail/profile_modified_subj.tpl


  • 'Profile is deleted' notification to profile owner: If selected, an owner of a user profile gets a notification when his or her user profile gets deleted.
Plain text mail templates for this notification HTML mail templates for this notification
mail/profile_deleted.tpl
mail/mail_header.tpl
mail/signature.tpl

mail/profile_deleted_subj.tpl

mail/html/profile_deleted.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

mail/profile_deleted_subj.tpl

FAQ

Q: When an order fails (is declined by payment gateway), the inventory stays not decreased, but the administrator receives the low limit notification email entitled "Product #1 quantity decreased!" Don't understand, why?

A: Let's say, you have 3 items in stock, and the low limit is 2.

  1. A customer adds 1 item to cart, then goes to checkout.
  2. When the customer clicks on Submit button at the last checkout page, a new order is created with status "Not finished", and the product's quantity in stock is decreased by 1.
    The product quantity in stock is decreased in order to prevent the situation when 2 customers simultaneously purchase the last item of the same product in the store.
  3. The low limit notification email is sent to the store administrator.
  4. If the order fails (for example, due to the customer's credit card being declined by the payment gateway), the order status is changed to "Failed", and the quantity is increased back to its original value.

For more information about order statuses please refer to: Statuses of orders paid for by online payment methods.

Retrieved from "https://help.x-cart.com/index.php?title=X-Cart:Email_Notifications_Options&oldid=11669"