Personal tools
Namespaces

Variants
Actions

Abandoned Cart For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(Tips)
(Upgrade Guide)
(40 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
=About [https://www.modulesgarden.com/products/whmcs/abandoned-cart Abandoned Cart For WHMCS]=
 
=About [https://www.modulesgarden.com/products/whmcs/abandoned-cart Abandoned Cart For WHMCS]=
 
{|
 
{|
|style="padding: 10px 0px 10px 0px;"|'''Abandoned Cart For WHMCS''' is a perfect tool that allows to successfully track what is happening in your marketplace.<br/>  
+
|style="padding: 10px 0px 10px 0px;"|'''Abandoned Cart For WHMCS''' is a perfect tool that allows you to learn about your clients' habits and prevent unfinished purchases.<br/>  
Check the content of the carts abandoned by any client and send them customized email messages to remind about incomplete shopping. <br/>
+
Check the content of shopping carts abandoned by your guests and send them customized email messages to remind about incomplete shopping. <br/>
Observe statistics on the customers' behavior to perfectly adjust your offer to the needs of your clients which will result in increased incomes.
+
Observe statistics on customers' behavior to perfectly adjust your offer to their needs which will quickly result in increased revenue and conversion rates.
 
|}
 
|}
 
<!-- fixed -->
 
<!-- fixed -->
Line 14: Line 14:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ View Carts Statistics With Ratios To Completed Orders And Existing Clients For:
+
|style="padding: 0px 0px 0px 30px;"|✔ Access And Manage Carts Statistics:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ 1 Month
+
|style="padding: 0px 0px 0px 45px;"|✔ View Number Of All Carts And Completed Orders
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ 3 Months
+
|style="padding: 0px 0px 0px 45px;"|✔ View Percentage Of Existing Clients Carts To All Carts
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ 6 Months
+
|style="padding: 0px 0px 0px 45px;"|✔ Display Statistics From Last:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ 12 Months
+
|style="padding: 0px 0px 0px 60px;"|✔ 1 Month
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ 3 Months
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ 6 Months
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ 12 Months
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 0px 30px;"|✔ View Shopping Carts Snapshots With Logs On:
 
|style="padding: 0px 0px 0px 30px;"|✔ View Shopping Carts Snapshots With Logs On:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Clients Names And Guest Emails
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Placed Orders And Payment Statuses
 
|}
 
|}
 
{|
 
{|
Line 35: Line 50:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ Placed Orders
+
|style="padding: 0px 0px 0px 30px;"|✔ Send Email Notifications To Clients From Shopping Carts List
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Access Saved Shopping Carts Via Token Cart URLs
 
|}
 
|}
 
{|
 
{|
Line 65: Line 83:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ Specify Timeframe When To Sent Reminders
+
|style="padding: 0px 0px 0px 45px;"|✔ Send Reminders For Carts Created Within Specified Timeframe
 
|}
 
|}
 
{|
 
{|
Line 71: Line 89:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ Require Guest Clients To Leave Their Email Addresses Upon Adding Item To Cart
+
|style="padding: 0px 0px 0px 45px;"|✔ Define Requirements For Guest Clients To Leave Email Address:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ Force Guest Clients To Log In Or Register Upon Adding Item To Cart
+
|style="padding: 0px 0px 0px 60px;"|✔ Disable Requirement
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ Select Support Department From Which To Send Reminders To Guest Clients
+
|style="padding: 0px 0px 0px 60px;"|✔ Force To Provide Email Address
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Allow To Skip Email Address Requirement
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Force Guest Clients To Log In Or Register
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Send Direct Cart URL In Reminders To Restore Abandoned Cart
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Select Support Department For Reminders Sent To Guest Clients
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Allow Clients To Save Shopping Carts
 
|}
 
|}
 
{|
 
{|
Line 85: Line 118:
 
*'''Client Area Features:'''
 
*'''Client Area Features:'''
 
{|
 
{|
|style="padding: 10px 0px 0px 30px;"|✔ Force Guest Clients To Either:
+
|style="padding: 10px 0px 0px 30px;"|✔ Save Shopping Cart Contents
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 45px;"|✔ Provide Their Email Address
+
|style="padding: 0px 0px 0px 30px;"|✔ Share And Restore Saved Shopping Carts Via Token Cart URLs
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 10px 45px;"|✔ Log In Or Register
+
|style="padding: 0px 0px 0px 30px;"|✔ Optional Requirements For Guest Clients Upon Moving To Store:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Provide Email Address
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Log In To Existing Account
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 45px;"|✔ Register New Account
 
|}
 
|}
  
 
*'''General Info:'''
 
*'''General Info:'''
 
{|
 
{|
|style="padding: 10px 0px 0px 30px;"|✔ Multi-Language Support
+
|style="padding: 10px 0px 0px 30px;"|✔ Limited Integration With [https://www.modulesgarden.com/products/whmcs/lagom-one-step-order-form Lagom One Step Order Form For WHMCS] [[#Lagom_One_Step_Order_Form_Integration|(Read More)]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 8.1 Back To PHP 7.4
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 7.4 Up To PHP 8.1
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Themes "Twenty-One" And "Lagom WHMCS Client Theme"
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS V8.4 And Later
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS V8.9 Back To WHMCS V8.6
 
|}
 
|}
 
{|
 
{|
Line 108: Line 156:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 30px;"|✔ Easy Module Upgrade To [https://www.modulesgarden.com/products/whmcs/abandoned-cart#open-source-version Open Source Version]
+
|style="padding: 0px 0px 30px 30px;"|✔ Easy [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module Module Upgrade] To [https://www.modulesgarden.com/products/whmcs/abandoned-cart#open-source-version Open Source Version]
 
|}
 
|}
  
Line 138: Line 186:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''3. When you install Product Feedback Center For WHMCS for the first time, you have to rename the '' 'license_RENAME.php' '' file.<br />
+
|style="padding: 0px 0px 15px 15px;"|'''3. When you install Abandoned Cart For WHMCS for the first time, you have to rename the '' 'license_RENAME.php' '' file.<br />
This file is located in '' 'modules/addons/abandonedCart/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
+
This file is located in '' 'modules/addons/AbandonedCart/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
 
|}
 
|}
 
{|
 
{|
Line 153: Line 201:
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|'''5. In the next step, set up the  '' 'storage' '' folder as recursively writable.'''<br />
 
|style="padding: 0px 0px 15px 15px;"|'''5. In the next step, set up the  '' 'storage' '' folder as recursively writable.'''<br />
This folder is available at '' 'your_whmcs/modules/addons/abandonedCart/' ''.
+
This folder is available at '' 'your_whmcs/modules/addons/AbandonedCart/' ''.
 
|}
 
|}
 
{|
 
{|
Line 227: Line 275:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:AC_14.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:AC_14.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Right next to the shopping cart details you will find a button which after pressing shows a direct URL to the abandoned cart.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_14_1.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_14_2.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|This URL can be automatically placed in the email message sent to a client provided a dedicated "Restore Abandoned Cart" option has been previously enabled [[#General_Settings|(more here)]].<br/> On pressing, the client can get his abandoned cart restored and he will be allowed to continue shopping with the already filled in cart with all the items.<br/> You may also use this URL to resend it manually.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_14_3.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|You may send email template reminders to preferred clients directly from the shopping carts list. Send emails to single clients or choose several recipients.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_14_4.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:AC_14_5.png]]
 
|}
 
|}
  
 
===Reminders===
 
===Reminders===
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|"Reminders" is the clue section of the whole module. Compose the reminders settings to deliver adjusted notifications to clients who abandoned their cart. <br/> Press '' 'Crete Reminder' '' button to create your firs rule.
+
|style="padding: 10px 0px 15px 15px;"|"Reminders" is the clue section of the whole module. Compose the reminders settings to deliver adjusted notifications to clients who abandoned their cart. <br/> Press '' 'Create Reminder' '' button to create your first rule.
 
|}
 
|}
 
{|
 
{|
Line 243: Line 315:
 
* '''Name''' - give the reminder a unique name
 
* '''Name''' - give the reminder a unique name
  
* '''Email Template for Existing Clients''' - choose the email template that will be used when opening a ticket to notify your already logged in/registered client; "xufa" is the default module template.  
+
* '''Email Template for Existing Clients''' - choose the email template that will be used to send an email message notifying your already logged in/registered client; "Abandoned Cart - Logged In Client Notification" is the default module template.  
  
* '''Email Template for Guests''' - choose the email template that will be used when opening a ticket to notify guest clients who visited your client area and started shopping; "sfa" is the default module template. <br/> You may preview and adjust the email templates content at ''your WHMCS → System Settings → Email Templates.''
+
* '''Email Template for Guests''' - choose the email template that will be used send an email message notifying your guest clients who visited your client area and started shopping; "Abandoned Cart - Open Ticket For Guest" is the default module template. <br/> You may preview and adjust the email templates content at ''your WHMCS → System Settings → Email Templates.''<br/> '''''Note:''' A support ticket is opened at the same time within a dedicated support department.''
  
* '''Related Products/Addons/Domains''' - select items, if any has been added to the cart, a related reminder will be sent to the interested client (logged in or guest who provided the email address)  
+
* '''Related Products/Addons/Domains''' - select items; if any has been added to the cart, a related reminder will be sent to the interested client (logged in or guest who provided the email address)  
  
 
* '''Include Carts Created More Than X Days Ago''' - type in the number of days, only carts created BEFORE will be verified
 
* '''Include Carts Created More Than X Days Ago''' - type in the number of days, only carts created BEFORE will be verified
  
* '''Include Carts Created Less Than X Days Ago''' - type in the number of days, only carts created AFTER will be verified,<br/> as illustrated: only carts created earlier than 3 but not earlier than 7 days ago will be checked
+
* '''Include Carts Created Less Than X Days Ago''' - type in the number of days, only carts created AFTER will be verified,<br/> as illustrated: only carts created between the last 3 and 7 days will be checked
  
 
Press '' 'Confirm' '' when your reminder configuration is ready.
 
Press '' 'Confirm' '' when your reminder configuration is ready.
Line 268: Line 340:
 
===General Settings===
 
===General Settings===
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|Under the '' 'General Settings' '' section you will find the cron details - setting it up is crucial for the module correct behavior and configuration for the client area
+
|style="padding: 10px 0px 15px 15px;"|Under the '' 'General Settings' '' section you will find the cron details - setting it up is crucial for the module's correct behavior and configuration.
 
'''Cron Task'''<br/>
 
'''Cron Task'''<br/>
Set up the cron that is responsible for sending email messages, based on created reminders as explained in the [[#Reminders|previous step]]. Every 5 minutes is recommended to assure fluent module performance.
+
Set up the cron that is responsible for sending email messages, based on created reminders as explained in the [[#Reminders|previous step]]. Once a day is recommended to assure fluent module performance.
 
|}
 
|}
 
{|
 
{|
Line 278: Line 350:
 
|style="padding: 0px 0px 15px 15px;"|'''General Settings:'''  
 
|style="padding: 0px 0px 15px 15px;"|'''General Settings:'''  
  
* '''Email Address Required''' - related to new visitors only; when a guest client in your client area adds an item to the cart, he will be forced to provide an email address before he is allowed to continue and complete the order
+
* '''Client Email Address''' - related to new visitors only; when a guest client starts to browse your store, he or she will be asked to provide an email address before being allowed to continue and complete the order:
 +
**Disabled
 +
**Require email address - the client will be forced to enter the email address to be able to continue the shopping
 +
**Allow to skip this step - the client can type in the email address or press "Skip" to continue shopping, if "Skip" is pressed, no data will be collected by the module
  
* '''Force Login/Registration''' - related to new visors and unclogged clients; when a client adds an item to the cart, he will be forced to either log in (if he already has an account) or register a new account (new clients).<br/> Otherwise, continuing the shopping will be impossible.<br/> '''''Important:''' Being logged in or at least providing an email address is required for the module correct behavior, without the email address no messages will be sent to remind clients about their abandoned carts.''<br/> '''''Note:''' We highly recommend enabling just one of the options, otherwise, guest clients will be forced to provide an email address in the first step and register and account in the next one.''
+
* '''Force Login/Registration''' - related to new visitors and unlogged clients; when a client adds an item to the cart, he or she will be forced to either log in (if the account already exists) or register a new account (new clients).<br/> Otherwise, continuing the shopping will be impossible.<br/> '''''Important:''' Being logged in or at least providing an email address is required for the module correct behavior, without the email address no messages will be sent to remind clients about their abandoned carts.''<br/> '''''Note:''' We highly recommend enabling just one of the options, otherwise, guest clients will be forced to provide an email address in the first step and register an account in the next one.''
 
   
 
   
 +
* '''Restore Abandoned Cart''' - if enabled, clients will receive a direct link to their abandoned cart, in the module reminding email message, with its all contents restored to easily complete the order.
 +
 
* '''Support Department''' - select one of the available support departments. A ticket to remind the guest clients about their abandoned carts will be opened within this department. <br/>
 
* '''Support Department''' - select one of the available support departments. A ticket to remind the guest clients about their abandoned carts will be opened within this department. <br/>
When your configuration ready, do not forget to press '' 'Submit' '' button to save your changes.
+
When your configuration is ready, do not forget to press the '' 'Submit' '' button to save your changes.
 +
 
 +
* '''Allow To Save Shopping Carts''' - when turned on, customers have the ability to save their shopping carts while placing an order.<br/> They can later access these carts from their profiles and share them with other customers using session URLs, instantly restoring the cart's contents.
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:AC_19.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:AC_19.png]]
 
|}
 
|}
 +
 
===Logs===
 
===Logs===
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|The '' 'Logs' '' section contains information an all actions taken by the module.<br/>
+
|style="padding: 10px 0px 20px 15px;"|The '' 'Logs' '' section contains information an all actions taken by the module.
You may always delete the logs if their number is extensive.
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:AC_20.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:AC_20.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|You may always delete the logs if their number is extensive.<br/>
 +
Use the action button for mass removal of all existing log entries.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:AC_20_1.png]]
 
|}
 
|}
  
 
==Client Area==
 
==Client Area==
 +
===Email/Login Requirement===
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|Once an unlogged client visits your marketplace, he will be forced to leave is personal data. The extent of what exactly must be provided, depends on the [[#General_Settings|configuration]].<br/> In order to fore the Abandoned Cart module action, any item (product, addon or domain) must be added to a cart:
+
|style="padding: 10px 0px 10px 15px;"|Once an unlogged client visits your marketplace, they will be asked to leave some of their personal data. The extent of what exactly must be provided depends on the module [[#General_Settings|configuration]].
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:AC_21.png]]
+
|style="padding: 0px 0px 15px 15px;"|The moment the client starts browsing your store, they will be either:
 +
*forced to provide an email address in order to be allowed to complete the shopping ''([[#General_Settings|"Client Email Address"]] option is set to "Require email address")''
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|The moment the client wants to either continue shopping or complete the order, he will be forced to:
+
|style="padding: 0px 0px 20px 25px;"|[[File:AC_22.png]]
*provide an email address in order to be allowed to complete the shopping ''([[#General_Settings|"Email Address Required"]] option is enabled)''
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:AC_22.png]]
+
|style="padding: 0px 0px 20px 15px;"|
 +
*asked to enter an email address in order to be allowed to complete the shopping ''([[#General_Settings|"Client Email Address"]] option is set to "Allow to skip this step")''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_22_1.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 20px 15px;"|
 
|style="padding: 0px 0px 20px 15px;"|
*log in or register a new account in order to be allowed to complete the shopping ''([[#General_Settings|"Force Login/Registration"]] option is enabled)''
+
*forced to log in or register a new account in order to be allowed to complete the shopping ''([[#General_Settings|"Force Login/Registration"]] option is enabled)''
 
|}
 
|}
 
{|
 
{|
Line 331: Line 422:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|Being logged in or leaving an email address is required for the module to be able to send email messages to clients reminding about abandoned carts and their content.<br/>
+
|style="padding: 0px 0px 15px 15px;"|Being logged in or leaving an email address is required for the module to be able to send email messages to clients reminding them about abandoned carts and their content.<br/>
 
This is how an exemplary email notification sent to a client might look like:
 
This is how an exemplary email notification sent to a client might look like:
 
|}
 
|}
Line 338: Line 429:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 1px 15px;"|Guest clients who leave only the email address and have no account in your system will get quite a similar notification email.<br/>  
+
|style="padding: 0px 0px 15px 15px;"|Guest clients who leave only the email address and have no account in your system will get quite a similar notification email.<br/>  
 
'''''Note:''' The system will open a new support ticket in a dedicated department at the same time. Only the assigned admin will have access to this ticket.''
 
'''''Note:''' The system will open a new support ticket in a dedicated department at the same time. Only the assigned admin will have access to this ticket.''
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:AC_25.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:AC_25.png]]
 +
|}
 +
 +
===Shopping Lists===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Clients have the convenience of storing their shopping carts to be viewed and finalized in the future.<br/> By clicking the "Save Cart" button while in your cart, the current contents of the cart will be promptly saved and stored in your shopping lists.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_28.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_29.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Once you have saved the cart as a shopping list, you can then access the list and manage it according to your needs.<br/> You will find the "My Shopping Lists" button in your account details dropdown menu.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_30.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Once you navigate to the "My Shopping Lists" page, you will find all your stored carts with basic details on the dashboard.
 +
Allowed actions on a :
 +
- Shopping cart URL
 +
- Shopping cart items
 +
- Delete saved shopping cart
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_31.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Clients may copy a direct URL to the cart and distribute it to others by providing them with the link. Upon opening the link, they will receive an identical copy of your shopping cart, allowing them to place their orders more quickly.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_32.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Explore the contents of this shopping list by previewing the items. Check details on the item types and their current availability in the store.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:AC_33.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Easily remove individual carts or utilize the mass action button to eliminate multiple items at once.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:AC_34.png]]
 
|}
 
|}
  
 
=Tips=
 
=Tips=
 
{|
 
{|
|style="padding: 10px 0px 5px 15px;"| 1. The module collects information on products, addons and domains left in the cart. No data on configurable options, custom fields etc related to products is stored.  
+
|style="padding: 10px 0px 5px 15px;"| 1. The module collects information on products, addons and domains left in the cart. No data on configurable options, custom fields etc. related to products is stored.  
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 10px 15px;"| 2. Along sending an email message to an unlogged client (only email address is provided), a ticket is automatically opened to notify an admin about the fact of sending such notification.<br/> We advise creating a dedicated support department to avoid numerous tickets being visible in your main ticketing system.
+
|style="padding: 0px 0px 10px 15px;"| 2. Upon sending an email message to a guest client, i.e. when only email address is provided, a ticket is automatically opened to notify an admin about the fact of sending such notification.<br/> We advise creating a dedicated support department to avoid numerous tickets being visible in your main ticketing system.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 10px 15px;"| 3. You can customize the content of breadcrumbs and messages visible to guests and clients by editing them in the language file located in the '' '/modules/addons/AbandonedCart/langs' '' path.<br/>
+
|style="padding: 0px 0px 10px 15px;"| 3. You can freely customize the content of breadcrumbs and messages visible to guests as well as logged in clients by editing them in the language file.<br> The language file can be found in the following path: '' '/modules/addons/AbandonedCart/langs'.''
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:AC_26.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:AC_26.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 15px;"|4. So as to protect your privacy and respect your decisions, clients may easily opt out of the Abandoned Cart module list of recipients.<br/> To do so, simply scroll down the notification email message and press the link to confirm your decision. Once processed, you will get a confirmation message about being successfully unsubscribed.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:AC_27.png]]
 +
|}
 +
 
 +
==How To Use Language Overrides==
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|'''Incorporating language customizations - the module readily accommodates language overrides, allowing you to tailor the language files to your preferences.'''<br/> The language file english.php remains unencoded and can be modified to suit your needs. However, it's recommended to avoid altering the core file itself, and instead, leverage the capability of using overrides.<br/>
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Here's how to apply language overrides:
 +
* Navigate to the ''~/langs/'' directory located within the following ''yourWHMCS/modules/servers/moduleName/langs/'' path.
 +
* Within this directory, create a new file or duplicate the language file you intend to modify. For instance, if you wish to create an override for the English language, establish the following directory structure:
 +
  ''~/langs/overrides/english.php''.
 +
* Open the newly created override file to edit its contents.
 +
* At the beginning of the file, indicate the used code, for instance, you can use: '''<?php''' for PHP code.
 +
* Adapt the file content according to your requirements. You can either selectively modify specific variables or opt to revise the entire content of the language file.
 +
 
 +
For example:
 +
 
 +
'''Original ''yourWHMCS/modules/servers/moduleName/langs/english.php:'''''
 +
 
 +
  $_LANG['Search'] = 'Search';
 +
 
 +
'''Override ''yourWHMCS/modules/servers/moduleName/langs/overrides/english.php:''''' 
 +
 
 +
  $_LANG['Search'] = 'Look for';
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|By following these steps, you can seamlessly implement language customizations without altering the core language file, ensuring your changes will not be lost after every module update.<br/>
 +
 
 +
Remember that some of the modules have more than one language file, located under ''/addons'' and ''/servers'' paths. You may create the override files for both of them.<br/> Note that you do not need to paste all the original content of the lang file into the override file. Enter there only the lines that you wish to change, every other line will be fetched from the original module lang file.<br/> Consequently, the override lang file might include only one or just a few lines.
 
|}
 
|}
  
 
=Update Instructions=
 
=Update Instructions=
 
{|
 
{|
|style="padding: 10px 0px 30px 15px;"|Essential guidance through the process of updating the module is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/><br/>
+
|style="padding: 10px 0px 30px 15px;"|An essential guidance through the process of updating the module to a higher version is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/>
Please keep in mind that there is a quick and easy option in our client area that lets you upgrade the license of your module to an open source version at any time - and at a lower price!<br/>
+
Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.<br/> Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.
To take advantage of it, simply use the '' 'License Upgrade' '' button located on the product's page and a discounted invoice will be generated automatically.<br/>
+
|}
 +
=Upgrade Guide=
 +
{|
 +
|style="padding: 10px 0px 30px 15px;"|Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?<br/> There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.<br/>
 +
 
 +
Opt for the [https://www.modulesgarden.com/products/whmcs/abandoned-cart#open-source-version Open Source version] of your Abandoned Cart For WHMCS module to unlock these benefits.<br/> Simply click on either the '''Get Source Code''' or '''Upgrade To Lifetime''' button found on the product's page in our client area to complete the one-step upgrade process, with a '''dedicated discount''' already applied.<br/>  
 +
 
 +
Follow a [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module comprehensive guide] covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.
 
|}
 
|}
  
 
=Common Problems=
 
=Common Problems=
 
{|
 
{|
|style="padding: 10px 0px 30px 15px;"|'''1. In case of connection problems, please check whether your SELinux or firewall does not block ports.'''
+
|style="padding: 10px 0px 10px 15px;"|'''1. In case of connection problems, please check whether your SELinux or firewall does not block ports.'''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 5px 15px;"|2. The Restore Abandoned Cart option does not support the following:
 +
* selected configurable options amounts
 +
* product custom fields
 +
* additional domains fields<br/>
 +
If you aim to restore a cart with the above items, the contents will be reset. We are constantly working on full support, which will be included in a future version of the module.
 +
|}
 +
<div id="Lagom_One_Step_Order_Form_Integration"></div>
 +
{|
 +
|style="padding: 0px 0px 30px 15px;"|3. The Abandoned Cart For WHMCS and [https://www.modulesgarden.com/products/whmcs/lagom-one-step-order-form#features '''Lagom One Step Order Form Wor WHMCS'''] modules can be used simultaneously, yet please bear in mind that the integration between these two is partially limited.<br/> Take a look at the below points to check which of the functionalities will work flawlessly, and which are not yet fully supported.
 +
'''Supported aspects:'''
 +
* logging actions in the cart, such as:
 +
** adding products, addons, and domains to the cart
 +
** domain transfer and renewal
 +
* sending reminders to clients about abandoned carts with items inside
 +
* forcing guest users to log in or register a new account
 +
* saving carts into "My Shopping List"
 +
 
 +
'''Functionalities still awaiting full integration:''' 
 +
* "Restore Abandoned Cart" functionality - direct URL to a cart although generated, always leads to an empty cart
 +
* "Client Email Address" functionality - a guest client is not stopped at any point when browsing your store to provide the email address. <br/>It might be done in a dedicated place, yet it is never an obligatory step, required to complete the order.
 +
 
 +
Keep in mind that we are constantly working on full integration between the two modules, please follow the [https://www.modulesgarden.com/products/whmcs/lagom-one-step-order-form#changelog changelogs] to keep track of the progress.
 
|}
 
|}

Revision as of 12:48, 19 April 2024

Contents

About Abandoned Cart For WHMCS

Abandoned Cart For WHMCS is a perfect tool that allows you to learn about your clients' habits and prevent unfinished purchases.

Check the content of shopping carts abandoned by your guests and send them customized email messages to remind about incomplete shopping.
Observe statistics on customers' behavior to perfectly adjust your offer to their needs which will quickly result in increased revenue and conversion rates.

  • Addon Module:
✔ Send Email Reminders To Clients And Guests Who Abandoned Their Shopping Carts
✔ Access And Manage Carts Statistics:
✔ View Number Of All Carts And Completed Orders
✔ View Percentage Of Existing Clients Carts To All Carts
✔ Display Statistics From Last:
✔ 1 Month
✔ 3 Months
✔ 6 Months
✔ 12 Months
✔ View Shopping Carts Snapshots With Logs On:
✔ Clients Names And Guest Emails
✔ Placed Orders And Payment Statuses
✔ Added And Removed Items
✔ Send Email Notifications To Clients From Shopping Carts List
✔ Access Saved Shopping Carts Via Token Cart URLs
✔ Configure Email Reminders Settings:
✔ Add Multiple Reminders
✔ Select Custom Email Templates For:
✔ Logged In Clients
✔ Guest Clients
✔ Specify Related Items In Cart:
✔ Products
✔ Products Addons
✔ Domains
✔ Send Reminders For Carts Created Within Specified Timeframe
✔ Configure General Settings:
✔ Define Requirements For Guest Clients To Leave Email Address:
✔ Disable Requirement
✔ Force To Provide Email Address
✔ Allow To Skip Email Address Requirement
✔ Force Guest Clients To Log In Or Register
✔ Send Direct Cart URL In Reminders To Restore Abandoned Cart
✔ Select Support Department For Reminders Sent To Guest Clients
✔ Allow Clients To Save Shopping Carts
✔ View Module Logs
  • Client Area Features:
✔ Save Shopping Cart Contents
✔ Share And Restore Saved Shopping Carts Via Token Cart URLs
✔ Optional Requirements For Guest Clients Upon Moving To Store:
✔ Provide Email Address
✔ Log In To Existing Account
✔ Register New Account
  • General Info:
✔ Limited Integration With Lagom One Step Order Form For WHMCS (Read More)
✔ Multi-Language Support
✔ Supports PHP 8.1 Back To PHP 7.4
✔ Supports WHMCS Themes "Twenty-One" And "Lagom WHMCS Client Theme"
✔ Supports WHMCS V8.9 Back To WHMCS V8.6
✔ Requires ionCube Loader V12 Or Later
✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Abandoned Cart For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.
AC 1.png
2. Upload and extract the extension into the main WHMCS directory.

Extracted files in your WHMCS directory should look like this:

AC 2.png
3. When you install Abandoned Cart For WHMCS for the first time, you have to rename the 'license_RENAME.php' file.

This file is located in 'modules/addons/AbandonedCart/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

AC 3.png
4. In order to configure your license key, you have to edit the previously renamed 'license.php' file.

Enter your license key between the quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

AC 4.png
5. In the next step, set up the 'storage' folder as recursively writable.

This folder is available at 'your_whmcs/modules/addons/AbandonedCart/' .

AC 5.png
6. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to 'System Settings' 'Addon Modules'. Afterwards, find 'Abandoned Cart' and press the 'Activate' button.

AC 6.png
7. In the next step you need to permit access to this module.

To do so, click on the 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

AC 7.png
8. You have just successfully installed Abandoned Cart For WHMCS!

You can access your module at 'Addons' 'Abandoned Cart'.

AC 8.png

Configuration and Management

Abandoned Cart For WHMCS allows you to control all the actions that take place in your marketplace.

Check the manual below to learn how to configure the module to take all the advantages it has to offer.

Addon Module

Dashboard

In the dashboard you can find the summary graphs of recently created shopping cart.

The first graph illustrates the number of all shopping carts created within the selected period of time. You may choose between 1, 3, 6 and 12 months to show the statistics for.

AC 9.png
AC 10.png
The second graph is dedicated to show the summary of completed orders only.
AC 11.png
The last graph "Existing Clients Carts / All Carts (%)" represents the percentage of cars created by the existing clients (unlogged guests are not taken into consideration)
towards the number of all carts (created by existing clients and guests together).
AC 12.png

Shopping Carts

The 'Shopping Carts' section, as its name suggests, contains a list of all identified carts, with details included, as follows:
  • client full name and its company name (if known)
  • the URL to the order if created
  • the cart details

Press the "Snapshots" button to find more specific information on the cart content and actions performed within that cart.

AC 13.png
Under "Snapshots" there are details on the cart content, visible at the moment of the last snapshot being taken.
You will find there also the history of changes made by the client, such as:
  • adding a new product/addon/domain
  • removing a product/addon/domain
AC 14.png
Right next to the shopping cart details you will find a button which after pressing shows a direct URL to the abandoned cart.
AC 14 1.png
AC 14 2.png
This URL can be automatically placed in the email message sent to a client provided a dedicated "Restore Abandoned Cart" option has been previously enabled (more here).
On pressing, the client can get his abandoned cart restored and he will be allowed to continue shopping with the already filled in cart with all the items.
You may also use this URL to resend it manually.
AC 14 3.png
You may send email template reminders to preferred clients directly from the shopping carts list. Send emails to single clients or choose several recipients.
AC 14 4.png
AC 14 5.png

Reminders

"Reminders" is the clue section of the whole module. Compose the reminders settings to deliver adjusted notifications to clients who abandoned their cart.
Press 'Create Reminder' button to create your first rule.
AC 15.png
Configure the reminder by providing the details as explained below:
  • Status - enable/disable the reminder
  • Name - give the reminder a unique name
  • Email Template for Existing Clients - choose the email template that will be used to send an email message notifying your already logged in/registered client; "Abandoned Cart - Logged In Client Notification" is the default module template.
  • Email Template for Guests - choose the email template that will be used send an email message notifying your guest clients who visited your client area and started shopping; "Abandoned Cart - Open Ticket For Guest" is the default module template.
    You may preview and adjust the email templates content at your WHMCS → System Settings → Email Templates.
    Note: A support ticket is opened at the same time within a dedicated support department.
  • Related Products/Addons/Domains - select items; if any has been added to the cart, a related reminder will be sent to the interested client (logged in or guest who provided the email address)
  • Include Carts Created More Than X Days Ago - type in the number of days, only carts created BEFORE will be verified
  • Include Carts Created Less Than X Days Ago - type in the number of days, only carts created AFTER will be verified,
    as illustrated: only carts created between the last 3 and 7 days will be checked

Press 'Confirm' when your reminder configuration is ready.

AC 16.png
The just created reminder rule will appear on the list with crucial details visible on the front page for a quick and easy preview.

You may enable/disable the reminder, edit and delete it using the actions buttons.

AC 17.png

General Settings

Under the 'General Settings' section you will find the cron details - setting it up is crucial for the module's correct behavior and configuration.

Cron Task
Set up the cron that is responsible for sending email messages, based on created reminders as explained in the previous step. Once a day is recommended to assure fluent module performance.

AC 18.png
General Settings:
  • Client Email Address - related to new visitors only; when a guest client starts to browse your store, he or she will be asked to provide an email address before being allowed to continue and complete the order:
    • Disabled
    • Require email address - the client will be forced to enter the email address to be able to continue the shopping
    • Allow to skip this step - the client can type in the email address or press "Skip" to continue shopping, if "Skip" is pressed, no data will be collected by the module
  • Force Login/Registration - related to new visitors and unlogged clients; when a client adds an item to the cart, he or she will be forced to either log in (if the account already exists) or register a new account (new clients).
    Otherwise, continuing the shopping will be impossible.
    Important: Being logged in or at least providing an email address is required for the module correct behavior, without the email address no messages will be sent to remind clients about their abandoned carts.
    Note: We highly recommend enabling just one of the options, otherwise, guest clients will be forced to provide an email address in the first step and register an account in the next one.
  • Restore Abandoned Cart - if enabled, clients will receive a direct link to their abandoned cart, in the module reminding email message, with its all contents restored to easily complete the order.
  • Support Department - select one of the available support departments. A ticket to remind the guest clients about their abandoned carts will be opened within this department.

When your configuration is ready, do not forget to press the 'Submit' button to save your changes.

  • Allow To Save Shopping Carts - when turned on, customers have the ability to save their shopping carts while placing an order.
    They can later access these carts from their profiles and share them with other customers using session URLs, instantly restoring the cart's contents.
AC 19.png

Logs

The 'Logs' section contains information an all actions taken by the module.
AC 20.png
You may always delete the logs if their number is extensive.

Use the action button for mass removal of all existing log entries.

AC 20 1.png

Client Area

Email/Login Requirement

Once an unlogged client visits your marketplace, they will be asked to leave some of their personal data. The extent of what exactly must be provided depends on the module configuration.
The moment the client starts browsing your store, they will be either:
  • forced to provide an email address in order to be allowed to complete the shopping ("Client Email Address" option is set to "Require email address")
AC 22.png
  • asked to enter an email address in order to be allowed to complete the shopping ("Client Email Address" option is set to "Allow to skip this step")
AC 22 1.png
  • forced to log in or register a new account in order to be allowed to complete the shopping ("Force Login/Registration" option is enabled)
AC 23.png
If 'Log in' is selected, the potential customer will be redirected to the standard client area login page.
AC 23 1.png
For 'Register' choice, the visitor will be asked to create a new account using a standard form.
AC 23 2.png
Being logged in or leaving an email address is required for the module to be able to send email messages to clients reminding them about abandoned carts and their content.

This is how an exemplary email notification sent to a client might look like:

AC 24.png
Guest clients who leave only the email address and have no account in your system will get quite a similar notification email.

Note: The system will open a new support ticket in a dedicated department at the same time. Only the assigned admin will have access to this ticket.

AC 25.png

Shopping Lists

Clients have the convenience of storing their shopping carts to be viewed and finalized in the future.
By clicking the "Save Cart" button while in your cart, the current contents of the cart will be promptly saved and stored in your shopping lists.
AC 28.png
AC 29.png
Once you have saved the cart as a shopping list, you can then access the list and manage it according to your needs.
You will find the "My Shopping Lists" button in your account details dropdown menu.
AC 30.png
Once you navigate to the "My Shopping Lists" page, you will find all your stored carts with basic details on the dashboard.

Allowed actions on a : - Shopping cart URL - Shopping cart items - Delete saved shopping cart

AC 31.png
Clients may copy a direct URL to the cart and distribute it to others by providing them with the link. Upon opening the link, they will receive an identical copy of your shopping cart, allowing them to place their orders more quickly.
AC 32.png
Explore the contents of this shopping list by previewing the items. Check details on the item types and their current availability in the store.
AC 33.png
Easily remove individual carts or utilize the mass action button to eliminate multiple items at once.
AC 34.png

Tips

1. The module collects information on products, addons and domains left in the cart. No data on configurable options, custom fields etc. related to products is stored.
2. Upon sending an email message to a guest client, i.e. when only email address is provided, a ticket is automatically opened to notify an admin about the fact of sending such notification.
We advise creating a dedicated support department to avoid numerous tickets being visible in your main ticketing system.
3. You can freely customize the content of breadcrumbs and messages visible to guests as well as logged in clients by editing them in the language file.
The language file can be found in the following path: '/modules/addons/AbandonedCart/langs'.
AC 26.png
4. So as to protect your privacy and respect your decisions, clients may easily opt out of the Abandoned Cart module list of recipients.
To do so, simply scroll down the notification email message and press the link to confirm your decision. Once processed, you will get a confirmation message about being successfully unsubscribed.
AC 27.png

How To Use Language Overrides

Incorporating language customizations - the module readily accommodates language overrides, allowing you to tailor the language files to your preferences.
The language file english.php remains unencoded and can be modified to suit your needs. However, it's recommended to avoid altering the core file itself, and instead, leverage the capability of using overrides.
Here's how to apply language overrides:
  • Navigate to the ~/langs/ directory located within the following yourWHMCS/modules/servers/moduleName/langs/ path.
  • Within this directory, create a new file or duplicate the language file you intend to modify. For instance, if you wish to create an override for the English language, establish the following directory structure:
 ~/langs/overrides/english.php.
  • Open the newly created override file to edit its contents.
  • At the beginning of the file, indicate the used code, for instance, you can use: <?php for PHP code.
  • Adapt the file content according to your requirements. You can either selectively modify specific variables or opt to revise the entire content of the language file.

For example:

Original yourWHMCS/modules/servers/moduleName/langs/english.php:

 $_LANG['Search'] = 'Search';

Override yourWHMCS/modules/servers/moduleName/langs/overrides/english.php:

 $_LANG['Search'] = 'Look for';
By following these steps, you can seamlessly implement language customizations without altering the core language file, ensuring your changes will not be lost after every module update.

Remember that some of the modules have more than one language file, located under /addons and /servers paths. You may create the override files for both of them.
Note that you do not need to paste all the original content of the lang file into the override file. Enter there only the lines that you wish to change, every other line will be fetched from the original module lang file.
Consequently, the override lang file might include only one or just a few lines.

Update Instructions

An essential guidance through the process of updating the module to a higher version is offered here.

Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.
Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?
There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.

Opt for the Open Source version of your Abandoned Cart For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

Common Problems

1. In case of connection problems, please check whether your SELinux or firewall does not block ports.
2. The Restore Abandoned Cart option does not support the following:
  • selected configurable options amounts
  • product custom fields
  • additional domains fields

If you aim to restore a cart with the above items, the contents will be reset. We are constantly working on full support, which will be included in a future version of the module.

3. The Abandoned Cart For WHMCS and Lagom One Step Order Form Wor WHMCS modules can be used simultaneously, yet please bear in mind that the integration between these two is partially limited.
Take a look at the below points to check which of the functionalities will work flawlessly, and which are not yet fully supported.

Supported aspects:

  • logging actions in the cart, such as:
    • adding products, addons, and domains to the cart
    • domain transfer and renewal
  • sending reminders to clients about abandoned carts with items inside
  • forcing guest users to log in or register a new account
  • saving carts into "My Shopping List"

Functionalities still awaiting full integration:

  • "Restore Abandoned Cart" functionality - direct URL to a cart although generated, always leads to an empty cart
  • "Client Email Address" functionality - a guest client is not stopped at any point when browsing your store to provide the email address.
    It might be done in a dedicated place, yet it is never an obligatory step, required to complete the order.

Keep in mind that we are constantly working on full integration between the two modules, please follow the changelogs to keep track of the progress.

Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Abandoned Cart For WHMCS