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

From X-Cart 4 Classic
Jump to: navigation, search
(Site administrator notifications)
(Orders department notifications)
Line 129: Line 129:
  
 
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 140: Line 139:
 
:: 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>
Line 172: Line 172:
 
: 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>
Line 207: Line 207:
 
: 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/preauth_order_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>
Line 231: Line 231:
 
: 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 244: Line 244:
 
: 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>
Line 277: Line 277:
 
: mail/html/signature.tpl
 
: mail/html/signature.tpl
  
 
+
mail/lowlimit_warning_notification_subj.tpl
 
|}
 
|}
 
</div>
 
</div>

Revision as of 20:15, 5 July 2012

The 'General settings/Email Notifications options' 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.


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 PR0) accounts.
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.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:

  • Enable email notifications for orders department about placed orders (online payment methods): 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.
This option is formerly known as 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



  • '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



  • '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



Provider notifications

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 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



  • '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



  • 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


X-Cart 4.4or above
X-CartPro
  • '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


X-Cart 4.4or above
X-CartPro
  • '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


X-Cart 4.4or above
X-CartPro
  • '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


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


  • '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



  • '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



  • '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



  • '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



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



  • '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



  • '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



  • '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


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?

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

  1. Let's say, 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.