Difference between revisions of "X-Cart:Email Notifications Options"
m (→Orders department notifications) |
|||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | == 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.х:''<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 == | + | === 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: | ||
| Line 58: | Line 76: | ||
{{XC_4.2}} | {{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 | + | * <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> | <div> | ||
{| cellspacing="0" cellpadding="4" border="1" align="center" | {| cellspacing="0" cellpadding="4" border="1" align="center" | ||
| Line 93: | Line 111: | ||
</div> | </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> | + | * <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| | + | {{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 271: | Line 289: | ||
</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 362: | Line 380: | ||
</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): | ||
| Line 465: | Line 483: | ||
|} | |} | ||
</div> | </div> | ||
| − | {{XC_4.4 | + | {{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. | * <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. | ||
| Line 498: | Line 516: | ||
</div> | </div> | ||
| − | {{XC_4.4 | + | {{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. | * <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. | ||
| Line 531: | Line 549: | ||
</div> | </div> | ||
| − | {{XC_4.4 | + | {{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. | * <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. | ||
| Line 560: | Line 578: | ||
</div> | </div> | ||
| − | == Customer notifications == | + | === Customer notifications === |
Select all the customer notifications that you want to be sent: | Select all the customer notifications that you want to be sent: | ||
| Line 832: | Line 850: | ||
==FAQ== | ==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?''' | |
| − | 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. |
| − | # | + | # 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 844: | Line 862: | ||
[[Category:X-Cart user manual]] | [[Category:X-Cart user manual]] | ||
| − | |||
[[Category:X-Cart user manual]] | [[Category:X-Cart user manual]] | ||
Latest revision as of 13:06, 27 September 2013
Contents
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/login_error_subj.tpl |
mail/html/login_error.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/wrong_bf_key_subj.tpl |
mail/html/wrong_bf_key.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/init_order_notification_subj.tpl |
mail/html/order_notification_admin.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/order_notification_subj.tpl |
mail/html/order_notification_admin.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/preauth_order_notification_subj.tpl |
mail/html/preauth_order_notification.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/order_notification_subj.tpl |
mail/html/order_notification 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/lowlimit_warning_notification_subj.tpl |
mail/html/lowlimit_warning_notification_admin.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/signin_admin_notif_subj.tpl |
mail/html/signin_admin_notification.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/profile_admin_modified_subj.tpl |
mail/html/profile_admin_modified.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/profile_admin_deleted_subj.tpl |
mail/html/profile_admin_deleted.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/order_notification_subj.tpl |
mail/html/order_notification.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/order_notification_subj.tpl |
mail/html/order_notification 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/lowlimit_warning_notification_subj.tpl |
mail/html/lowlimit_warning_notification_admin.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/signin_notification_subj.tpl |
mail/html/signin_provider_notif.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/provider_approved_subj.tpl |
mail/html/provider_approved.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/provider_declined_subj.tpl |
mail/html/provider_declined.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/init_order_customer_subj.tpl |
mail/html/init_order_customer.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/order_cust_processed_subj.tpl |
mail/html/order_customer_processed.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/order_cust_complete_subj.tpl |
mail/html/order_customer_complete.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/decline_notification_subj.tpl |
mail/html/decline_notification.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/order_customer_subj.tpl |
mail/html/order_customer.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/preauth_order_customer_subj.tpl |
mail/html/preauth_order_customer.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/signin_notification_subj.tpl |
mail/html/signin_notification.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/profile_modified_subj.tpl |
mail/html/profile_modified.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/profile_deleted_subj.tpl |
mail/html/profile_deleted.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.
- 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 "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.
- The low limit notification email is sent to the store administrator.
- 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.
