Difference between revisions of "Testing WHMCS"

From WHMCS Documentation

(→‎Testing Modules)
(→‎Storage Settings and Test Environments)
 
(62 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
This page details how to test a WHMCS installation before going live, then resetting it ready for production use.  
+
We recommend that you follow the below steps to test your WHMCS installation and then reset it for production use before you make it available to your customers.  
  
 
==Testing Modules==
 
==Testing Modules==
−
WHMCS shipped registrar and gateway modules come with, where possible, a test mode or the ability to use a test environment, that can be utilised to test transactions and domain orders. Referring to our documentation for the module being used will detail how test mode can be used. For example, with the eNom registrar module, this is detailed here: https://docs.whmcs.com/Enom#Test_Mode
 
  
−
An example of enabling test mode in the eNom module can be seen here:
+
When possible, WHMCS-shipped registrar and gateway modules come with a test mode or the ability to use a test environment to test transactions and domain orders. For details on enabling test mode, see the relevant module's documentation (for example, [https://docs.whmcs.com/Enom#Test_Mode Enom's documentation]).
  
−
[[File:Enom-test-mode.png|600px]]
+
For example, enabling test mode in the eNom module resembles this example:
 +
 
 +
[[File:Enom-test-mode.png|800px]]
 +
 
 +
Testing provisioning modules does not require a test mode. However, make certain that you are able to reverse all of the actions that you perform, both to restore the system to its original state and to test more functionality. For example, you could provision a cPanel account on a remote server and then use the '''Terminate''' module command to remove it.
 +
 
 +
==Disabling Outgoing Emails==
 +
 
 +
<div class="docs-alert-info">
 +
We added this feature in WHMCS 8.1.
 +
</div>
 +
 
 +
[[File:disable-emails.png|200px|thumb|right|Disable Email Toggle]] When testing, it is usually ideal to prevent WHMCS from sending emails (unless the test is specific to receiving emails).
 +
 
 +
To do this in WHMCS 8.1 and later:
 +
 
 +
# Go to the '''[[Mail Tab|Mail]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings'''.
 +
# Toggle '''Disable Email Sending''' to '''On'''.
 +
 
 +
==Placing Orders==
 +
 
 +
After you configure your required modules in test mode, place some test orders.
 +
 
 +
To place test orders in the [[Admin Area]]:
 +
 
 +
# Create a client account using the process in [https://help.whmcs.com/m/installation/l/682009-manually-adding-a-client/ Manually Adding a Client].
 +
#* If you have PHP experience, you can also add clients using the <tt>[https://developers.whmcs.com/api-reference/addclient AddClient]</tt> API.
 +
#* Make certain to configure the relevant domain or product pricing before proceeding with testing orders. For more information, see [[Domain Pricing]] and [[Products and Services]].[[File:Admin_order_form.png|200px|thumb|right|Admin Order Form]]  
 +
# Create multiple test orders. For example, to place an order for a domain registration:
 +
## In a client's profile's '''[[Clients:Summary Tab|Summary]]''' tab, click '''Add New Order''' in the "Actions" panel.
 +
## Fill out the displayed form, beginning with choosing the payment gateway you want the client's future invoices to use.
 +
## Select ''None'' from the '''Product/Service''' menu.
 +
## Select ''Monthly'' from the '''Billing Cycle''' menu for the product section.
 +
## Enter the domain for '''Domain''' and select "Register" for '''Domain Registration'''.
 +
## Choose the number of years you want to invoice the client for at the time of renewal.
 +
 
 +
You can also place an order by clicking '''Login as Owner''' in the client's profile's '''[[Clients:Summary Tab|Summary]]''' tab. This allows you to see the workflow a customer would see.
 +
 
 +
WHMCS will only ever trigger a registration request for a domain name when the client pays the invoice.
 +
For information about how WHMCS handles this for products, see [[Products_and_Services#Module_Settings|Module Settings]].
 +
 
 +
==Processing Transactions==
 +
 
 +
To test payment on an invoice, check our module documentation and follow the necessary process for the gateway module you are using.
 +
 
 +
For example, [[PayPal Checkout]] requires you to log in as a client and pay from the Client Area by selecting the invoice itself, while Stripe requires you to capture payment against a stored card or pay method. For more information, see [[Pay Methods]].
 +
 
 +
==Checking Automation==
 +
 
 +
[[File:gateway_log_example.png|200px|thumb|right|Gateway Log]]
 +
 
 +
You can find details on payments that the system has processed against an invoice at '''Billing > [[Gateway Log]]'''. The log will list the results and other data to allow you to validate success.
 +
 
 +
For domain registrars and provisioning modules, the '''Activity Log''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' or, prior to WHMCS 8.0, '''Utilities > Logs''' will record success or failure of the associated automation actions. This log also records details from the invoice's payment, like the addition of the transaction.
 +
 
 +
If automation encounters any errors, the '''[[Troubleshooting_Module_Problems|Module Debug Log]]''' will report the sent request and received response, allowing you to determine the issue and resolve it.
 +
 
 +
==Resetting Your Database==
 +
 
 +
After you successfully test your WHMCS configuration, you may want to reset it in order to remove the test accounts, orders, invoices, and other items that you created.
 +
 
 +
You can empty all of the tables that contain client data by running the following SQL code on your database:
 +
 
 +
<div class="source-cli">
 +
TRUNCATE `mod_invoicedata` ;
 +
<br/>TRUNCATE `tblinvoicedata` ;
 +
<br/>TRUNCATE `tblaccounts` ;
 +
<br/>TRUNCATE `tblactivitylog` ;
 +
<br/>TRUNCATE `tblaffiliates` ;
 +
<br/>TRUNCATE `tblaffiliatesaccounts` ;
 +
<br/>TRUNCATE `tblaffiliateshistory` ;
 +
<br/>TRUNCATE `tblaffiliatespending` ;
 +
<br/>TRUNCATE `tblaffiliateswithdrawals` ;
 +
<br/>TRUNCATE `tblbankaccts`;
 +
<br/>TRUNCATE `tblbillableitems` ;
 +
<br/>TRUNCATE `tblcancelrequests` ;
 +
<br/>TRUNCATE `tblclients` ;
 +
<br/>TRUNCATE `tblclientsfiles` ;
 +
<br/>TRUNCATE `tblcontacts` ;
 +
<br/>TRUNCATE `tblcredit` ;
 +
<br/>TRUNCATE `tblcreditcards`;
 +
<br/>TRUNCATE `tblcustomfieldsvalues` ;
 +
<br/>TRUNCATE `tbldomains` ;
 +
<br/>TRUNCATE `tbldomainsadditionalfields` ;
 +
<br/>TRUNCATE `tblemails` ;
 +
<br/>TRUNCATE `tblhosting` ;
 +
<br/>TRUNCATE `tblhostingaddons` ;
 +
<br/>TRUNCATE `tblhostingconfigoptions` ;
 +
<br/>TRUNCATE `tblinvoiceitems` ;
 +
<br/>TRUNCATE `tblinvoices` ;
 +
<br/>TRUNCATE `tblmodulequeue` ;
 +
<br/>TRUNCATE `tblnotes` ;
 +
<br/>TRUNCATE `tblorders` ;
 +
<br/>TRUNCATE `tblpaymethods`;
 +
<br/>TRUNCATE `tblquotes` ;
 +
<br/>TRUNCATE `tblquoteitems` ;
 +
<br/>TRUNCATE `tblsslorders` ;
 +
<br/>TRUNCATE `tblticketlog` ;
 +
<br/>TRUNCATE `tblticketnotes` ;
 +
<br/>TRUNCATE `tblticketreplies` ;
 +
<br/>TRUNCATE `tbltickets` ;
 +
<br/>TRUNCATE `tbltodolist` ;
 +
<br/>TRUNCATE `tbltransaction_history` ;
 +
<br/>TRUNCATE `tblupgrades` ;
 +
<br/>TRUNCATE `tblusers`;
 +
<br/>TRUNCATE `tblusers_clients`;
 +
<br/>TRUNCATE `tbluser_invites`;
 +
</div>
 +
 
 +
<div class="docs-alert-warning">
 +
Resetting your database only deletes client accounts and information. You will not lose any configuration or product settings.
 +
</div>
 +
 
 +
===Storage Settings and Test Environments===
 +
 
 +
When you use local storage locations and are switching between development (test) or live environments, it's important to update your storage settings. If the configured storage locations do not exist on your server, certain features (such as sending emails) may not function correctly.
 +
 
 +
<div class="docs-alert-warning">
 +
Amazon S3™ storage locations '''must''' have the required access credentials in order to function.
 +
</div>
 +
 
 +
For more information, see [[Migrating Between Storage Locations]].

Latest revision as of 14:25, 6 February 2023

We recommend that you follow the below steps to test your WHMCS installation and then reset it for production use before you make it available to your customers.

Testing Modules

When possible, WHMCS-shipped registrar and gateway modules come with a test mode or the ability to use a test environment to test transactions and domain orders. For details on enabling test mode, see the relevant module's documentation (for example, Enom's documentation).

For example, enabling test mode in the eNom module resembles this example:

Enom-test-mode.png

Testing provisioning modules does not require a test mode. However, make certain that you are able to reverse all of the actions that you perform, both to restore the system to its original state and to test more functionality. For example, you could provision a cPanel account on a remote server and then use the Terminate module command to remove it.

Disabling Outgoing Emails

We added this feature in WHMCS 8.1.

Disable Email Toggle
When testing, it is usually ideal to prevent WHMCS from sending emails (unless the test is specific to receiving emails).

To do this in WHMCS 8.1 and later:

  1. Go to the Mail tab at Configuration () > System Settings > General Settings.
  2. Toggle Disable Email Sending to On.

Placing Orders

After you configure your required modules in test mode, place some test orders.

To place test orders in the Admin Area:

  1. Create a client account using the process in Manually Adding a Client.
    • If you have PHP experience, you can also add clients using the AddClient API.
    • Make certain to configure the relevant domain or product pricing before proceeding with testing orders. For more information, see Domain Pricing and Products and Services.
      Admin Order Form
  2. Create multiple test orders. For example, to place an order for a domain registration:
    1. In a client's profile's Summary tab, click Add New Order in the "Actions" panel.
    2. Fill out the displayed form, beginning with choosing the payment gateway you want the client's future invoices to use.
    3. Select None from the Product/Service menu.
    4. Select Monthly from the Billing Cycle menu for the product section.
    5. Enter the domain for Domain and select "Register" for Domain Registration.
    6. Choose the number of years you want to invoice the client for at the time of renewal.

You can also place an order by clicking Login as Owner in the client's profile's Summary tab. This allows you to see the workflow a customer would see.

WHMCS will only ever trigger a registration request for a domain name when the client pays the invoice. For information about how WHMCS handles this for products, see Module Settings.

Processing Transactions

To test payment on an invoice, check our module documentation and follow the necessary process for the gateway module you are using.

For example, PayPal Checkout requires you to log in as a client and pay from the Client Area by selecting the invoice itself, while Stripe requires you to capture payment against a stored card or pay method. For more information, see Pay Methods.

Checking Automation

Gateway Log

You can find details on payments that the system has processed against an invoice at Billing > Gateway Log. The log will list the results and other data to allow you to validate success.

For domain registrars and provisioning modules, the Activity Log at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs will record success or failure of the associated automation actions. This log also records details from the invoice's payment, like the addition of the transaction.

If automation encounters any errors, the Module Debug Log will report the sent request and received response, allowing you to determine the issue and resolve it.

Resetting Your Database

After you successfully test your WHMCS configuration, you may want to reset it in order to remove the test accounts, orders, invoices, and other items that you created.

You can empty all of the tables that contain client data by running the following SQL code on your database:

TRUNCATE `mod_invoicedata` ;
TRUNCATE `tblinvoicedata` ;
TRUNCATE `tblaccounts` ;
TRUNCATE `tblactivitylog` ;
TRUNCATE `tblaffiliates` ;
TRUNCATE `tblaffiliatesaccounts` ;
TRUNCATE `tblaffiliateshistory` ;
TRUNCATE `tblaffiliatespending` ;
TRUNCATE `tblaffiliateswithdrawals` ;
TRUNCATE `tblbankaccts`;
TRUNCATE `tblbillableitems` ;
TRUNCATE `tblcancelrequests` ;
TRUNCATE `tblclients` ;
TRUNCATE `tblclientsfiles` ;
TRUNCATE `tblcontacts` ;
TRUNCATE `tblcredit` ;
TRUNCATE `tblcreditcards`;
TRUNCATE `tblcustomfieldsvalues` ;
TRUNCATE `tbldomains` ;
TRUNCATE `tbldomainsadditionalfields` ;
TRUNCATE `tblemails` ;
TRUNCATE `tblhosting` ;
TRUNCATE `tblhostingaddons` ;
TRUNCATE `tblhostingconfigoptions` ;
TRUNCATE `tblinvoiceitems` ;
TRUNCATE `tblinvoices` ;
TRUNCATE `tblmodulequeue` ;
TRUNCATE `tblnotes` ;
TRUNCATE `tblorders` ;
TRUNCATE `tblpaymethods`;
TRUNCATE `tblquotes` ;
TRUNCATE `tblquoteitems` ;
TRUNCATE `tblsslorders` ;
TRUNCATE `tblticketlog` ;
TRUNCATE `tblticketnotes` ;
TRUNCATE `tblticketreplies` ;
TRUNCATE `tbltickets` ;
TRUNCATE `tbltodolist` ;
TRUNCATE `tbltransaction_history` ;
TRUNCATE `tblupgrades` ;
TRUNCATE `tblusers`;
TRUNCATE `tblusers_clients`;
TRUNCATE `tbluser_invites`;

Resetting your database only deletes client accounts and information. You will not lose any configuration or product settings.

Storage Settings and Test Environments

When you use local storage locations and are switching between development (test) or live environments, it's important to update your storage settings. If the configured storage locations do not exist on your server, certain features (such as sending emails) may not function correctly.

Amazon S3™ storage locations must have the required access credentials in order to function.

For more information, see Migrating Between Storage Locations.

Retrieved from "http://3.17.75.209/index.php?title=Testing_WHMCS&oldid=33871"