WHMCS Documentation - User contributions [en]

Changelog:WHMCS V8.7

2023-03-23T22:43:27Z

Chance: /* Version 8.7.1 (General Availability) */

=Version 8.7.0 (Beta 1)=
{{:Changelog:WHMCS_V8.7.0_Beta_1}}

=Version 8.7.0 (Beta 2)=
{{:Changelog:WHMCS_V8.7.0_Beta_2}}

=Version 8.7.0 (Release Candidate 1)=
{{:Changelog:WHMCS_V8.7.0_RC_1}}

=Version 8.7.0 (General Availability)=
{{:Changelog:WHMCS_V8.7.0_GA}}

=Version 8.7.1 (Maintenance)=
{{:Changelog:WHMCS_V8.7.1}}

Version 8.7 Release Notes

2023-03-23T22:36:23Z

Chance: /* Changelog */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.7.1<br />
Release Type: General Availability<br />
Latest Update: 23st March 2023<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.7's important changes and exciting features, see [[New and Improved in WHMCS 8.7]].
</div>

==Version History==

<onlyinclude>
<table class="table table-striped">
<tr><td>8.7.0</td><td>Beta 1</td><td>21st December 2022</td></tr>
<tr><td>8.7.0</td><td>Beta 2</td><td>25th January 2023</td></tr>
<tr><td>8.7.0</td><td>RC</td><td>24th February 2023</td></tr>
<tr><td>8.7.0</td><td>GA</td><td>21st March 2023</td></tr>
<tr><td>8.7.1</td><td>Maintenance</td><td>23st March 2023</td></tr>
</table>
</onlyinclude>
==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== CentralNic Reseller Module ===

We now ship a '''CentralNic Reseller''' domain registrar module. It uses the new CentralNic Reseller platform.

* After you start using the '''CentralNic Reseller''' module, you can select '''CentralNic Reseller''' as your lookup provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Pricing]]'''.
* This module replaces the '''RRPProxy''' module.

<div class="docs-alert-info">
If you have configured '''RRPProxy''' in WHMCS, the update process will migrate your configuration and any existing RRP Proxy domains to the new CentralNic Reseller module and remove '''RRPProxy''' from your system.
</div>

[[CentralNic Reseller|Learn More]]

=== Instant Issuance for SSL Certificates via MarketConnect ===

Instant Issuance makes [[SSL Certificates via WHMCS MarketConnect|selling and deploying DigiCert SSL certificates]] even faster and more reliable. SSL protection is instantaneous, with the entire process taking under a minute.

In WHMCS 8.7 and later, MarketConnect uses Instant Issuance by default for eligible newly-purchased SSL certificates.

[[SSL Certificate Instant Issuance|Learn More]]

=== NordVPN via WHMCS MarketConnect ===

In WHMCS 8.7 and later, WHMCS MarketConnect now allows you to offer NordVPN and help your customers secure their personal and business data with a personal VPN.

[[NordVPN via WHMCS MarketConnect|Learn More]]

=== Smarty Compatibility ===

We plan to remove support for SmartyBC, which provides backward compatibility for legacy Smarty tags, in WHMCS 9.0. As a result, WHMCS 6.0 deprecated use of the <tt>{php}</tt>, <tt>{include_php}</tt>, and <tt>{insert}</tt> tags.

To help you make certain that your system is ready for this change, WHMCS 8.7 includes warnings in the Admin Area and at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Health Status|System Health]]'''. The new '''Smarty Compatibility''' scan can detect legacy Smarty tags on your WHMCS installation and displays the results at '''Reports > [[Reports]]'''.

<div class="docs-alert-danger">
Anyone using <tt>{php}</tt>, <tt>{include_php}</tt>, and <tt>{insert}</tt> tags in custom theme and template files '''must''' remove them as soon as possible. For more information, see [[#Legacy Smarty Tags|Legacy Smarty Tags]] in the [[#Deprecation and Removal Notices|Deprecation and Removal Notices]] section below.
</div>

[[Eliminating Legacy Smarty Tags|Learn More]]

=== Coming Soon: 360 Monitoring via WHMCS MarketConnect ===

In WHMCS 8.7, you will see the new 360 Monitoring service in WHMCS MarketConnect. 360 Monitoring lets your customers monitor websites and servers, track metrics, personalize their dashboards, and export reports. This allows them to optimize performance and detect downtime immediately, with free and paid plans to meet each business's needs.

We will enable sales through 360 Monitoring soon. Until then, you can view all of the details in the Admin Area at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[MarketConnect]]'''.

[[360 Monitoring via WHMCS MarketConnect|Learn More]]

== Deprecation and Removal Notices ==

=== Legacy Smarty Tags ===

WHMCS 9.0 will permanently remove all support for SmartyBC, which provided backward compatibility for <tt>{php}</tt>, <tt>{include_php}</tt>, and <tt>{insert}</tt> tags in custom themes and templates. Removing this support promotes stronger security on your WHMCS installation. It will also allow WHMCS to upgrade to using Smarty 4, which does not include SmartyBC, in the near future.

WHMCS 6.0 deprecated support for these tags, and WHMCS 8.7 deprecates the associated '''Allow Smarty PHP Tags''' setting in the '''[[Security_Tab|Security]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings'''.

[[Eliminating Legacy Smarty Tags|Learn More]]

=== Removed Modules ===

We have removed the '''[[Payson]]''' and '''[[RRPProxy]]''' modules:

* Payson ceases support for our module in January 2023. The update to WHMCS 8.7 will remove the files for this module.
* We no longer support the '''RRPProxy''' module. If you previously configured this module, the update process will migrate you to the new '''[[CentralNic Reseller]]''' module before removing the '''RRPProxy''' files.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.6.1 and 8.7.1:

https://github.com/WHMCS/templates-twenty-one/compare/v8.6.1-release.1...v8.7.1-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.6.1 and 8.7.1:

https://github.com/WHMCS/templates-six/compare/v8.6.1-release.1...v8.7.1-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.6.1 and 8.7.1:

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.6.1-release.1...v8.7.1-release.1

== Changelog ==

* [[Changelog:WHMCS_V8.7.0_Beta_1|Version 8.7.0 Beta 1]]
* [[Changelog:WHMCS_V8.7.0_Beta_2|Version 8.7.0 Beta 2]]
* [[Changelog:WHMCS_V8.7.0_RC_1|Version 8.7.0 RC 1]]
* [[Changelog:WHMCS_V8.7.0_GA|Version 8.7.0 GA 1]]
* [[Changelog:WHMCS_V8.7.1|Version 8.7.1 Maintenance]]

Version 8.7 Release Notes

2023-03-23T22:31:20Z

Chance: /* Changelog */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.7.1<br />
Release Type: General Availability<br />
Latest Update: 23st March 2023<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.7's important changes and exciting features, see [[New and Improved in WHMCS 8.7]].
</div>

==Version History==

<onlyinclude>
<table class="table table-striped">
<tr><td>8.7.0</td><td>Beta 1</td><td>21st December 2022</td></tr>
<tr><td>8.7.0</td><td>Beta 2</td><td>25th January 2023</td></tr>
<tr><td>8.7.0</td><td>RC</td><td>24th February 2023</td></tr>
<tr><td>8.7.0</td><td>GA</td><td>21st March 2023</td></tr>
<tr><td>8.7.1</td><td>Maintenance</td><td>23st March 2023</td></tr>
</table>
</onlyinclude>
==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== CentralNic Reseller Module ===

We now ship a '''CentralNic Reseller''' domain registrar module. It uses the new CentralNic Reseller platform.

* After you start using the '''CentralNic Reseller''' module, you can select '''CentralNic Reseller''' as your lookup provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Pricing]]'''.
* This module replaces the '''RRPProxy''' module.

<div class="docs-alert-info">
If you have configured '''RRPProxy''' in WHMCS, the update process will migrate your configuration and any existing RRP Proxy domains to the new CentralNic Reseller module and remove '''RRPProxy''' from your system.
</div>

[[CentralNic Reseller|Learn More]]

=== Instant Issuance for SSL Certificates via MarketConnect ===

Instant Issuance makes [[SSL Certificates via WHMCS MarketConnect|selling and deploying DigiCert SSL certificates]] even faster and more reliable. SSL protection is instantaneous, with the entire process taking under a minute.

In WHMCS 8.7 and later, MarketConnect uses Instant Issuance by default for eligible newly-purchased SSL certificates.

[[SSL Certificate Instant Issuance|Learn More]]

=== NordVPN via WHMCS MarketConnect ===

In WHMCS 8.7 and later, WHMCS MarketConnect now allows you to offer NordVPN and help your customers secure their personal and business data with a personal VPN.

[[NordVPN via WHMCS MarketConnect|Learn More]]

=== Smarty Compatibility ===

We plan to remove support for SmartyBC, which provides backward compatibility for legacy Smarty tags, in WHMCS 9.0. As a result, WHMCS 6.0 deprecated use of the <tt>{php}</tt>, <tt>{include_php}</tt>, and <tt>{insert}</tt> tags.

To help you make certain that your system is ready for this change, WHMCS 8.7 includes warnings in the Admin Area and at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Health Status|System Health]]'''. The new '''Smarty Compatibility''' scan can detect legacy Smarty tags on your WHMCS installation and displays the results at '''Reports > [[Reports]]'''.

<div class="docs-alert-danger">
Anyone using <tt>{php}</tt>, <tt>{include_php}</tt>, and <tt>{insert}</tt> tags in custom theme and template files '''must''' remove them as soon as possible. For more information, see [[#Legacy Smarty Tags|Legacy Smarty Tags]] in the [[#Deprecation and Removal Notices|Deprecation and Removal Notices]] section below.
</div>

[[Eliminating Legacy Smarty Tags|Learn More]]

=== Coming Soon: 360 Monitoring via WHMCS MarketConnect ===

In WHMCS 8.7, you will see the new 360 Monitoring service in WHMCS MarketConnect. 360 Monitoring lets your customers monitor websites and servers, track metrics, personalize their dashboards, and export reports. This allows them to optimize performance and detect downtime immediately, with free and paid plans to meet each business's needs.

We will enable sales through 360 Monitoring soon. Until then, you can view all of the details in the Admin Area at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[MarketConnect]]'''.

[[360 Monitoring via WHMCS MarketConnect|Learn More]]

== Deprecation and Removal Notices ==

=== Legacy Smarty Tags ===

WHMCS 9.0 will permanently remove all support for SmartyBC, which provided backward compatibility for <tt>{php}</tt>, <tt>{include_php}</tt>, and <tt>{insert}</tt> tags in custom themes and templates. Removing this support promotes stronger security on your WHMCS installation. It will also allow WHMCS to upgrade to using Smarty 4, which does not include SmartyBC, in the near future.

WHMCS 6.0 deprecated support for these tags, and WHMCS 8.7 deprecates the associated '''Allow Smarty PHP Tags''' setting in the '''[[Security_Tab|Security]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings'''.

[[Eliminating Legacy Smarty Tags|Learn More]]

=== Removed Modules ===

We have removed the '''[[Payson]]''' and '''[[RRPProxy]]''' modules:

* Payson ceases support for our module in January 2023. The update to WHMCS 8.7 will remove the files for this module.
* We no longer support the '''RRPProxy''' module. If you previously configured this module, the update process will migrate you to the new '''[[CentralNic Reseller]]''' module before removing the '''RRPProxy''' files.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.6.1 and 8.7.0 (GA 1):

https://github.com/WHMCS/templates-twenty-one/compare/v8.6.1-release.1...v8.7.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.6.1 and 8.7.0 (GA 1):

https://github.com/WHMCS/templates-six/compare/v8.6.1-release.1...v8.7.0-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.6.1 and 8.7.0 (GA 1):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.6.1-release.1...v8.7.0-release.1

== Changelog ==

* [[Changelog:WHMCS_V8.7.0_Beta_1|Version 8.7.0 Beta 1]]
* [[Changelog:WHMCS_V8.7.0_Beta_2|Version 8.7.0 Beta 2]]
* [[Changelog:WHMCS_V8.7.0_RC_1|Version 8.7.0 RC 1]]
* [[Changelog:WHMCS_V8.7.0_GA|Version 8.7.0 GA 1]]
* [[Changelog:WHMCS_V8.7.1_GA|Version 8.7.1 Maintenance]]

Version 8.7.1 Release Notes

2023-03-23T22:30:53Z

Chance: Redirected page to Version 8.7 Release Notes

#REDIRECT [[Version_8.7_Release_Notes]]

Changelog:WHMCS V8.7.1

2023-03-23T22:30:11Z

Chance:

<noinclude>[[Version 8.7.1 Release Notes]]</noinclude>

== Maintenance ==
CORE-18533 - Improve price display in 360 Monitoring landing page<br />
CORE-18539 - Prevent update error related to missing addon records<br />
CORE-18543 - Remove obsolete template files related to licensing provisioning module if present<br />

Changelog:WHMCS V8.7.1

2023-03-23T22:29:26Z

Chance:

<noinclude>[[Version 8.7.0 Release Notes]]</noinclude>

== Maintenance ==
CORE-18533 - Improve price display in 360 Monitoring landing page<br />
CORE-18539 - Prevent update error related to missing addon records<br />
CORE-18543 - Remove obsolete template files related to licensing provisioning module if present<br />

Changelog:WHMCS V8.7.1

2023-03-23T22:28:23Z

Chance:

Version 8.6 Release Notes

2022-11-03T18:17:22Z

Chance: /* Templates */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: General Availability<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (GA):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (GA):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (GA):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T18:17:10Z

Chance: /* Twenty-One Theme */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: General Availability<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (GA):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T17:30:55Z

Chance: /* Standard Cart Order Form */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: General Availability<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T17:30:37Z

Chance: /* Six Theme */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: General Availability<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T17:30:12Z

Chance: /* Twenty-One Theme */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: General Availability<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T17:25:51Z

Chance:

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: General Availability<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T17:25:30Z

Chance: /* Changelog */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: GA<br />
Latest Update: 3rd November 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]
* [[Changelog:WHMCS_V8.6.0_GA|Version 8.6.0 GA]]

Version 8.6 Release Notes

2022-11-03T17:23:49Z

Chance: /* Changelog */

Version 8.6 Release Notes

2022-11-03T17:23:11Z

Chance:

Version 8.6 Release Notes

2022-11-03T17:22:31Z

Chance: /* Version History */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: RC<br />
Latest Update: 6th October 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>General Availability</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]

Version 8.6 Release Notes

2022-11-03T17:22:16Z

Chance: /* Version History */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.6.0<br />
Release Type: RC<br />
Latest Update: 6th October 2022<br />
Distribution Types: Full and Via Automatic Updater
</div>

<div class="docs-alert-success">
For more information on WHMCS 8.6's important changes and exciting features, see [[New and Improved in WHMCS 8.6]].
</div>

==Version History==
<onlyinclude>
<table class="table table-striped">
<tr><td>8.6.0</td><td>Beta 1</td><td>7th September 2022</td></tr>
<tr><td>8.6.0</td><td>RC 1</td><td>6th October 2022</td></tr>
<tr><td>8.6.0</td><td>GA</td><td>3rd November 2022</td></tr>
</table>
</onlyinclude>

==Download==

Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

<div class="docs-alert-warning">
Make certain that you update to a WHMCS version that supports your desired PHP version or higher '''before''' updating PHP.
* The [[Automatic Updater]] only displays updates if you are running a PHP version that is compatible with that WHMCS version.
* For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.
</div>

[[Upgrading|Upgrade Instructions]]

===Automatic Updating===

If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic Updater]].

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info">
If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

== Release Notes ==

=== OAuth2 Support for Microsoft® Services ===

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

* You can configure Microsoft services for [[Email Importing|email importing]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]'''.
* You can configure Microsoft services as your WHMCS installation's mail provider at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' in the '''[[Mail_Tab|Mail]]''' tab.

[[Email Importing Integrations|Learn More...]]

=== Activate Payment Gateways via Apps & Integrations ===

You can now only activate new payment gateways through the list of modules at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]'''. This list will continue to display all of your activated payment gateways and their configuration options.

[https://help.whmcs.com/m/setup/l/848616-configuring-your-first-payment-gateway Learn More...]

=== PHP 8.1 Support ===

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

<div class="docs-alert-warning">
Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.
</div>

[[PHP Migration Guide|Learn More...]]

== Deprecation and Removal Notices ==

=== Removed Modules ===

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

* [[ChronoPay]]
* e-onlinedata

After the update, you can check the '''Activity Log''' section at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' for a list of removals.

== Templates ==

For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

===Twenty-One Theme===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-twenty-one/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Six Theme ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/templates-six/compare/v8.5.1-release.1...v8.6.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.5.1 and 8.6.0 (RC):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.5.1-release.1...v8.6.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V8.6.0_Beta_1|Version 8.6.0 Beta 1]]
* [[Changelog:WHMCS_V8.6.0_RC_1|Version 8.6.0 RC 1]]

Changelog:WHMCS V8.6.0 GA

2022-11-03T17:20:14Z

Chance: Created page with "<noinclude>Version 8.6.0 Release Notes</noinclude> == Maintenance == CORE-17898 - Correct merge field link for OX App Suite welcome email<br /> CORE-18126 - Correct spin..."

<noinclude>[[Version 8.6.0 Release Notes]]</noinclude>

== Maintenance ==
CORE-17898 - Correct merge field link for OX App Suite welcome email<br />
CORE-18126 - Correct spinner for MarketConnect SSL sidebar action<br /> Also known as: MODULE-7838<br />
CORE-18127 - Ensure MarketConnect SSL active action is highlighted in sidebar<br /> Also known as: MODULE-7837<br />
CORE-18128 - Do not render Change Approver action for MarketConnect SSL once issued<br /> Also known as: MODULE-7836<br />
CORE-18142 - Nullify previous POP3/IMAP configuration when saving MS configurations<br />
CORE-18156 - Correct inability to manage or activate Marketconnect services<br />
CORE-18161 - Correct generated redirect path for MS OAuth<br />
CORE-18165 - Prevent error in PHP 8.1 when performing domain search with premium domains enabled<br />
CORE-18168 - Prevent error in PHP 8.1 during render of Marketgoo landing page with a single currency<br />
CORE-18169 - Prevent error in PHP 8.1 on configpromotions page when configurable options group is set up<br />
CORE-18173 - Improve CLI output of POP Import for MS imports<br />
CORE-18174 - Correct email message ID handling for MS Graph API to ensure deletion of unexpected IDs following import<br />
CORE-18200 - Correct error handling for invalid domain check input<br />

== Modules ==
MODULE-7696 - Ensure invoice can be paid using PayPal Checkout when recurring service is $0.00<br /> Also known as: CORE-17201<br />
MODULE-7709 - Improve phone number handling in Nominet<br />
MODULE-7854 - Prevent error in PHP 8.1 for Offline CC<br />

== Languages ==
CORE-18098 - Update Hungarian translations<br />

Changelog:WHMCS V8.6

2022-11-03T17:18:48Z

Chance:

=Version 8.6.0 (Beta 1)=
{{:Changelog:WHMCS_V8.6.0_Beta_1}}

=Version 8.6.0 (RC 1)=
{{:Changelog:WHMCS_V8.6.0_RC_1}}

=Version 8.6.0 (General Availability)=
{{:Changelog:WHMCS_V8.6.0_GA}}

Long Term Support

2022-10-06T19:50:30Z

Chance: /* WHMCS Version & LTS Schedule */

== WHMCS Long-Term Support ==

Product enhancements, bug fixes and security fixes for published versions of WHMCS are common; WHMCS is constantly being refined to ensure a safe and robust experience. However, it is impractical for customers to always track the latest product refinements at the same pace as our Development Team. And for that reason, WHMCS has implemented a Long-Term Support Policy for WHMCS.

=== Overview ===
The WHMCS Long-Term Support Policy provides customers with a clear understanding of our commitment to supporting the software they have purchased a license for and installed on their systems.

WHMCS will provide periodic maintenance releases for major and minor versions of WHMCS as part of the normal WHMCS Release Process. This is called [[#Active Development | Active Development]]. Versions of WHMCS that are not under Active Development will not receive maintenance releases, however, they are candidates for Targeted Critical and Security Releases. WHMCS will only provide Targeted Releases for candidates that have not reached their [[#Defining End Of Life | End Of Life]].

Please refer to the [[#WHMCS Version & LTS Schedule|WHMCS Version and LTS Schedule]] to see what versions of WHMCS are currently covered by Long-Term Support or under Active Development.

=== Provisions of Long-Term Support ===
Once a version of WHMCS is no longer being actively developed it will receive Long-Term Support (LTS) from our Development and Security Teams. LTS is a finite period which expires on a specific date known as End Of Life (EOL). Each minor version has it's own EOL date.

Product versions that are in LTS are provided Targeted Critical and Security Releases.

Once a version has moved from Active Development to LTS it will not receive product enhancements or maintenance fixes unless they are deemed critical to the viability of a Targeted Critical or Security Release, and therefore delivered as part of LTS. If you require product enhancements or maintenance fixes, we suggest updating to a product version that is being actively developed.

=== Active Development ===
A product version that is under Active Development is in the process of being refined. Therefore, subsequent revisions are likely to be released until a new minor version is published. Revision releases can include bug fixes, security enhancements, minor optimizations, third-party updates, as well as Important or Critical updates.

At any given moment in time, there will likely be only one actively developed version of WHMCS available; it will be the latest version available for our site. However, to ensure a smooth transition from one major or minor version to the next, WHMCS may extend Active Development of the previously published version. These overlaps between product versions is usually quite small, on the order of a few weeks at most.

Please refer to [[#WHMCS Version & LTS Schedule|WHMCS Version and LTS Schedule]] to know if your version is currently under Active Development.

=== Defining End Of Life ===
A core attribute of the Long-Term Support Policy is defining a given version's End Of Life (EOL) date. The EOL date is established upon the publication of a new minor or major release and typically is set one year into the future.

For example if version 1.0.0 is published January 31, 2012, then it will have an EOL of January 1st 2013 because it is a major release. If 1.1.0 is published on May 1st, 2012, it will have an EOL of May 1st 2013 because it is a minor release. If 1.1.1 is published on May 15th 2012 it will have an EOL of May 1st 2013 because it is a maintenance release to a previous minor release. Likewise, if 1.1.5 is published on July 24th 2012 it will have an EOL of May 1st 2013 because it is a maintenance release to a previous minor release.

=== After End Of Life ===
Once a version's EOL date has passed, no further releases or updates will be provided, regardless of the observed deficiency in that version.

Products that have reached EOL are not available for download from WHMCS.

As noted below in [[#Licensing & Services | Licensing & Services]], the product will continue to function even after the EOL date has passed. The use of the software is not tied to LTS or EOL, but the active/inactive state of your license.

=== Licensing & Services ===
WHMCS has historically offered with two types of licenses: Monthly and Owned. Whilst all new sales are of the Monthly type, this document also describes how the policy applies to [[Renewing Support and Updates|grandfathered Owned licenses]]. Each license type is bundled with [[#Help Desk Support | help desk support]] and access to [[#Software Update Service | software updates]] when initially purchased.

A Monthly license always has access to these two services. An Owned license has access to these two services for one year. After one year, an Owned license holder can purchase an additional year of these two services as an addon.

An Owned license validates use of the software indefinitely, even after the term of help desk support and access to software updates expires. A Monthly license validates use of the software, help desk support, and access to software updates in one month durations. The active status of your license governs the functional state of your WHMCS installation, not the development status (Active Development/LTS/EOL) of the deployed product version.

==== Help Desk Support ====
The help desk support service allows customers to open tickets with our help desk. These tickets are managed by our Technical Analysts. Our Analysts work with customers to resolve a broad range of issues from configuration to identifying deficiency within a given version of WHMCS. With this service, customers have access to Analysts regardless of which version of the product they are using, even if that version has reached its End Of Life.

It's important to remember, however, that support provided by this service, or deficiencies identified by our Analysts, does not imply future refinements for versions. The [[#WHMCS Version & LTS Schedule|LTS schedule]], along with the severity of the identified issue, will determine what versions of WHMCS are candidates for any future refines.

==== Software Update Service ====
The software update service allows customers access to the latest versions of WHMCS. The service does not imply continued development, maintenance, or critical fixes for any given version of WHMCS. The [[#WHMCS Version & LTS Schedule|LTS schedule]] will determine what versions of WHMCS are candidates for any refinements. It is recommended that customers leverage this service and keep their WHMCS installation up to date, and optimally, tracking a version that is currently under [[#Active Development | Active Development]].

=== Grandfathered LTS ===
The WHMCS Long-Term Support policy is effective May 1st, 2013. Particular versions have been grandfathered, namely 4.5, 5.0, and 5.1.

=== WHMCS Version & LTS Schedule ===
This chart is updated upon each major or minor release of WHMCS.

{| class="table table-striped"
! WHMCS Version
! Approximate Publication Date
! Targeted End-Of-Life Date
! Current Status
|-
| 8.6 || September 2022 || October 31st, 2023 || style="background: #33ffda; font-weight: bold;" | <span style="color:#333">Release Candidate</span>
|-
| 8.5 || April 2022 || May 31st, 2023 || style="background: #81D153; font-weight: bold;" | [[#Active Development | <span style="color:#333">Active Development</span>]]
|-
| 8.4 || December 2021 || January 31st, 2023 || style="background: #FFCCCC; font-weight: bold;" | LTS
|-
| 8.3 || September 2021 || October 31st, 2022 || style="background: #FFCCCC; font-weight: bold;" | LTS
|-
| 8.2 || May 2021 || June 30th, 2022 || style="background: #84807F; font-weight: bold;" | EOL
|-
| 8.1 || November 2020 || December 31st, 2021 || style="background: #84807F; font-weight: bold;" | EOL
|-
| 8.0 || August 2020 || September 30th, 2021 || style="background: #84807F; font-weight: bold;" | EOL
|-
| 7.10 || April 2020|| April 30th, 2021 || style="background: #84807F; font-weight: bold;" | EOL
|-
| 7.9 || November 2019 || December 31st, 2020 || style="background: #84807F; font-weight: bold;" | EOL
|-
| 7.8 || August 2019 || August 31st, 2020 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.7 || January 2019 || January 31st, 2020 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.6 || June 2018 || July 31st, 2019 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.5 || April 2018 || April 30th, 2019 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.4 || November 2017 || November 30th, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.3 || October 2017 || October 31st, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.2 || May 2017 || May 31st, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.1 || December 2016 || December 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.0 || October 2016 || October 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.3 || March 2016 || March 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.2 || December 2015 || December 31, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.1 || September 2015 || September 30, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.0 || July 2015 || July 31, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.3 || September 2013 || October 31, 2015 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.2 || March 2013 || March 31, 2014 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.1 || July 2012 || November 30, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.0 || December 2011 || July 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.5 || April 2011 || June 30, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.4 || December 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.3 || September 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.2 || March 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.1 || November 2009 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.0 || May 2009 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 1.x-3.x || -- || -- || style="background: #84807F; font-weight: bold; font-style: bold;color: black" | EOL
|}

''Last Updated: {{REVISIONDAY2: Long_Term_Support }}/{{REVISIONMONTH: Long_Term_Support }}/{{REVISIONYEAR: Long_Term_Support }}

CPanel/WHM

2022-08-10T19:19:11Z

Chance: /* API Token Permissions */

== About this Module ==

The cPanel module allows you to add and manage cPanel & WHM servers in WHMCS.
{{Provisioning_Module
| changepackage = Yes
| changepw = Yes
| usageupdates = Yes
| clientarealink = Yes
| port = 2086 & 2087}}

== Adding a cPanel & WHM Server ==

To set up a cPanel & WHM server in WHMCS:

# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
# Click '''Add New Server'''.
# Select ''cPanel'' from the menu.
# Enter the hostname or IP address.
# Enter the username and password or API token.
#* For the username and password, use your WHM account credentials.
#* You can generate an API token in WHM at '''Development >> Manage API Tokens'''.
# Click '''Test Connection'''.
# Enter the desired additional server details.
# Examine the displayed default port. If your server uses a different port, check '''Override with Custom Port''' and enter the correct port. For more information, see [[Server Port Overrides]].
# Click '''Save Changes'''.
# If this is the only cPanel & WHM server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.

<div class="docs-alert-warning">
If [[Two-Factor Authentication]] is enabled on your cPanel & WHM server, you must disable it for API requests. See below.
</div>

=== Creating a cPanel Product ===

<html><a href="https://www.youtube.com/watch?v=0lqzsTSUGw0&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature.</em><span> <img src="https://assets.whmcs.com/icons/youtube.png"> </span></a></html>

You can create a product that provisions accounts on your cPanel & WHM server at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products_and_Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.

You can then create a product using an existing WHM package or by defining custom options. You can also choose to create a reseller hosting product.

[[File:83WPInstallSetting.png|thumb|cPanel Module Settings]][[File:cpanel3.png|thumb|Adding a Package in WHM]]

===== Use an Existing WHM Package =====

<div class="docs-alert-success">
We introduced this feature in WHMCS 7.0.
</div>

To create a hosting product that uses an existing WHM package, use the following product configuration:

* For '''Product Type''', select ''Shared Hosting''.
* For '''WHM Package Name''', select the desired hosting plan.

===== Defining Custom Options =====

<div class="docs-alert-info">
To configure quotas on a per-account basis, you must have <tt>root</tt>-level access to the server.
</div>

[[File:Cpanel advanced.png|thumb|Advanced Mode]]

To create a hosting product with a custom package, use the following product configuration:

* For '''Product Type''', select ''Shared Hosting''.
* Do '''not''' select a package for '''WHM Package Name'''.
* After clicking '''Switch to Advanced Mode''' on the right side of the page, enter the desired values for each package setting. If you do not enter a value, the quota will be unlimited.

==== Creating a Reseller Package ====

[[File:cpanel4.png|thumb|Creating an ACL List]][[File:83WPResellerAccount.png|thumb|cPanel Reseller Module Settings]]

To create a hosting product for a reseller account, use the following product configuration:

* For '''Product Type''', select ''Reseller Hosting''.
* Do '''not''' select a package for '''WHM Package Name'''.
* After clicking '''Switch to Advanced Mode''' on the right side of the page, enter the desired values for each package setting.
** If you do not enter a value, the quota will be unlimited.
** For '''Reseller ACL List''', make certain to enter the name of an ACL that already exists in WHM. You can create one at '''Resellers >> [[https://docs.cpanel.net/whm/resellers/edit-reseller-nameservers-and-privileges/ Edit Reseller Nameservers and Privileges]]'''.
** Make certain to also configure:
*** '''Limit Reseller by Number'''
*** '''Limit Reseller by Usage'''
*** '''Reseller Disk Space'''
*** '''Reseller Bandwidth'''
*** '''Allow DS Overselling'''
*** '''Allow BW Overselling'''
*** '''Configure Nameservers'''
*** '''Reseller Ownership'''

Reseller usage limits and reporting are based on the behavior of reseller accounts in cPanel & WHM. The system will not aggregate use by resellers that the <tt>root</tt> user owns when making usage calculations.

===== Configuring Per-Account Billing =====

<div class="docs-alert-success">
We added this feature in WHMCS 7.9.
</div>

[[Usage_Billing|Usage billing]] allows you to bill resellers for the number of cPanel accounts they provision. You can choose whether to include a certain number of cPanel accounts in the price and only charge for exceeding a certain limit, offer tiered pricing, or charge for every cPanel account resellers create.

When a client orders a product, WHMCS will track the number of cPanel accounts that the reseller creates. On the service's next due date, the system records the current number of cPanel accounts and adds any additional cost to the service's renewal invoice.

<div class="docs-alert-info">
We recommend only using this for products with a monthly billing cycle.
</div>

[[File:Cpanel usage billing.png|thumb|Enable Usage Billing]]

To configure this:

# In the '''Metric Billing''' section of the '''Module Settings''' tab, toggle '''Sub-Accounts''' to '''On'''.<div class="docs-alert-info">This metric is separate from the cPanel Subaccount feature.</div>
# Click '''Configure Pricing'''.
# Enter the number of Sub-Accounts that you want to include in the base product in '''Quality Included'''.
# Choose a pricing scheme.
# Enter the pricing information for the chosen scheme. For help, see [https://help.whmcs.com/m/setup/l/1185956-billing-resellers-per-domain these pricing examples].
# Click '''Save'''.

=== WHMCS Connect ===

WHMCS Connect allows you and your administrators to quickly and easily access the control panels of all the servers configured in your WHMCS installation that support Single Sign-On, enabling you and your staff to administer and make changes without ever needing to re-authenticate.

For information on the benefits of WHMCS Connect and how to configure this functionality [[WHMCS_Connect|refer to this page]].

== Log in to cPanel ==

The '''Log in to cPanel''' link in the Client Area and the '''Log in to Control Panel''' link in the [[Admin Area]] use the server hostname if it is available. If not, they use the IP address. The use of <tt>http</tt> or <tt>https</tt> login links depends on the '''Secure''' setting in the server configuration.

The link in the Admin Area uses the <tt>xfercpanel</tt> function. When the system prompts you, enter your WHM login details ('''not''' the client's cPanel details) to log in to the client's account with reseller privileges.

== API Token Permissions ==

API tokens in cPanel & WHM allow you to restrict the actions that an API token can perform. To do this, you must grant the following permissions in WHM at '''Development >> Manage API Tokens'''.

<table class="table table-striped">
<tr>
<td>basic-whm-functions</td>
<td>basic-system-info</td>
<td>cpanel-api</td>
</tr>
<tr>
<td>create-acct</td>
<td>create-user-session</td>
<td>suspend-acct</td>
</tr>
<tr>
<td>upgrade-account</td>
<td>kill-acct</td>
<td>passwd</td>
</tr>
<tr>
<td>acct-summary</td>
<td>list-accts</td>
<td>show-bandwidth</td>
</tr>
<tr>
<td>cpanel-integration</td>
<td>list-pkgs</td>
<td>ns-config</td>
</tr>
<tr>
<td>edit-mx</td>
<td>manage-api-tokens</td>
<td>ssl-gencrt</td>
</tr>
</table>

=== root API Tokens ===

When creating an API token for the <tt>root</tt> user, you must also include the <tt>viewglobalpackages</tt> permission.

=== Configurable Package Addons ===

When using the Configurable Package Addon, you must also enable the <tt>edit-account</tt> permission.

=== Reseller Products ===

For reseller products, the "Everything" permission needs to be enabled as the reseller API functions on a cPanel & WHM server require root access to work.

== Keep DNS Zone on Termination ==

When terminating a cPanel & WHM account via the WHMCS Admin Area, you can select '''Keep DNS Zone''' in order to retain the associated DNS zone record.

You may wish to use this, for example, when performing an account migration with DNS forwarding.

<div class="docs-alert-warning">
You cannot recreate a new account on the server using the same domain while the DNS zone exists. You must delete it before you can successfully provision a new account.
</div>

== Disable Two-Factor Authentication (2FA) for the cPanel API ==

For the cPanel module to function when 2FA is enabled for your account, you must ensure that the 2FA requirement is disabled for API requests.

To do this:

# Log in to WHM as the <tt>root</tt> user.
# Go to '''Security Center > Configure Security Policies'''.
# Uncheck '''API requests'''.
# Click '''Save'''.

== Add-On Features ==

In WHMCS 8.2 and later, in addition to WHMCS's existing product addon functionality (now an '''Independent Product'''), you can create an '''Add-On Feature'''. These addons let you sell module-specific features like WordPress® Toolkit offerings available through both cPanel and Plesk.

For more information and steps to create an addon, see [[Product Addons]].

== Troubleshooting ==

=== Access Denied/Permission Denied ===

An Access Denied error indicates that the cPanel server denied WHMCS access to perform the requested action (eg. create or modify the account).

To investigate and resolve this issue:

# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
# Check whether the server settings, including the username and API token, are valid.
# Check whether the API credentials for the server have the required permissions to perform the action.
# Go to the client's profile and choose the '''Products/Services''' tab.
# Check to ensure that the '''Username''' and '''Server''' values match the account records in cPanel & WHM.
# Check whether the user has the required permissions to manage the cPanel hosting account.

<div class="docs-alert-success">
Click '''Test Connection''' to confirm that the account has access.
</div>

=== You do not have permission to use Selected Package ===

If you receive this error when trying to create an account, correct the entered package name.

To do this:

# Go to the '''Module Settings''' tab for the relevant product at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services'''.
# Make certain that the set package name matches the name exactly as it appears in WHM. This should use the <tt>username_packagename</tt> format.

=== Package Not Allowed or Exceeded Resource/Account Allocation ===

This error indicates that you only have reseller access to your server and are trying to create an account without a valid package name. Ensure that the WHM package name in the WHMCS product configuration and in WHM match exactly.

=== Resellers are not permitted to create subdomains of the server's main domain ===

This indicates that the domain is missing. Ensure that you have entered a domain name for the product.

You may need to enable '''Require Domain''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Product/Services'''.

=== Unable to validate setting for language: english ===

Some cPanel & WHM API changes are not backwards compatible. You must use WHMCS 4.2 or later in order to use this module.

=== Sorry, that username is reserved ===

cPanel & WHM does not allow usernames to contain several words, including <tt>test</tt>. Change the hosting account's username and run the '''Create''' command again.

=== Sorry, a group for that username already exists ===

An account with this username already exists on the server. This error can occur on shared servers even when you do not have an account with this username under your reseller account another reseller on the same server may be using it already. Change the hosting account's username and run the '''Create''' command again.

=== Login Failed ===

There are two possible causes for this error:

* The login details under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers''' are incorrect. Make certain that you are using either the username and API key or the username and password combination and that the login details are correct.
* The brute force protection settings are preventing WHMCS from creating, suspending, or terminating accounts via the cPanel API. Adjust these settings in WHM.

=== No user name supplied: "username" is a required argument ===

This indicates that the username under the client's '''Products/Services''' tab is empty.

Enter a username, save the changes, and then run the '''Create''' command again.

When you do this, also ensure that '''Require Domains''' is checked at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.

=== Action Failed Unable to auto-login. Please contact support ===

This indicates that the username under the client's '''Products/Services''' tab is empty.

Enter a username, save the changes, and then run the '''Create''' command again.

When you do this, also ensure that '''Require Domains''' is checked at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.

=== WHM Username is missing for the selected server===

This error indicates a server balancing misconfiguration (for example, you have not selected a server to use when creating the account).

For help, see [[Provisioning_Issues#Server_Command_Error_-_Curl_Error_-_Couldn.27t_resolve_host_.286.29|Provisioning Issues]].

=== An Unknown Error Occurred after updating to cPanel 74 ===

If, after updating to cPanel & WHM version 74, every module command results in a "An unknown error occurred" message, check the [[Troubleshooting_Module_Problems|module debug log]]. This may indicate that the server is returning a 404 error page.

This is due to the [https://blog.cpanel.com/march-2017-development-update deprecation of the XML output from WHM API 1 and WHM API 0]. To resolve this, [[Updating|update]] to WHMCS 7.3 or higher.

=== WHM Package not shown in Module dropdown list when editing product ===

The WHM API only returns packages that you can provision for that reseller's WHM account. Packages may not display in this list if their use would exceed the reseller's quotas on their WHM account.

To confirm this:

# [[File:Whm_packages_list_limits.png|thumb|cPanel Package Limits]]In WHM, go to '''Account Functions » Create a New Account'''.
# Select the desired package from '''Choose a Package'''. The package name will display with the message '''Cannot use due to limits'''.

You can use two methods to resolve this issue:

* Ensure that the WHM account has sufficient resources to provision the desired WHM package.
* Enable [https://docs.cpanel.net/knowledge-base/cpanel-product/overselling/|overselling] on the reseller account. This requires <tt>root</tt> access.

=== Product attribute Package Name "Package Name" not found on server ===

There are two possible causes of this error:
* The package name in WHMCS does not exactly match [[#Package Not Allowed or Exceeded Resource/Account Allocation|the package name in WHM]].
* The server lacks [[#WHM Package not shown in Module dropdown list when editing product|sufficient resources to create the package]].

{{modules}}

IonCube Loader Version Matrix

2021-02-10T18:19:11Z

Chance:

{| class="table table-striped"
|+ <span style="font-weight: bold;">[[System Environment Guide|Minimum]] IonCube Loader Version by WHMCS Version</span>
! WHMCS Version (Status)
! PHP v5.2
! PHP v5.3
! PHP v5.4
! PHP v5.6
! PHP v7.0
! PHP v7.1
! PHP v7.2
! PHP v7.3
! PHP v7.4
|-
| v6.3 (EOL) || style="font-weight: bold;" | 4.6.1 || style="font-weight: bold;" | 4.6.1 || style="font-weight: bold;" | 4.6.1 || style="font-weight: bold;" | 4.6.1 || -- || -- || -- || -- || --
|-
| v7.0 (EOL) || -- || -- || -- || style="font-weight: bold;" | 5.0.21 || style="font-weight: bold;" | 6.0.2 || -- || -- || -- || --
|-
| v7.1 (EOL) || -- || -- || -- || style="font-weight: bold;" | 5.0.21 || style="font-weight: bold;" | 6.0.2 || -- || -- || -- || --
|-
| v7.2 (EOL) || -- || -- || -- || style="font-weight: bold;" | 5.0.21 || style="font-weight: bold;" | 6.0.2 || -- || -- || -- || --
|-
| v7.3 (EOL) || -- || -- || -- || style="font-weight: bold;" | 5.0.21 || style="font-weight: bold;" | 6.0.2 || -- || -- || -- || --
|-
| v7.4 (EOL) || -- || -- || -- || style="font-weight: bold;" | 5.0.21 || style="font-weight: bold;" | 6.0.2 || -- || -- || -- || --
|-
| v7.5 (EOL) || -- || -- || -- || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.2.0 || -- || --
|-
| v7.6 (EOL) || -- || -- || -- || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1|| --
|-
| v7.7 (EOL) || -- || -- || -- || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1|| --
|-
| v7.8 (EOL) || -- || -- || -- || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1|| --
|-
| v7.9 (EOL) || -- || -- || -- || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1|| --
|-
| v7.10 (LTS) || -- || -- || -- || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.1.0 || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1|| --
|-
| v8.0 (LTS) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3
|-
| v8.1 (Active) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3
|}

PHP Version Support Matrix

2021-02-10T18:18:20Z

Chance:

{| class="table table-striped"
|+ <span style="font-weight: bold; font-size">PHP Version Support by WHMCS Version</span>
! WHMCS Version (Status)
! PHP v5.2
! PHP v5.3
! PHP v5.4
! PHP v5.6
! PHP v7.0
! PHP v7.1
! PHP v7.2
! PHP v7.3
! PHP v7.4
|-
| v6.3 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N || N|| N ||N
|-
| v7.0 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N|| N||N
|-
| v7.1 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N|| N||N
|-
| v7.2 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N|| N||N
|-
| v7.3 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N|| N||N
|-
| v7.4 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N|| N||N
|-
| v7.5 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N||N
|-
| v7.6 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y ||N
|-
| v7.7 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y ||N
|-
| v7.8 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y ||N
|-
| v7.9 (EOL) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y ||N
|-
| v7.10 (LTS) || N || N || N ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y ||N
|-
| v8.0 (LTS) || N || N || N ||N ||N ||N ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|-
| v8.1 (Active) || N || N || N ||N ||N ||N ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|}

MySQL Version Support Matrix

2021-02-10T18:17:36Z

Chance:

{| class="table table-striped"
|+ <span style="font-weight: bold; font-size">MySQL Version Support by WHMCS Version</span>
! WHMCS Version (Status)
! MySQL v5.2
! MySQL v5.3
! MySQL v5.4
! MySQL v5.5
! MySQL v5.6
! MySQL v5.7
! MySQL v8.0
|-
| v6.3 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y || N || N
|-
| v7.0 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N
|-
| v7.1 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N
|-
| v7.2 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N || N
|-
| v7.3 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N
|-
| v7.4 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N
|-
| v7.5 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N
|-
| v7.6 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || N
|-
| v7.7 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|-
| v7.8 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|-
| v7.9 (EOL) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|-
| v7.10 (LTS) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|-
| v8.0 (LTS) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|-
| v8.1 (Active) ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y ||style="background: #81D153; font-weight: bold;" | Y || style="background: #81D153; font-weight: bold;" | Y
|}

Long Term Support

2021-01-14T19:26:27Z

Chance: /* WHMCS Version & LTS Schedule */

== WHMCS Long-Term Support ==

Product enhancements, bug fixes and security fixes for published versions of WHMCS are common; WHMCS is constantly being refined to ensure a safe and robust experience. However, it is impractical for customers to always track the latest product refinements at the same pace as our Development Team. And for that reason, WHMCS has implemented a Long-Term Support Policy for WHMCS.

=== Overview ===
The WHMCS Long-Term Support Policy provides customers with a clear understanding of our commitment to supporting the software they have purchased a license for and installed on their systems.

WHMCS will provide periodic maintenance releases for major and minor versions of WHMCS as part of the normal WHMCS Release Process. This is called [[#Active Development | Active Development]]. Versions of WHMCS that are not under Active Development will not receive maintenance releases, however, they are candidates for Targeted Critical and Security Releases. WHMCS will only provide Targeted Releases for candidates that have not reached their [[#Defining End Of Life | End Of Life]].

Please refer to the [[#WHMCS Version & LTS Schedule|WHMCS Version and LTS Schedule]] to see what versions of WHMCS are currently covered by Long-Term Support or under Active Development.

=== Provisions of Long-Term Support ===
Once a version of WHMCS is no longer being actively developed it will receive Long-Term Support (LTS) from our Development and Security Teams. LTS is a finite period which expires on a specific date known as End Of Life (EOL). Each minor version has it's own EOL date.

Product versions that are in LTS are provided Targeted Critical and Security Releases.

Once a version has moved from Active Development to LTS it will not receive product enhancements or maintenance fixes unless they are deemed critical to the viability of a Targeted Critical or Security Release, and therefore delivered as part of LTS. If you require product enhancements or maintenance fixes, we suggest updating to a product version that is being actively developed.

=== Active Development ===
A product version that is under Active Development is in the process of being refined. Therefore, subsequent revisions are likely to be released until a new minor version is published. Revision releases can include bug fixes, security enhancements, minor optimizations, third-party updates, as well as Important or Critical updates.

At any given moment in time, there will likely be only one actively developed version of WHMCS available; it will be the latest version available for our site. However, to ensure a smooth transition from one major or minor version to the next, WHMCS may extend Active Development of the previously published version. These overlaps between product versions is usually quite small, on the order of a few weeks at most.

Please refer to [[#WHMCS Version & LTS Schedule|WHMCS Version and LTS Schedule]] to know if your version is currently under Active Development.

=== Defining End Of Life ===
A core attribute of the Long-Term Support Policy is defining a given version's End Of Life (EOL) date. The EOL date is established upon the publication of a new minor or major release and typically is set one year into the future.

For example if version 1.0.0 is published January 31, 2012, then it will have an EOL of January 1st 2013 because it is a major release. If 1.1.0 is published on May 1st, 2012, it will have an EOL of May 1st 2013 because it is a minor release. If 1.1.1 is published on May 15th 2012 it will have an EOL of May 1st 2013 because it is a maintenance release to a previous minor release. Likewise, if 1.1.5 is published on July 24th 2012 it will have an EOL of May 1st 2013 because it is a maintenance release to a previous minor release.

=== After End Of Life ===
Once a version's EOL date has passed, no further releases or updates will be provided, regardless of the observed deficiency in that version.

Products that have reached EOL are not available for download from WHMCS.

As noted below in [[#Licensing & Services | Licensing & Services]], the product will continue to function even after the EOL date has passed. The use of the software is not tied to LTS or EOL, but the active/inactive state of your license.

=== Licensing & Services ===
WHMCS has historically offered with two types of licenses: Monthly and Owned. Whilst all new sales are of the Monthly type, this document also describes how the policy applies to grandfathered Owned licenses. Each license type is bundled with [[#Help Desk Support | help desk support]] and access to [[#Software Update Service | software updates]] when initially purchased.

A Monthly license always has access to these two services. An Owned license has access to these two services for one year. After one year, an Owned license holder can purchase an additional year of these two services as an addon.

An Owned license validates use of the software indefinitely, even after the term of help desk support and access to software updates expires. A Monthly license validates use of the software, help desk support, and access to software updates in one month durations. The active status of your license governs the functional state of your WHMCS installation, not the development status (Active Development/LTS/EOL) of the deployed product version.

==== Help Desk Support ====
The help desk support service allows customers to open tickets with our help desk. These tickets are managed by our Technical Analysts. Our Analysts work with customers to resolve a broad range of issues from configuration to identifying deficiency within a given version of WHMCS. With this service, customers have access to Analysts regardless of which version of the product they are using, even if that version has reached its End Of Life.

It's important to remember, however, that support provided by this service, or deficiencies identified by our Analysts, does not imply future refinements for versions. The [[#WHMCS Version & LTS Schedule|LTS schedule]], along with the severity of the identified issue, will determine what versions of WHMCS are candidates for any future refines.

==== Software Update Service ====
The software update service allows customers access to the latest versions of WHMCS. The service does not imply continued development, maintenance, or critical fixes for any given version of WHMCS. The [[#WHMCS Version & LTS Schedule|LTS schedule]] will determine what versions of WHMCS are candidates for any refinements. It is recommended that customers leverage this service and keep their WHMCS installation up to date, and optimally, tracking a version that is currently under [[#Active Development | Active Development]].

=== Grandfathered LTS ===
The WHMCS Long-Term Support policy is effective May 1st, 2013. Particular versions have been grandfathered, namely 4.5, 5.0, and 5.1.

=== WHMCS Version & LTS Schedule ===
This chart is updated upon each major or minor release of WHMCS.

{| class="table table-striped"
! WHMCS Version
! Approximate Publication Date
! Targeted End-Of-Life Date
! Current Status

|-
| 8.1 || November 2020 || December 31st, 2021 || style="background: #81D153; font-weight: bold;" | [[#Active Development | <span style="color:#333">Active Development</span>]]
|-
| 8.0 || August 2020 || September 30th, 2021 || style="background: #FFCCCC; font-weight: bold;" | LTS
|-
| 7.10 || April 2020|| April 30th, 2021 || style="background: #FFCCCC; font-weight: bold;" | LTS
|-
| 7.9 || November 2019 || December 31st, 2020 || style="background: #84807F; font-weight: bold;" | EOL
|-
| 7.8 || August 2019 || August 31st, 2020 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.7 || January 2019 || January 31st, 2020 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.6 || June 2018 || July 31st, 2019 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.5 || April 2018 || April 30th, 2019 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.4 || November 2017 || November 30th, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.3 || October 2017 || October 31st, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.2 || May 2017 || May 31st, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.1 || December 2016 || December 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.0 || October 2016 || October 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.3 || March 2016 || March 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.2 || December 2015 || December 31, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.1 || September 2015 || September 30, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.0 || July 2015 || July 31, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.3 || September 2013 || October 31, 2015 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.2 || March 2013 || March 31, 2014 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.1 || July 2012 || November 30, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.0 || December 2011 || July 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.5 || April 2011 || June 30, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.4 || December 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.3 || September 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.2 || March 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.1 || November 2009 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.0 || May 2009 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 1.x-3.x || -- || -- || style="background: #84807F; font-weight: bold; font-style: bold;color: black" | EOL
|}

''Last Updated: 29th December 2020''

Long Term Support

2021-01-14T19:26:08Z

Chance: /* WHMCS Version & LTS Schedule */

== WHMCS Long-Term Support ==

Product enhancements, bug fixes and security fixes for published versions of WHMCS are common; WHMCS is constantly being refined to ensure a safe and robust experience. However, it is impractical for customers to always track the latest product refinements at the same pace as our Development Team. And for that reason, WHMCS has implemented a Long-Term Support Policy for WHMCS.

=== Overview ===
The WHMCS Long-Term Support Policy provides customers with a clear understanding of our commitment to supporting the software they have purchased a license for and installed on their systems.

WHMCS will provide periodic maintenance releases for major and minor versions of WHMCS as part of the normal WHMCS Release Process. This is called [[#Active Development | Active Development]]. Versions of WHMCS that are not under Active Development will not receive maintenance releases, however, they are candidates for Targeted Critical and Security Releases. WHMCS will only provide Targeted Releases for candidates that have not reached their [[#Defining End Of Life | End Of Life]].

Please refer to the [[#WHMCS Version & LTS Schedule|WHMCS Version and LTS Schedule]] to see what versions of WHMCS are currently covered by Long-Term Support or under Active Development.

=== Provisions of Long-Term Support ===
Once a version of WHMCS is no longer being actively developed it will receive Long-Term Support (LTS) from our Development and Security Teams. LTS is a finite period which expires on a specific date known as End Of Life (EOL). Each minor version has it's own EOL date.

Product versions that are in LTS are provided Targeted Critical and Security Releases.

Once a version has moved from Active Development to LTS it will not receive product enhancements or maintenance fixes unless they are deemed critical to the viability of a Targeted Critical or Security Release, and therefore delivered as part of LTS. If you require product enhancements or maintenance fixes, we suggest updating to a product version that is being actively developed.

=== Active Development ===
A product version that is under Active Development is in the process of being refined. Therefore, subsequent revisions are likely to be released until a new minor version is published. Revision releases can include bug fixes, security enhancements, minor optimizations, third-party updates, as well as Important or Critical updates.

At any given moment in time, there will likely be only one actively developed version of WHMCS available; it will be the latest version available for our site. However, to ensure a smooth transition from one major or minor version to the next, WHMCS may extend Active Development of the previously published version. These overlaps between product versions is usually quite small, on the order of a few weeks at most.

Please refer to [[#WHMCS Version & LTS Schedule|WHMCS Version and LTS Schedule]] to know if your version is currently under Active Development.

=== Defining End Of Life ===
A core attribute of the Long-Term Support Policy is defining a given version's End Of Life (EOL) date. The EOL date is established upon the publication of a new minor or major release and typically is set one year into the future.

For example if version 1.0.0 is published January 31, 2012, then it will have an EOL of January 1st 2013 because it is a major release. If 1.1.0 is published on May 1st, 2012, it will have an EOL of May 1st 2013 because it is a minor release. If 1.1.1 is published on May 15th 2012 it will have an EOL of May 1st 2013 because it is a maintenance release to a previous minor release. Likewise, if 1.1.5 is published on July 24th 2012 it will have an EOL of May 1st 2013 because it is a maintenance release to a previous minor release.

=== After End Of Life ===
Once a version's EOL date has passed, no further releases or updates will be provided, regardless of the observed deficiency in that version.

Products that have reached EOL are not available for download from WHMCS.

As noted below in [[#Licensing & Services | Licensing & Services]], the product will continue to function even after the EOL date has passed. The use of the software is not tied to LTS or EOL, but the active/inactive state of your license.

=== Licensing & Services ===
WHMCS has historically offered with two types of licenses: Monthly and Owned. Whilst all new sales are of the Monthly type, this document also describes how the policy applies to grandfathered Owned licenses. Each license type is bundled with [[#Help Desk Support | help desk support]] and access to [[#Software Update Service | software updates]] when initially purchased.

A Monthly license always has access to these two services. An Owned license has access to these two services for one year. After one year, an Owned license holder can purchase an additional year of these two services as an addon.

An Owned license validates use of the software indefinitely, even after the term of help desk support and access to software updates expires. A Monthly license validates use of the software, help desk support, and access to software updates in one month durations. The active status of your license governs the functional state of your WHMCS installation, not the development status (Active Development/LTS/EOL) of the deployed product version.

==== Help Desk Support ====
The help desk support service allows customers to open tickets with our help desk. These tickets are managed by our Technical Analysts. Our Analysts work with customers to resolve a broad range of issues from configuration to identifying deficiency within a given version of WHMCS. With this service, customers have access to Analysts regardless of which version of the product they are using, even if that version has reached its End Of Life.

It's important to remember, however, that support provided by this service, or deficiencies identified by our Analysts, does not imply future refinements for versions. The [[#WHMCS Version & LTS Schedule|LTS schedule]], along with the severity of the identified issue, will determine what versions of WHMCS are candidates for any future refines.

==== Software Update Service ====
The software update service allows customers access to the latest versions of WHMCS. The service does not imply continued development, maintenance, or critical fixes for any given version of WHMCS. The [[#WHMCS Version & LTS Schedule|LTS schedule]] will determine what versions of WHMCS are candidates for any refinements. It is recommended that customers leverage this service and keep their WHMCS installation up to date, and optimally, tracking a version that is currently under [[#Active Development | Active Development]].

=== Grandfathered LTS ===
The WHMCS Long-Term Support policy is effective May 1st, 2013. Particular versions have been grandfathered, namely 4.5, 5.0, and 5.1.

=== WHMCS Version & LTS Schedule ===
This chart is updated upon each major or minor release of WHMCS.

{| class="table table-striped"
! WHMCS Version
! Approximate Publication Date
! Targeted End-Of-Life Date
! Current Status

|-
| 8.1 || November 2020 || December 31st, 2021 || style="background: #81D153; font-weight: bold;" | [[#Active Development | <span style="color:#333">Active Development</span>]]
|-
| 8.0 || August 2020 || September 30th, 2021 || style="background: #FFCCCC; font-weight: bold;" | LTS
|-
| 7.10 || April 2020|| April 30th, 2021 || style="background: #FFCCCC; font-weight: bold;" | LTS
|-
| 7.9 || November 2019 || December 31st, 2020 || style="background: #FFCCCC; font-weight: bold;" | EOL
|-
| 7.8 || August 2019 || August 31st, 2020 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.7 || January 2019 || January 31st, 2020 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.6 || June 2018 || July 31st, 2019 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.5 || April 2018 || April 30th, 2019 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.4 || November 2017 || November 30th, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.3 || October 2017 || October 31st, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.2 || May 2017 || May 31st, 2018 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.1 || December 2016 || December 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 7.0 || October 2016 || October 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.3 || March 2016 || March 31, 2017 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.2 || December 2015 || December 31, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.1 || September 2015 || September 30, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 6.0 || July 2015 || July 31, 2016 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.3 || September 2013 || October 31, 2015 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.2 || March 2013 || March 31, 2014 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.1 || July 2012 || November 30, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 5.0 || December 2011 || July 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.5 || April 2011 || June 30, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.4 || December 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.3 || September 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.2 || March 2010 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.1 || November 2009 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 4.0 || May 2009 || May 31, 2013 || style="background: #84807F; font-weight: bold;color: black" | EOL
|-
| 1.x-3.x || -- || -- || style="background: #84807F; font-weight: bold; font-style: bold;color: black" | EOL
|}

''Last Updated: 29th December 2020''

Version 8.0.0 Release Notes

2020-10-06T23:51:59Z

Chance: /* Standard Cart Order Form */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.0<br />
Release Type: General Availability<br />
Release Date: 28th Sep 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>8.0.0</td><td>Beta 1</td><td>4th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Beta 2 (Internal Build)</td><td>N/A</td></tr>
<tr><td>8.0.0</td><td>Beta 3</td><td>11th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 1</td><td>27th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 2</td><td>4th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 3</td><td>18th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>General Availability 1</td><td>28th Sep 2020</td></tr>
<tr><td>8.0.1</td><td>Maintenance</td><td>2nd Oct 2020</td></tr>
<tr><td>8.0.2</td><td>Maintenance</td><td>6th Oct 2020</td></tr>
</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduces support for PHP 7.4. Earlier versions of WHMCS do not support PHP 7.4.

<div class="docs-alert-warning">You will only see the WHMCS 8.0 updates within the Automatic Updater if you are running on PHP 7.2 or later. If you are running PHP 7.1 or earlier, to update to WHMCS 8.0 via the Automatic Updater, you will first need to upgrade to PHP 7.2 or PHP 7.3, and then check for updates and perform the update.</div>

Once you are running WHMCS 8.0, you can upgrade to PHP 7.4.

[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic_Updater|Automatic Update]] utility.

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

===Updates from Beta 1===

If you upgraded to WHMCS v8.0 Beta 1, you may experience problems retrieving the latest version of the software via the Automatic Updater. If updating directly from v7.10.2 or earlier, this issue will not apply.

To use the Automatic Updater to update from WHMCS v8.0 Beta 1, you must first apply a hotfix. For more information, see [https://whmcs.community/topic/301579-v80-beta-1-hotfix-required-for-update-to-whmcs-v80-beta-3/ our forums].

== Release Notes ==

=== Users and Client Accounts ===
WHMCS now supports accounts and users in a new end-user login management system. Accounts own services for a given entity. A single user can then manage multiple accounts.

[[Users_And_Accounts|Learn more...]]

=== New Admin Area Look ===
Admin Area Blend theme enhancements bring an updated look and better performance to the Admin Area. We've also added improved support for mobile devices and tablets.

=== Mail Deliverability Providers ===
Admin users can now easily configure email sending from one of several new mail providers. Currently, this includes SparkPost, SendGrid, and Mailgun. Using them enhances your email deliverability and security.

[[Mail_Providers|Learn more...]]

=== Email Campaigns ===
The new '''Email Campaigns''' tool has replaced the '''Mass Mail Tool'''. The new features include scheduling and saving drafts of your email campaigns, and adding styling.

[[Email_Campaigns|Learn more...]]

=== Improved IDN Support ===
Sell a broader range of domain names with full International Domain Name support. Enom and ResellerClub support automatic IDN registration, and you'll benefit from robust IDN validation and usability improvements.

[[Domains_Tab|Learn more...]]

=== OAuth2 for SMTP ===
To facilitate moving away from password-based authentication, OAuth2 is now fully supported. Google is already available, and we plan to add more providers in the future.

[[Mail_Providers|Learn more...]]

=== Improved Currency Support ===
WHMCS now supports up to three decimal places in tax rates and currency values up to 99 trillion.

=== OX App Suite from Open-Xchange ===
MarketConnect now includes OX App Suite from Open-Xchange. OX App Suite provides an easy-to-use email and communications platform with many features and capabilities.

== Deprecation and Removal Notices ==

=== Removed Legacy PHP Support ===
Product support for the legacy PHP 5.6, 7.0, and 7.1 environments is removed. To install or upgrade, you must run PHP 7.2 or higher.

=== Removed PHP Extensions Requirement ===
The <tt>IMAP</tt> extension is no longer required.
The <tt>GD</tt> extension is no longer required for '''some''' features, but is still required for WHMCS as a whole.

=== Deprecated v4 Theme ===
The v4 theme for the Admin Area is deprecated. If no admin accounts currently use this theme, upgrading will '''delete''' it. If the theme is in use, it will remain available for selection. However, admins who are assigned to this theme will move to Blend when you upgrade.

=== Deprecated AutoAuth ===
AutoAuth was [[Version_7.10.0_Release_Notes#Other|announced]] as deprecated in WHMCS version 7.10, including an option to enable or disable the feature. When you upgrade, the feature is disabled regardless of its previous value. We will remove AutoAuth in WHMCS version 8.1.

=== Removed Boxes and Modern Templates ===
The ''Boxes'' and ''Modern'' templates have been removed.

If products or groups use one of these, upgrading selects a new template that emulates the deprecated template. The system assigns the new template to everything that previously used the deprecated template. Newly-created child templates are based on the ''Standard'' template.

This upgrade will not touch custom themes.

=== Removed Modules ===
We have removed the PayMate.au, PayMate.nz, GameCP, MediaCP, and Kayako LoginShare modules.

=== Removed Legacy Files ===
We have removed <tt>whois.php</tt> from the Client Area file set.
The <tt>pipe</tt> directory was deprecated and has been removed. Use <tt>crons/pipe.php</tt> instead.

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* abraham/twitteroauth: 0.7.4 to 1.1.0
* composer/composer: 1.0.3 to 1.10.6
* ezyang/htmlpurifier: 4.9.2 to 4.12.0
* filp/whoops: 2.1.8 to 2.7.2
* firebase/php-jwt: 3.0.0 to 5.2.0
* google/apiclient: v2.1.3 to 2.7.0
* google/auth: 0.9.0 to 1.11.0
* guzzlehttp/guzzle: 5.3.3 to 7.0.1
* illuminate/console: 5.2.37 to 7.12.0
* illuminate/container: 5.2.37 to 7.12.0
* illuminate/contracts: 5.2.45 to 7.12.0
* illuminate/database: 5.2.37 to 7.12.0
* illuminate/events: 5.2.37 to 7.12.0
* illuminate/support: 5.2.37 to 7.12.0
* illuminate/validation: 5.2.45 to 7.12.0
* knplabs/knp-menu: 2.1.1 to 3.1.1
* laminas/laminas-diactoros: Added 2.3.1
* laminas/laminas-httphandlerrunner: Added 1.2.0
* league/climate: 3.2.1 to 3.5.2
* league/flysystem: 1.0.45 to 1.0.67
* league/oauth2-client: added 2.5.0
* league/oauth2-google: added 3.0.3
* monolog/monolog: 1.18.2 to 2.0.2
* nikic/fast-route: 1.2.0 to 1.3.0
* php-imap/php-imap: 2.0.9 to 3.1.0
* phpmyadmin/sql-parser: 4.2.4 to 5.3.1
* phpmyadmin/phpmailer: 6.0.7 to 6.1.5
* phpseclib/mcrypt_compat: 1.0.5 to 1.0.11
* phpseclib/phpseclib: 2.0.10 to 2.0.27
* punic/punic: 1.6.3 to 3.5.1
* ramsey/uuid: 3.4.1 to 4.0.1
* react/promise: 2.5.1 to 2.8.0
* seld/jsonlint: 1.6.1 to 1.8.0
* seld/phar-utils: 1.0.1 to 1.1.0
* smarty/smarty: 3.1.33 to 3.1.36
* stripe/stripe-php: 6.43.1 to 7.34.0
* symfony/polyfill-ctype: Added 1.18.1
* symfony/polyfill-iconv: 1.2.0 to 1.18.1
* symfony/polyfill-intl-idn: Added 1.18.1
* symfony/polyfill-mbstring: 1.3.0 to 1.18.1
* symfony/polyfill-php72: Added 1.18.1
* symfony/polyfill-php73: Added 1.18.1
* tecnickcom/tcpdf: 6.2.26 to 6.3.5
* zbateson/stream-decorators: Added 1.0.3

== New Documentation ==
The following new documentation pages are available:
* [[Email Campaigns]]
* [[Mail Providers]]
* [[Configuring Mail Providers]]
* [[Users And Accounts]]
* [[Email Sending Issues]] (Updated)
* [[Sign-In Integrations]] (Updated)
* [[Product Groups]] (Updated)
* [[Products and Services]] (Updated)
* [https://developers.whmcs.com/mail-providers/ Mail Providers Developer Documentation]
* [https://developers.whmcs.com/domain-registrars/module-parameters/ Domain Registrars Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/getticket/ GetTicket Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/gettickets/ GetTickets Developer Documentation] (Updated)

== Template ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/templates-six/compare/v7.10.2-release.1...v8.0.2-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.10.2-release.1...v8.0.2-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.0.0_Beta_1|Version 8.0.0 Beta 1]]
* [[Changelog:WHMCS_V8.0.0_Beta_3|Version 8.0.0 Beta 3]]
* [[Changelog:WHMCS_V8.0.0_RC_1|Version 8.0.0 RC 1]]
* [[Changelog:WHMCS_V8.0.0_RC_2|Version 8.0.0 RC 2]]
* [[Changelog:WHMCS_V8.0.0_RC_3|Version 8.0.0 RC 3]]
* [[Changelog:WHMCS_V8.0.0_GA|Version 8.0.0 General Availability]]
* [[Changelog:WHMCS_V8.0.1|Version 8.0.1 Maintenance]]
* [[Changelog:WHMCS_V8.0.2|Version 8.0.2 Maintenance]]

Version 8.0.0 Release Notes

2020-10-06T23:46:32Z

Chance: /* Changelog */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.0<br />
Release Type: General Availability<br />
Release Date: 28th Sep 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>8.0.0</td><td>Beta 1</td><td>4th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Beta 2 (Internal Build)</td><td>N/A</td></tr>
<tr><td>8.0.0</td><td>Beta 3</td><td>11th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 1</td><td>27th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 2</td><td>4th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 3</td><td>18th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>General Availability 1</td><td>28th Sep 2020</td></tr>
<tr><td>8.0.1</td><td>Maintenance</td><td>2nd Oct 2020</td></tr>
<tr><td>8.0.2</td><td>Maintenance</td><td>6th Oct 2020</td></tr>
</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduces support for PHP 7.4. Earlier versions of WHMCS do not support PHP 7.4.

<div class="docs-alert-warning">You will only see the WHMCS 8.0 updates within the Automatic Updater if you are running on PHP 7.2 or later. If you are running PHP 7.1 or earlier, to update to WHMCS 8.0 via the Automatic Updater, you will first need to upgrade to PHP 7.2 or PHP 7.3, and then check for updates and perform the update.</div>

Once you are running WHMCS 8.0, you can upgrade to PHP 7.4.

[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic_Updater|Automatic Update]] utility.

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

===Updates from Beta 1===

If you upgraded to WHMCS v8.0 Beta 1, you may experience problems retrieving the latest version of the software via the Automatic Updater. If updating directly from v7.10.2 or earlier, this issue will not apply.

To use the Automatic Updater to update from WHMCS v8.0 Beta 1, you must first apply a hotfix. For more information, see [https://whmcs.community/topic/301579-v80-beta-1-hotfix-required-for-update-to-whmcs-v80-beta-3/ our forums].

== Release Notes ==

=== Users and Client Accounts ===
WHMCS now supports accounts and users in a new end-user login management system. Accounts own services for a given entity. A single user can then manage multiple accounts.

[[Users_And_Accounts|Learn more...]]

=== New Admin Area Look ===
Admin Area Blend theme enhancements bring an updated look and better performance to the Admin Area. We've also added improved support for mobile devices and tablets.

=== Mail Deliverability Providers ===
Admin users can now easily configure email sending from one of several new mail providers. Currently, this includes SparkPost, SendGrid, and Mailgun. Using them enhances your email deliverability and security.

[[Mail_Providers|Learn more...]]

=== Email Campaigns ===
The new '''Email Campaigns''' tool has replaced the '''Mass Mail Tool'''. The new features include scheduling and saving drafts of your email campaigns, and adding styling.

[[Email_Campaigns|Learn more...]]

=== Improved IDN Support ===
Sell a broader range of domain names with full International Domain Name support. Enom and ResellerClub support automatic IDN registration, and you'll benefit from robust IDN validation and usability improvements.

[[Domains_Tab|Learn more...]]

=== OAuth2 for SMTP ===
To facilitate moving away from password-based authentication, OAuth2 is now fully supported. Google is already available, and we plan to add more providers in the future.

[[Mail_Providers|Learn more...]]

=== Improved Currency Support ===
WHMCS now supports up to three decimal places in tax rates and currency values up to 99 trillion.

=== OX App Suite from Open-Xchange ===
MarketConnect now includes OX App Suite from Open-Xchange. OX App Suite provides an easy-to-use email and communications platform with many features and capabilities.

== Deprecation and Removal Notices ==

=== Removed Legacy PHP Support ===
Product support for the legacy PHP 5.6, 7.0, and 7.1 environments is removed. To install or upgrade, you must run PHP 7.2 or higher.

=== Removed PHP Extensions Requirement ===
The <tt>IMAP</tt> extension is no longer required.
The <tt>GD</tt> extension is no longer required for '''some''' features, but is still required for WHMCS as a whole.

=== Deprecated v4 Theme ===
The v4 theme for the Admin Area is deprecated. If no admin accounts currently use this theme, upgrading will '''delete''' it. If the theme is in use, it will remain available for selection. However, admins who are assigned to this theme will move to Blend when you upgrade.

=== Deprecated AutoAuth ===
AutoAuth was [[Version_7.10.0_Release_Notes#Other|announced]] as deprecated in WHMCS version 7.10, including an option to enable or disable the feature. When you upgrade, the feature is disabled regardless of its previous value. We will remove AutoAuth in WHMCS version 8.1.

=== Removed Boxes and Modern Templates ===
The ''Boxes'' and ''Modern'' templates have been removed.

If products or groups use one of these, upgrading selects a new template that emulates the deprecated template. The system assigns the new template to everything that previously used the deprecated template. Newly-created child templates are based on the ''Standard'' template.

This upgrade will not touch custom themes.

=== Removed Modules ===
We have removed the PayMate.au, PayMate.nz, GameCP, MediaCP, and Kayako LoginShare modules.

=== Removed Legacy Files ===
We have removed <tt>whois.php</tt> from the Client Area file set.
The <tt>pipe</tt> directory was deprecated and has been removed. Use <tt>crons/pipe.php</tt> instead.

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* abraham/twitteroauth: 0.7.4 to 1.1.0
* composer/composer: 1.0.3 to 1.10.6
* ezyang/htmlpurifier: 4.9.2 to 4.12.0
* filp/whoops: 2.1.8 to 2.7.2
* firebase/php-jwt: 3.0.0 to 5.2.0
* google/apiclient: v2.1.3 to 2.7.0
* google/auth: 0.9.0 to 1.11.0
* guzzlehttp/guzzle: 5.3.3 to 7.0.1
* illuminate/console: 5.2.37 to 7.12.0
* illuminate/container: 5.2.37 to 7.12.0
* illuminate/contracts: 5.2.45 to 7.12.0
* illuminate/database: 5.2.37 to 7.12.0
* illuminate/events: 5.2.37 to 7.12.0
* illuminate/support: 5.2.37 to 7.12.0
* illuminate/validation: 5.2.45 to 7.12.0
* knplabs/knp-menu: 2.1.1 to 3.1.1
* laminas/laminas-diactoros: Added 2.3.1
* laminas/laminas-httphandlerrunner: Added 1.2.0
* league/climate: 3.2.1 to 3.5.2
* league/flysystem: 1.0.45 to 1.0.67
* league/oauth2-client: added 2.5.0
* league/oauth2-google: added 3.0.3
* monolog/monolog: 1.18.2 to 2.0.2
* nikic/fast-route: 1.2.0 to 1.3.0
* php-imap/php-imap: 2.0.9 to 3.1.0
* phpmyadmin/sql-parser: 4.2.4 to 5.3.1
* phpmyadmin/phpmailer: 6.0.7 to 6.1.5
* phpseclib/mcrypt_compat: 1.0.5 to 1.0.11
* phpseclib/phpseclib: 2.0.10 to 2.0.27
* punic/punic: 1.6.3 to 3.5.1
* ramsey/uuid: 3.4.1 to 4.0.1
* react/promise: 2.5.1 to 2.8.0
* seld/jsonlint: 1.6.1 to 1.8.0
* seld/phar-utils: 1.0.1 to 1.1.0
* smarty/smarty: 3.1.33 to 3.1.36
* stripe/stripe-php: 6.43.1 to 7.34.0
* symfony/polyfill-ctype: Added 1.18.1
* symfony/polyfill-iconv: 1.2.0 to 1.18.1
* symfony/polyfill-intl-idn: Added 1.18.1
* symfony/polyfill-mbstring: 1.3.0 to 1.18.1
* symfony/polyfill-php72: Added 1.18.1
* symfony/polyfill-php73: Added 1.18.1
* tecnickcom/tcpdf: 6.2.26 to 6.3.5
* zbateson/stream-decorators: Added 1.0.3

== New Documentation ==
The following new documentation pages are available:
* [[Email Campaigns]]
* [[Mail Providers]]
* [[Configuring Mail Providers]]
* [[Users And Accounts]]
* [[Email Sending Issues]] (Updated)
* [[Sign-In Integrations]] (Updated)
* [[Product Groups]] (Updated)
* [[Products and Services]] (Updated)
* [https://developers.whmcs.com/mail-providers/ Mail Providers Developer Documentation]
* [https://developers.whmcs.com/domain-registrars/module-parameters/ Domain Registrars Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/getticket/ GetTicket Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/gettickets/ GetTickets Developer Documentation] (Updated)

== Template ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/templates-six/compare/v7.10.2-release.1...v8.0.1-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.10.2-release.1...v8.0.1-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.0.0_Beta_1|Version 8.0.0 Beta 1]]
* [[Changelog:WHMCS_V8.0.0_Beta_3|Version 8.0.0 Beta 3]]
* [[Changelog:WHMCS_V8.0.0_RC_1|Version 8.0.0 RC 1]]
* [[Changelog:WHMCS_V8.0.0_RC_2|Version 8.0.0 RC 2]]
* [[Changelog:WHMCS_V8.0.0_RC_3|Version 8.0.0 RC 3]]
* [[Changelog:WHMCS_V8.0.0_GA|Version 8.0.0 General Availability]]
* [[Changelog:WHMCS_V8.0.1|Version 8.0.1 Maintenance]]
* [[Changelog:WHMCS_V8.0.2|Version 8.0.2 Maintenance]]

Version 8.0.0 Release Notes

2020-10-06T23:45:54Z

Chance: /* Changelog */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.0<br />
Release Type: General Availability<br />
Release Date: 28th Sep 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>8.0.0</td><td>Beta 1</td><td>4th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Beta 2 (Internal Build)</td><td>N/A</td></tr>
<tr><td>8.0.0</td><td>Beta 3</td><td>11th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 1</td><td>27th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 2</td><td>4th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 3</td><td>18th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>General Availability 1</td><td>28th Sep 2020</td></tr>
<tr><td>8.0.1</td><td>Maintenance</td><td>2nd Oct 2020</td></tr>
<tr><td>8.0.2</td><td>Maintenance</td><td>6th Oct 2020</td></tr>
</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduces support for PHP 7.4. Earlier versions of WHMCS do not support PHP 7.4.

<div class="docs-alert-warning">You will only see the WHMCS 8.0 updates within the Automatic Updater if you are running on PHP 7.2 or later. If you are running PHP 7.1 or earlier, to update to WHMCS 8.0 via the Automatic Updater, you will first need to upgrade to PHP 7.2 or PHP 7.3, and then check for updates and perform the update.</div>

Once you are running WHMCS 8.0, you can upgrade to PHP 7.4.

[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic_Updater|Automatic Update]] utility.

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

===Updates from Beta 1===

If you upgraded to WHMCS v8.0 Beta 1, you may experience problems retrieving the latest version of the software via the Automatic Updater. If updating directly from v7.10.2 or earlier, this issue will not apply.

To use the Automatic Updater to update from WHMCS v8.0 Beta 1, you must first apply a hotfix. For more information, see [https://whmcs.community/topic/301579-v80-beta-1-hotfix-required-for-update-to-whmcs-v80-beta-3/ our forums].

== Release Notes ==

=== Users and Client Accounts ===
WHMCS now supports accounts and users in a new end-user login management system. Accounts own services for a given entity. A single user can then manage multiple accounts.

[[Users_And_Accounts|Learn more...]]

=== New Admin Area Look ===
Admin Area Blend theme enhancements bring an updated look and better performance to the Admin Area. We've also added improved support for mobile devices and tablets.

=== Mail Deliverability Providers ===
Admin users can now easily configure email sending from one of several new mail providers. Currently, this includes SparkPost, SendGrid, and Mailgun. Using them enhances your email deliverability and security.

[[Mail_Providers|Learn more...]]

=== Email Campaigns ===
The new '''Email Campaigns''' tool has replaced the '''Mass Mail Tool'''. The new features include scheduling and saving drafts of your email campaigns, and adding styling.

[[Email_Campaigns|Learn more...]]

=== Improved IDN Support ===
Sell a broader range of domain names with full International Domain Name support. Enom and ResellerClub support automatic IDN registration, and you'll benefit from robust IDN validation and usability improvements.

[[Domains_Tab|Learn more...]]

=== OAuth2 for SMTP ===
To facilitate moving away from password-based authentication, OAuth2 is now fully supported. Google is already available, and we plan to add more providers in the future.

[[Mail_Providers|Learn more...]]

=== Improved Currency Support ===
WHMCS now supports up to three decimal places in tax rates and currency values up to 99 trillion.

=== OX App Suite from Open-Xchange ===
MarketConnect now includes OX App Suite from Open-Xchange. OX App Suite provides an easy-to-use email and communications platform with many features and capabilities.

== Deprecation and Removal Notices ==

=== Removed Legacy PHP Support ===
Product support for the legacy PHP 5.6, 7.0, and 7.1 environments is removed. To install or upgrade, you must run PHP 7.2 or higher.

=== Removed PHP Extensions Requirement ===
The <tt>IMAP</tt> extension is no longer required.
The <tt>GD</tt> extension is no longer required for '''some''' features, but is still required for WHMCS as a whole.

=== Deprecated v4 Theme ===
The v4 theme for the Admin Area is deprecated. If no admin accounts currently use this theme, upgrading will '''delete''' it. If the theme is in use, it will remain available for selection. However, admins who are assigned to this theme will move to Blend when you upgrade.

=== Deprecated AutoAuth ===
AutoAuth was [[Version_7.10.0_Release_Notes#Other|announced]] as deprecated in WHMCS version 7.10, including an option to enable or disable the feature. When you upgrade, the feature is disabled regardless of its previous value. We will remove AutoAuth in WHMCS version 8.1.

=== Removed Boxes and Modern Templates ===
The ''Boxes'' and ''Modern'' templates have been removed.

If products or groups use one of these, upgrading selects a new template that emulates the deprecated template. The system assigns the new template to everything that previously used the deprecated template. Newly-created child templates are based on the ''Standard'' template.

This upgrade will not touch custom themes.

=== Removed Modules ===
We have removed the PayMate.au, PayMate.nz, GameCP, MediaCP, and Kayako LoginShare modules.

=== Removed Legacy Files ===
We have removed <tt>whois.php</tt> from the Client Area file set.
The <tt>pipe</tt> directory was deprecated and has been removed. Use <tt>crons/pipe.php</tt> instead.

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* abraham/twitteroauth: 0.7.4 to 1.1.0
* composer/composer: 1.0.3 to 1.10.6
* ezyang/htmlpurifier: 4.9.2 to 4.12.0
* filp/whoops: 2.1.8 to 2.7.2
* firebase/php-jwt: 3.0.0 to 5.2.0
* google/apiclient: v2.1.3 to 2.7.0
* google/auth: 0.9.0 to 1.11.0
* guzzlehttp/guzzle: 5.3.3 to 7.0.1
* illuminate/console: 5.2.37 to 7.12.0
* illuminate/container: 5.2.37 to 7.12.0
* illuminate/contracts: 5.2.45 to 7.12.0
* illuminate/database: 5.2.37 to 7.12.0
* illuminate/events: 5.2.37 to 7.12.0
* illuminate/support: 5.2.37 to 7.12.0
* illuminate/validation: 5.2.45 to 7.12.0
* knplabs/knp-menu: 2.1.1 to 3.1.1
* laminas/laminas-diactoros: Added 2.3.1
* laminas/laminas-httphandlerrunner: Added 1.2.0
* league/climate: 3.2.1 to 3.5.2
* league/flysystem: 1.0.45 to 1.0.67
* league/oauth2-client: added 2.5.0
* league/oauth2-google: added 3.0.3
* monolog/monolog: 1.18.2 to 2.0.2
* nikic/fast-route: 1.2.0 to 1.3.0
* php-imap/php-imap: 2.0.9 to 3.1.0
* phpmyadmin/sql-parser: 4.2.4 to 5.3.1
* phpmyadmin/phpmailer: 6.0.7 to 6.1.5
* phpseclib/mcrypt_compat: 1.0.5 to 1.0.11
* phpseclib/phpseclib: 2.0.10 to 2.0.27
* punic/punic: 1.6.3 to 3.5.1
* ramsey/uuid: 3.4.1 to 4.0.1
* react/promise: 2.5.1 to 2.8.0
* seld/jsonlint: 1.6.1 to 1.8.0
* seld/phar-utils: 1.0.1 to 1.1.0
* smarty/smarty: 3.1.33 to 3.1.36
* stripe/stripe-php: 6.43.1 to 7.34.0
* symfony/polyfill-ctype: Added 1.18.1
* symfony/polyfill-iconv: 1.2.0 to 1.18.1
* symfony/polyfill-intl-idn: Added 1.18.1
* symfony/polyfill-mbstring: 1.3.0 to 1.18.1
* symfony/polyfill-php72: Added 1.18.1
* symfony/polyfill-php73: Added 1.18.1
* tecnickcom/tcpdf: 6.2.26 to 6.3.5
* zbateson/stream-decorators: Added 1.0.3

== New Documentation ==
The following new documentation pages are available:
* [[Email Campaigns]]
* [[Mail Providers]]
* [[Configuring Mail Providers]]
* [[Users And Accounts]]
* [[Email Sending Issues]] (Updated)
* [[Sign-In Integrations]] (Updated)
* [[Product Groups]] (Updated)
* [[Products and Services]] (Updated)
* [https://developers.whmcs.com/mail-providers/ Mail Providers Developer Documentation]
* [https://developers.whmcs.com/domain-registrars/module-parameters/ Domain Registrars Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/getticket/ GetTicket Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/gettickets/ GetTickets Developer Documentation] (Updated)

== Template ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/templates-six/compare/v7.10.2-release.1...v8.0.1-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.10.2-release.1...v8.0.1-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.0.0_Beta_1|Version 8.0.0 Beta 1]]
* [[Changelog:WHMCS_V8.0.0_Beta_3|Version 8.0.0 Beta 3]]
* [[Changelog:WHMCS_V8.0.0_RC_1|Version 8.0.0 RC 1]]
* [[Changelog:WHMCS_V8.0.0_RC_2|Version 8.0.0 RC 2]]
* [[Changelog:WHMCS_V8.0.0_RC_3|Version 8.0.0 RC 3]]
* [[Changelog:WHMCS_V8.0.0_GA|Version 8.0.0 General Availability]]
* [[Changelog:WHMCS_V8.0.1|Version 8.0.1 (Maintenance)]]
* [[Changelog:WHMCS_V8.0.2|Version 8.0.2 (Maintenance)]]

Version 8.0.0 Release Notes

2020-10-06T23:44:55Z

Chance: /* Version History */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 8.0<br />
Release Type: General Availability<br />
Release Date: 28th Sep 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>8.0.0</td><td>Beta 1</td><td>4th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Beta 2 (Internal Build)</td><td>N/A</td></tr>
<tr><td>8.0.0</td><td>Beta 3</td><td>11th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 1</td><td>27th Aug 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 2</td><td>4th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>Release Candidate 3</td><td>18th Sep 2020</td></tr>
<tr><td>8.0.0</td><td>General Availability 1</td><td>28th Sep 2020</td></tr>
<tr><td>8.0.1</td><td>Maintenance</td><td>2nd Oct 2020</td></tr>
<tr><td>8.0.2</td><td>Maintenance</td><td>6th Oct 2020</td></tr>
</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduces support for PHP 7.4. Earlier versions of WHMCS do not support PHP 7.4.

<div class="docs-alert-warning">You will only see the WHMCS 8.0 updates within the Automatic Updater if you are running on PHP 7.2 or later. If you are running PHP 7.1 or earlier, to update to WHMCS 8.0 via the Automatic Updater, you will first need to upgrade to PHP 7.2 or PHP 7.3, and then check for updates and perform the update.</div>

Once you are running WHMCS 8.0, you can upgrade to PHP 7.4.

[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in [[Automatic_Updater|Automatic Update]] utility.

Go to '''Utilities > Update WHMCS''' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click '''Check for Updates''' before the update will be available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

===Updates from Beta 1===

If you upgraded to WHMCS v8.0 Beta 1, you may experience problems retrieving the latest version of the software via the Automatic Updater. If updating directly from v7.10.2 or earlier, this issue will not apply.

To use the Automatic Updater to update from WHMCS v8.0 Beta 1, you must first apply a hotfix. For more information, see [https://whmcs.community/topic/301579-v80-beta-1-hotfix-required-for-update-to-whmcs-v80-beta-3/ our forums].

== Release Notes ==

=== Users and Client Accounts ===
WHMCS now supports accounts and users in a new end-user login management system. Accounts own services for a given entity. A single user can then manage multiple accounts.

[[Users_And_Accounts|Learn more...]]

=== New Admin Area Look ===
Admin Area Blend theme enhancements bring an updated look and better performance to the Admin Area. We've also added improved support for mobile devices and tablets.

=== Mail Deliverability Providers ===
Admin users can now easily configure email sending from one of several new mail providers. Currently, this includes SparkPost, SendGrid, and Mailgun. Using them enhances your email deliverability and security.

[[Mail_Providers|Learn more...]]

=== Email Campaigns ===
The new '''Email Campaigns''' tool has replaced the '''Mass Mail Tool'''. The new features include scheduling and saving drafts of your email campaigns, and adding styling.

[[Email_Campaigns|Learn more...]]

=== Improved IDN Support ===
Sell a broader range of domain names with full International Domain Name support. Enom and ResellerClub support automatic IDN registration, and you'll benefit from robust IDN validation and usability improvements.

[[Domains_Tab|Learn more...]]

=== OAuth2 for SMTP ===
To facilitate moving away from password-based authentication, OAuth2 is now fully supported. Google is already available, and we plan to add more providers in the future.

[[Mail_Providers|Learn more...]]

=== Improved Currency Support ===
WHMCS now supports up to three decimal places in tax rates and currency values up to 99 trillion.

=== OX App Suite from Open-Xchange ===
MarketConnect now includes OX App Suite from Open-Xchange. OX App Suite provides an easy-to-use email and communications platform with many features and capabilities.

== Deprecation and Removal Notices ==

=== Removed Legacy PHP Support ===
Product support for the legacy PHP 5.6, 7.0, and 7.1 environments is removed. To install or upgrade, you must run PHP 7.2 or higher.

=== Removed PHP Extensions Requirement ===
The <tt>IMAP</tt> extension is no longer required.
The <tt>GD</tt> extension is no longer required for '''some''' features, but is still required for WHMCS as a whole.

=== Deprecated v4 Theme ===
The v4 theme for the Admin Area is deprecated. If no admin accounts currently use this theme, upgrading will '''delete''' it. If the theme is in use, it will remain available for selection. However, admins who are assigned to this theme will move to Blend when you upgrade.

=== Deprecated AutoAuth ===
AutoAuth was [[Version_7.10.0_Release_Notes#Other|announced]] as deprecated in WHMCS version 7.10, including an option to enable or disable the feature. When you upgrade, the feature is disabled regardless of its previous value. We will remove AutoAuth in WHMCS version 8.1.

=== Removed Boxes and Modern Templates ===
The ''Boxes'' and ''Modern'' templates have been removed.

If products or groups use one of these, upgrading selects a new template that emulates the deprecated template. The system assigns the new template to everything that previously used the deprecated template. Newly-created child templates are based on the ''Standard'' template.

This upgrade will not touch custom themes.

=== Removed Modules ===
We have removed the PayMate.au, PayMate.nz, GameCP, MediaCP, and Kayako LoginShare modules.

=== Removed Legacy Files ===
We have removed <tt>whois.php</tt> from the Client Area file set.
The <tt>pipe</tt> directory was deprecated and has been removed. Use <tt>crons/pipe.php</tt> instead.

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* abraham/twitteroauth: 0.7.4 to 1.1.0
* composer/composer: 1.0.3 to 1.10.6
* ezyang/htmlpurifier: 4.9.2 to 4.12.0
* filp/whoops: 2.1.8 to 2.7.2
* firebase/php-jwt: 3.0.0 to 5.2.0
* google/apiclient: v2.1.3 to 2.7.0
* google/auth: 0.9.0 to 1.11.0
* guzzlehttp/guzzle: 5.3.3 to 7.0.1
* illuminate/console: 5.2.37 to 7.12.0
* illuminate/container: 5.2.37 to 7.12.0
* illuminate/contracts: 5.2.45 to 7.12.0
* illuminate/database: 5.2.37 to 7.12.0
* illuminate/events: 5.2.37 to 7.12.0
* illuminate/support: 5.2.37 to 7.12.0
* illuminate/validation: 5.2.45 to 7.12.0
* knplabs/knp-menu: 2.1.1 to 3.1.1
* laminas/laminas-diactoros: Added 2.3.1
* laminas/laminas-httphandlerrunner: Added 1.2.0
* league/climate: 3.2.1 to 3.5.2
* league/flysystem: 1.0.45 to 1.0.67
* league/oauth2-client: added 2.5.0
* league/oauth2-google: added 3.0.3
* monolog/monolog: 1.18.2 to 2.0.2
* nikic/fast-route: 1.2.0 to 1.3.0
* php-imap/php-imap: 2.0.9 to 3.1.0
* phpmyadmin/sql-parser: 4.2.4 to 5.3.1
* phpmyadmin/phpmailer: 6.0.7 to 6.1.5
* phpseclib/mcrypt_compat: 1.0.5 to 1.0.11
* phpseclib/phpseclib: 2.0.10 to 2.0.27
* punic/punic: 1.6.3 to 3.5.1
* ramsey/uuid: 3.4.1 to 4.0.1
* react/promise: 2.5.1 to 2.8.0
* seld/jsonlint: 1.6.1 to 1.8.0
* seld/phar-utils: 1.0.1 to 1.1.0
* smarty/smarty: 3.1.33 to 3.1.36
* stripe/stripe-php: 6.43.1 to 7.34.0
* symfony/polyfill-ctype: Added 1.18.1
* symfony/polyfill-iconv: 1.2.0 to 1.18.1
* symfony/polyfill-intl-idn: Added 1.18.1
* symfony/polyfill-mbstring: 1.3.0 to 1.18.1
* symfony/polyfill-php72: Added 1.18.1
* symfony/polyfill-php73: Added 1.18.1
* tecnickcom/tcpdf: 6.2.26 to 6.3.5
* zbateson/stream-decorators: Added 1.0.3

== New Documentation ==
The following new documentation pages are available:
* [[Email Campaigns]]
* [[Mail Providers]]
* [[Configuring Mail Providers]]
* [[Users And Accounts]]
* [[Email Sending Issues]] (Updated)
* [[Sign-In Integrations]] (Updated)
* [[Product Groups]] (Updated)
* [[Products and Services]] (Updated)
* [https://developers.whmcs.com/mail-providers/ Mail Providers Developer Documentation]
* [https://developers.whmcs.com/domain-registrars/module-parameters/ Domain Registrars Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/getticket/ GetTicket Developer Documentation] (Updated)
* [https://developers.whmcs.com/api-reference/gettickets/ GetTickets Developer Documentation] (Updated)

== Template ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/templates-six/compare/v7.10.2-release.1...v8.0.1-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.10.2 and 8.0:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.10.2-release.1...v8.0.1-release.1

== Changelog ==
* [[Changelog:WHMCS_V8.0.0_Beta_1|Version 8.0.0 Beta 1]]
* [[Changelog:WHMCS_V8.0.0_Beta_3|Version 8.0.0 Beta 3]]
* [[Changelog:WHMCS_V8.0.0_RC_1|Version 8.0.0 RC 1]]
* [[Changelog:WHMCS_V8.0.0_RC_2|Version 8.0.0 RC 2]]
* [[Changelog:WHMCS_V8.0.0_RC_3|Version 8.0.0 RC 3]]
* [[Changelog:WHMCS_V8.0.0_GA|Version 8.0.0 General Availability]]
* [[Changelog:WHMCS_V8.0.1|Version 8.0.1 (Maintenance)]]

Changelog:WHMCS V8.0.0 GA

2020-09-28T23:55:28Z

Chance:

<noinclude>[[Version 8.0.0 Release Notes]]</noinclude>

== Maintenance ==
CORE-14770 - Correct renewal invoice regeneration following product upgrade<br />
CORE-15135 - Ensure IDN subdomain is properly transcoded when specified during the product ordering process<br />
CORE-15174 - Ensure Stock Control does not display negative in Cart<br />
CORE-15232 - Correct aggregation of clients with active product addons for automated status changes<br />
CORE-15263 - Prevent spurious error in Stripe ACH and SEPA callbacks<br />
CORE-15287 - Fix text display in Digicert modal<br />
CORE-15297 - Improve handling of orphaned Service Addons<br />
CORE-15298 - Enforce unique email address in AddClient API<br />
CORE-15319 - Improve error messages for IDN lookup when system IDN is disabled<br />
CORE-15324 - Ensure Tax ID field retains data on checkout page when reloading due to error<br />
CORE-15326 - Validate email retrieved from server in Server Sync Tool<br />
CORE-15349 - Allow guest to view opened ticket following form submission<br />
CORE-15351 - Ensure cart redirect is available for Users without Accounts<br />
CORE-15359 - Prevent error when creating existing user quote with predefined product<br />
CORE-15361 - Correct image links on OX App Suite landing page<br />
CORE-15373 - Correct Spotlight TLD display for IDN domain searches<br />    Also known as: CORE-15370<br />
CORE-15384 - Ensure Price Overrides made during Admin Orders are Honored<br />
CORE-15397 - Rectify invalid MarketConnect slug generation<br />

== Modules ==
MODULE-7508 - Reduce recipients to prevent spurious error with SendGrid<br />
CORE-15237 - Correct template usage for bank payment gateways<br />

== PMA ==
PMA-176 - Ensure Client can be associated with a New Project<br />
PMA-179 - Prevent edit of billed time tracker<br />    Also known as: ADDON-6126<br />
PMA-180 - Prevent negative time tracking entry<br />    Also known as: ADDON-6125<br />

== API ==
CORE-15308 - Remove reference to non-functional GetClientPassword API<br />
CORE-15313 - Include payment method in response for GetClientsAddons API<br />

== Languages ==
CORE-15208 - Update Hebrew Admin translation<br />
CORE-15212 - Update Brazilian Portuguese translation<br />
CORE-15223 - Update Hungarian translations<br />
CORE-15383 - Update Spanish translation<br />

Changelog:WHMCS V8.0.0 GA

2020-09-28T23:54:04Z

Chance:

<noinclude>[[Version 8.0.0 Release Notes]]</noinclude>

== Maintenance ==
CORE-14770 - Correct renewal invoice regeneration following product upgrade<br />
CORE-15135 - Ensure IDN subdomain is properly transcoded when specified during the product ordering process<br />
CORE-15174 - Ensure Stock Control does not display negative in Cart<br />
CORE-15232 - Correct aggregation of clients with active product addons for automated status changes<br />
CORE-15263 - Prevent spurious error in Stripe ACH and SEPA callbacks<br />
CORE-15287 - Fix text display in Digicert modal<br />
CORE-15297 - Improve handling of orphaned Service Addons<br />
CORE-15298 - Enforce unique email address in AddClient API<br />
CORE-15319 - Improve error messages for IDN lookup when system IDN is disabled<br />
CORE-15324 - Ensure Tax ID field retains data on checkout page when reloading due to error<br />
CORE-15326 - Validate email retrieved from server in Server Sync Tool<br />
CORE-15349 - Allow guest to view opened ticket following form submission<br />
CORE-15351 - Ensure cart redirect is available for Users without Accounts<br />
CORE-15359 - Prevent error when creating existing user quote with predefined product<br />
CORE-15361 - Correct image links on OX App Suite landing page<br />
CORE-15373 - Correct Spotlight TLD display for IDN domain searches<br /> Also known as: CORE-15370<br />
CORE-15384 - Ensure Price Overrides made during Admin Orders are Honored<br />
CORE-15397 - Rectify invalid MarketConnect slug generation<br />

== Modules ==
MODULE-7508 - Reduce recipients to prevent spurious error with SendGrid<br />
CORE-15237 - Correct template usage for bank payment gateways<br />

== PMA ==
PMA-176 - Ensure Client can be associated with a New Project<br />
PMA-179 - Prevent edit of billed time tracker<br /> Also known as: ADDON-6126<br />
PMA-180 - Prevent negative time tracking entry<br /> Also known as: ADDON-6125<br />

== API ==
CORE-15308 - Remove reference to non-functional GetClientPassword API<br />
CORE-15313 - Include payment method in response for GetClientsAddons API<br />

== Languages ==
CORE-15208 - Update Hebrew Admin translation<br />
CORE-15212 - Update Brazilian Portuguese translation<br />
CORE-15223 - Update Hungarian translations<br />
CORE-15383 - Update Spanish translation<br />

Configuring Notifications with Slack

2020-06-22T18:36:50Z

Chance:

Configuring Notifications with Slack allows you to receive notifications in your Slack channels when events occur within WHMCS.

For more information on Notifications, please refer to the [[Notifications|Notifications Documentation]].

==Configuring Slack Notifications==

To enable WHMCS to communicate with the Slack API, WHMCS requires an OAuth Access Token.

You can create an OAuth Access Token quickly and easily by following the steps below.

===Creating an App for Slack===

1. Begin by logging into your Slack Workspace

2. Visit https://api.slack.com/

3. Click the Start Building button to start the process of creating a new app. You will need to login if you haven't already.

4. Enter a name for the app. We recommend something like 'WHMCS'. Also choose the workspace you wish to add the app to. Then click continue.

5. Under the Add features and functionality heading, select the Permissions option

[[File:Slack_features.png|500px]]

6. Scroll down to Scopes: Bot Token Scopes

7. Click "Add an OAuth Scope" and assign the following permissions:

* channels:join
* channels:read
* chat:write
* groups:read

[[File:Slack_scopes.png|500px]]

9. Click Install App to Workspace

[[File:Slack_install_to_workspace.png|500px]]

9. Confirm you authorize the permissions for the app that you just configured.

10. You will now be presented with the Bot User OAuth Access Token you need for WHMCS integration. Copy this value.

[[File:Slack_oauth.png|500px]]

11. Now return to WHMCS and navigate to Setup > Notifications.

12. Under the Slack notification provider, click Configure

13. Enter the Bot User OAuth Access Token you copied in step 10 into the OAuth Access Token input field and hit Save Changes to complete the process.

[[File:Whmcs_slack_oauth.png|500px]]

WHMCS will attempt to verify the OAuth Access Token provided and automatically join your App . If the verification fails you will receive an error message. Check the Access Token is entered correctly, has all the required scopes and try again. If successful, the modal will close and you will now be able to send notifications to Slack.

You are now ready to [[Notifications#Creating_a_Notification_Rule|Create Your First Notification Rule]].

WHMCS will attempt to automatically join your Bot to a Slack channel when one is defined in a Notification Rule.

Changelog:WHMCS V7.10.2

2020-05-20T16:59:26Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.2 Release Notes]]</noinclude>

== Maintenance ==
CORE-14484 - Ensure single domain renewals can proceed<br />
CORE-14543 - Apply dynamic currency factor to ResellerClub API results in TLD Sync<br />
CORE-14548 - Ensure clients are correctly observed as active during ClientStatusSync<br />
CORE-14550 - Ensure metric usage definitions are removed upon Product deletion<br />
CORE-14558 - Improve logic for early callback with WorldPay FuturePay<br />
CORE-14561 - Ensure appropriate options are pre-selected when editing Email Marketer rule<br />
CORE-14563 - Correct path prefix for S3-backed KB image storage<br />
CORE-14565 - Prevent repeated emails sent by a single Email Marketer Rule<br />
CORE-14567 - Ensure asset type "email_images" can be migrated<br />
CORE-14569 - Correct free to paid upgrade cycle validation<br />
CORE-14572 - Correct input validation for My Account > Disable Two Factor<br />
CORE-14578 - Prevent display of option to upgrade to a product without a billing cycle<br />
CORE-14583 - Ensure optimized OpenSSL library is used with GMP is not present<br />
CORE-14596 - Correct View & Pay Invoice permission for sub-accounts<br />
CORE-14600 - Improve days until due calculation when upgrading from free to paid product with a promotion code<br />
CORE-14608 - Correct Storage IDs for kb_images and email_images<br />
CORE-14616 - Correct 2FA redirect for full-friendly URL paths<br />
CORE-14617 - Prevent erroneous block of 2Checkout activation<br />
CORE-14498 - Ensure that we always get a 0 value when expected<br />

== Modules ==
MODULE-6942 - Observe and handle buyer_complaint reversal IPN for PayPal Basic<br />
MODULE-7066 - Update available_clouds call from POST to GET in VPS.net<br />
MODULE-7356 - Ensure License Addon renders cancellation link as configured<br />
MODULE-7380 - Correct input for configuration validation of ResellerClub SSL<br />
MODULE-7406 - Improve handling of non-decimal currencies in PayPal Checkout<br />
MODULE-7407 - Correct float normalization for PayPal Checkout<br />

== API ==
CORE-13660 - Clarify AddOrder API in regards to automation of product/service setup<br />

Changelog:WHMCS V7.10.1

2020-04-16T18:42:11Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.1 Release Notes]]</noinclude>

== Maintenance ==
CORE-14451 - Correct September Date Translation In Announcements<br />
CORE-14473 - Improve tracking and display of manually applied recurring promo<br />
CORE-14497 - Correct observed currency from multi-level accounts of ResellerClub for TLD Sync<br />
CORE-14505 - Correct currency conversion of grace and redemption fees for non-default currency in TLD Sync<br />
CORE-14506 - Improve logic for modification of default email template on update<br />
CORE-14508 - Improve cache for admin operations regarding paymethod management<br />
CORE-14514 - Ensure Auto Recalculate does not add exclusive tax<br />
CORE-14515 - Correct default selection of Weebly Free on orders<br />
CORE-14516 - Correct upgrade routine for Weebly Free<br />
CORE-14518 - Correct admin client search<br />
CORE-14519 - Prevent error on autocapture for credit cards<br />
CORE-14520 - Ensure Manage Domain option is visible in the Weebly MarketConnect Overview tab<br />
CORE-14524 - Prevent error when attempting to access store pages that require authentication<br />
CORE-14532 - Correct factorial of IDR currency values from ResellerClub for TLD Sync<br />

== Modules ==
MODULE-7299 - Correct filter by currency on Transactions Report<br />
MODULE-7316 - Ensure fraud processing can occur with GoCardless<br />
MODULE-7329 - Correct payment status for invoices paid in full with credit but have PayPal Checkout subscription<br />
MODULE-7345 - Prevent error on md5 check in Licending Addon<br />
MODULE-7346 - Correct usage metric value of sub-accounts for DirectAdmin<br />

== API ==
CORE-14537 - Correct transfer data evaluation for CreateOrUpdateTLD API<br />

== Languages ==
CORE-14499 - Improvements for Norwegian translation<br />
CORE-14502 - Improvements for French translation<br />
CORE-14511 - Improvements for Hungarian translation<br />

Changelog:WHMCS V7.10.0 Beta 1

2020-04-16T18:41:30Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.0 Release Notes]]</noinclude>

== Implemented ==
FEATURE-2180 - MarketConnect: Introduce Marketgoo SEO Service Offering<br />
FEATURE-2182 - Add Image Upload to Knowledgebase Article Editor<br />
FEATURE-2186 - Add Assigned Admin search field in ticket search<br />
FEATURE-2237 - Provide UI for Admin to alter the associated service for a support ticket<br />
FEATURE-2238 - Add TLD Import & Pricing Sync Tool for Domain Registrars<br />
FEATURE-2245 - Add Additional Cron Task Action & Event Logging<br />
FEATURE-2249 - Provide Email Preferences for primary client profile users<br />
FEATURE-2253 - MarketConnect: Introduce the Weebly Free Plan<br />
FEATURE-2263 - Add Cron Task Reporting to Automation Status UI<br />
FEATURE-2266 - Add TLD Import & Pricing Sync support to Enom module<br />
FEATURE-2268 - Add TLD Import & Pricing Sync support to ResellerClub/Logicboxes modules<br />

== Maintenance ==
ADDON-5957 - Ensure Bulk Pricing Updater does not affect secondary TLDs<br />    Also known as: ADDON-6008, MODULE-7305<br />
ADDON-6117 - Add Module Debug Logging to PayPal Transaction Lookup<br />
CORE-10554 - Improve efficiency of cart.php with large amount of configurable options<br />
CORE-13545 - Correct calculation for "Auto recalculate on save" option on service in system with inclusive tax for tax exempt client <br />
CORE-13616 - Correct invisible recaptcha and field validation order precedence<br />
CORE-13885 - Improve Server Sync Tool reseller package name detection<br />
CORE-14028 - Prevent Auto Client Status Sync from deactivating clients with recurring billable items<br />
CORE-14033 - Ensure Status Change Event Notifcation is triggered by actioned escalation rule <br />
CORE-14071 - Remove reference to jQueryUI in Modern orderform<br />
CORE-14109 - Update SpamExperts logo<br />
CORE-14120 - Show translated support department name on submitticket.php as guest<br />
CORE-14124 - Ensure translated KB articles are not returned in search results if language is not selected<br />
CORE-14132 - Ensure server group save retains associated servers<br />
CORE-14139 - Correct language key used for billable item descriptions<br />
CORE-14157 - Correct generated links for Current Quotes on Client Summary<br />
CORE-14163 - Prevent erroneous error for case changes to email address in client area<br />
CORE-14178 - Ensure Escalation Rules can manage custom ticket status with comma character<br />
CORE-14181 - Optimize Usage Billing data collection from cPanel<br />
CORE-14190 - Update GoDaddy logo<br />
CORE-14192 - Ensure credit applied to invoice shows on Credit Reviewer Report<br />
CORE-14200 - Improve Admin login button generation for Centovacast<br />
CORE-14201 - Translate "Stage" on Quotes page<br />
CORE-14205 - Correct PDF invoice line item generation for domain names of transliterated equivalence<br />
CORE-14209 - Improve duration description of Client For on new clients<br />
CORE-14219 - Improve SSL Certificate Monitoring report aggregation<br />
CORE-14227 - Improve WHMCS\Domain\Registrar\Domain class documentation<br />
CORE-14231 - Add health check to warning when directories expected to be restricted are browseable<br />
CORE-14245 - Ensure checkout preselects default payment method<br />
CORE-14250 - Allow configuration of suggest TLD list for registrar based lookup providers<br />
CORE-14264 - Gracefully redirect when attempting to view a nonexistent product in Admin area<br />
CORE-14269 - Perform appropriate redirect with directly referencing cart fraud check URL<br />
CORE-14272 - Translate "Email Sent" for client area email verification status/button<br />
CORE-14276 - Improve checkout redirect for remote input gateway<br />
CORE-14278 - Add {$service_subscription_id} merge field for product/service e-mail templates<br />
CORE-14289 - Minor styling improvements for Admin download management<br />
CORE-14294 - New UI/UX for Email Marketer<br />
CORE-14307 - Prevent erroneous deletion block of pay method when associated to a nonexistent billing contact<br />
CORE-14311 - Ensure both payment and overpayment on a Add Funds invoice is applied to client account<br />
CORE-14313 - Correct displayed price for upgrade orders with 100% discount promo<br />    Also known as: CORE-14325<br />
CORE-14315 - Improve knowledgebase tag search<br />    Also known as: CORE-14330<br />
CORE-14316 - Correct disk & bandwidth metrics on cPanel<br />CORE-14319 - Prevent error when using a Duotone FontAwesome icon is custom sidebar<br />
CORE-14331 - Correct typo in Credit Card Expiring Soon email template<br />    Also known as: CORE-14332<br />
CORE-14372 - MarketConnect: Introduce new DigiCert SSL Certificates<br />
PMA-155 - Correct data range usage for Staff Logs Report<br />
PMA-156 - Correct version in manifest file<br />

== Modules ==
MODULE-6567 - Correct package change for cPanel reseller accounts<br />    Also known as: MODULE-7233<br />
MODULE-7237 - Improve error message on Plaid failure<br />
MODULE-7240 - Improve error handling if Stripe and Plaid have not been linked<br />
MODULE-7255 - Update Slack integration to utilize their Conversations API<br />
MODULE-7265 - Improve accuracy of rounded percentage saving on VPN landing page<br />
MODULE-7267 - Correct logo overflow in MarketConnect landing pages<br />
MODULE-7271 - Update Authorize.net cert.pem file<br />
MODULE-7280 - Ensure Slack notification recieves correct entity encoding for URL parameter<br />    Also known as: INTDESK-6072<br />
MODULE-7294 - Remove erroneous country restriction for PayPal account linking<br />
MODULE-7302 - Correct cPanel API usage for changing reseller package<br />
MODULE-7303 - Remove Kuveytturk gateway module<br />
MODULE-7306 - Correct disk & bandwidth metrics for resellers on DirectAdmin<br />
MODULE-7308 - Improve feedback for ResellerClub disallowed IP error<br />
MODULE-7309 - Prevent fatal error when collecting cPanel reseller stats with underprivileged API credentials<br />

== Languages ==
CORE-14248 - Improve Turkish translation<br />

Changelog:WHMCS V7.10.0 Beta 1

2020-04-16T18:40:59Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.0 Release Notes]]</noinclude>

== Implemented ==
FEATURE-2180 - MarketConnect: Introduce Marketgoo SEO Service Offering<br />
FEATURE-2182 - Add Image Upload to Knowledgebase Article Editor<br />
FEATURE-2186 - Add Assigned Admin search field in ticket search<br />
FEATURE-2237 - Provide UI for Admin to alter the associated service for a support ticket<br />
FEATURE-2238 - Add TLD Import & Pricing Sync Tool for Domain Registrars<br />
FEATURE-2245 - Add Additional Cron Task Action & Event Logging<br />
FEATURE-2249 - Provide Email Preferences for primary client profile users<br />
FEATURE-2253 - MarketConnect: Introduce the Weebly Free Plan<br />
FEATURE-2263 - Add Cron Task Reporting to Automation Status UI<br />
FEATURE-2266 - Add TLD Import & Pricing Sync support to Enom module<br />
FEATURE-2268 - Add TLD Import & Pricing Sync support to ResellerClub/Logicboxes modules<br />

== Maintenance ==
ADDON-5957 - Ensure Bulk Pricing Updater does not affect secondary TLDs<br />    Also known as: ADDON-6008, MODULE-7305<br />
ADDON-6117 - Add Module Debug Logging to PayPal Transaction Lookup<br />
CORE-10554 - Improve efficiency of cart.php with large amount of configurable options<br />
CORE-13545 - Correct calculation for "Auto recalculate on save" option on service in system with inclusive tax for tax exempt client <br />
CORE-13616 - Correct invisible recaptcha and field validation order precedence<br />
CORE-13885 - Improve Server Sync Tool reseller package name detection<br />
CORE-14028 - Prevent Auto Client Status Sync from deactivating clients with recurring billable items<br />
CORE-14033 - Ensure Status Change Event Notifcation is triggered by actioned escalation rule <br />
CORE-14071 - Remove reference to jQueryUI in Modern orderform<br />
CORE-14109 - Update SpamExperts logo<br />
CORE-14120 - Show translated support department name on submitticket.php as guest<br />
CORE-14124 - Ensure translated KB articles are not returned in search results if language is not selected<br />
CORE-14132 - Ensure server group save retains associated servers<br />
CORE-14139 - Correct language key used for billable item descriptions<br />
CORE-14157 - Correct generated links for Current Quotes on Client Summary<br />
CORE-14163 - Prevent erroneous error for case changes to email address in client area<br />
CORE-14178 - Ensure Escalation Rules can manage custom ticket status with comma character<br />
CORE-14181 - Optimize Usage Billing data collection from cPanel<br />
CORE-14190 - Update GoDaddy logo<br />
CORE-14192 - Ensure credit applied to invoice shows on Credit Reviewer Report<br />
CORE-14200 - Improve Admin login button generation for Centovacast<br />
CORE-14201 - Translate "Stage" on Quotes page<br />
CORE-14205 - Correct PDF invoice line item generation for domain names of transliterated equivalence<br />
CORE-14209 - Improve duration description of Client For on new clients<br />
CORE-14219 - Improve SSL Certificate Monitoring report aggregation<br />
CORE-14227 - Improve WHMCS\Domain\Registrar\Domain class documentation<br />
CORE-14231 - Add health check to warning when directories expected to be restricted are browseable<br />
CORE-14245 - Ensure checkout preselects default payment method<br />
CORE-14250 - Allow configuration of suggest TLD list for registrar based lookup providers<br />
CORE-14264 - Gracefully redirect when attempting to view a nonexistent product in Admin area<br />
CORE-14269 - Perform appropriate redirect with directly referencing cart fraud check URL<br />
CORE-14272 - Translate "Email Sent" for client area email verification status/button<br />
CORE-14276 - Improve checkout redirect for remote input gateway<br />
CORE-14278 - Add {$service_subscription_id} merge field for product/service e-mail templates<br />
CORE-14289 - Minor styling improvements for Admin download management<br />
CORE-14294 - New UI/UX for Email Marketer<br />
CORE-14307 - Prevent erroneous deletion block of pay method when associated to a nonexistent billing contact<br />
CORE-14311 - Ensure both payment and overpayment on a Add Funds invoice is applied to client account<br />
CORE-14313 - Correct displayed price for upgrade orders with 100% discount promo<br />    Also known as: CORE-14325<br />
CORE-14315 - Improve knowledgebase tag search<br />    Also known as: CORE-14330<br />
CORE-14316 - Correct disk & bandwidth metrics on cPanel<br />CORE-14319 - Prevent error when using a Duotone FontAwesome icon is custom sidebar<br />
CORE-14331 - Correct typo in Credit Card Expiring Soon email template<br />    Also known as: CORE-14332<br />
CORE-14372 - MarketConnect: Introduce new DigiCert SSL Certificates<br />
CORE-14514 - Ensure Auto Recalculate does not add exclusive tax<br />
PMA-155 - Correct data range usage for Staff Logs Report<br />
PMA-156 - Correct version in manifest file<br />

== Modules ==
MODULE-6567 - Correct package change for cPanel reseller accounts<br />    Also known as: MODULE-7233<br />
MODULE-7237 - Improve error message on Plaid failure<br />
MODULE-7240 - Improve error handling if Stripe and Plaid have not been linked<br />
MODULE-7255 - Update Slack integration to utilize their Conversations API<br />
MODULE-7265 - Improve accuracy of rounded percentage saving on VPN landing page<br />
MODULE-7267 - Correct logo overflow in MarketConnect landing pages<br />
MODULE-7271 - Update Authorize.net cert.pem file<br />
MODULE-7280 - Ensure Slack notification recieves correct entity encoding for URL parameter<br />    Also known as: INTDESK-6072<br />
MODULE-7294 - Remove erroneous country restriction for PayPal account linking<br />
MODULE-7302 - Correct cPanel API usage for changing reseller package<br />
MODULE-7303 - Remove Kuveytturk gateway module<br />
MODULE-7306 - Correct disk & bandwidth metrics for resellers on DirectAdmin<br />
MODULE-7308 - Improve feedback for ResellerClub disallowed IP error<br />
MODULE-7309 - Prevent fatal error when collecting cPanel reseller stats with underprivileged API credentials<br />

== Languages ==
CORE-14248 - Improve Turkish translation<br />

Changelog:WHMCS V7.10

2020-04-16T14:57:38Z

Chance: /* Version 7.10.0 GA */

=Version 7.10.0 Beta 1=
{{:Changelog:WHMCS_V7.10.0_Beta_1}}
=Version 7.10.0 RC 1=
{{:Changelog:WHMCS_V7.10.0_RC_1}}
=Version 7.10.0 RC 2=
{{:Changelog:WHMCS_V7.10.0_RC_2}}
=Version 7.10.0 General Availability=
{{:Changelog:WHMCS_V7.10.0_GA}}

=Version 7.10.1 Maintenance=
{{:Changelog:WHMCS_V7.10.1}}

Changelog:WHMCS V7.10.0 GA

2020-04-07T14:41:07Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.0 Release Notes]]</noinclude>

== Maintenance ==
CORE-11923 - Improve Setup Wizard Enom signup input fields for country and phone number<br />    Also known as: CORE-14211<br />
CORE-14429 - Correct translation string for Email Image Storage Asset Type<br />
CORE-14438 - Improve query for domain SSL Check<br />
CORE-14439 - Provide email_verified in GetClientsDetails API response<br />
CORE-14442 - Correct display of contacts in dropdown when creating a new client ticket in admin area<br />    Also known as: CORE-14472<br />
CORE-14443 - Extend the Pay Method "Force Delete" option to Pay Methods where the module has been deactivated<br />
CORE-14445 - Prevent creation of back-dated invoices upon enablement of Continuous Invoice Generation<br />
CORE-14446 - Add Business Name to PayPal Addon output<br />
CORE-14447 - Provide translation strings for 2FA module name & description<br />
CORE-14450 - Prevent upgrade error when dynamic translations are defined<br />
CORE-14457 - Improve Automation Settings description & display of suggested cron command for external setup<br />
CORE-14458 - Correct import of Grace period for TLD Import & Sync<br />
CORE-14459 - Allow TLD Import & Sync to set Auto Register for existing TLDs with confirmation<br />
CORE-14462 - Ensure CC Capture succeeds when using the "Attempt CC Captures" link<br />
CORE-14471 - Correct parameters for single day duration on Sales Tax Liability report<br />
CORE-14475 - Correct display of non default pricing in TLD sync<br />
CORE-14476 - Prevent error from SaveQuote when no lineitems exist<br />
CORE-14478 - Improve messaging of currency display and converstion in TLD Sync<br />

== Modules ==
MODULE-7286 - Improve error handling for cPanel package change when using reseller credentials<br />
MODULE-7295 - Improve consistency of product detail and SSO for MarketConnect service<br />
MODULE-7296 - Display error message when no MarketConnect upgrade options are available<br />
MODULE-7326 - Auto invite Slack user to notification channel on setup or use<br />
MODULE-7327 - Create fallback routine to PayPal basic for Subscription Cancellation<br />
MODULE-7330 - Delete Stripe SEPA/ACH Webhook upon module deactivation<br />
MODULE-7333 - Add minor visual improvements for tld pricing window<br />
MODULE-7342 - Correct configuration validation routine for InternetBS<br />

== API ==
CORE-14452 - Provide attachment information for GetTicket API<br />
CORE-14453 - Implement GetTicketAttachment API<br />
CORE-14454 - Implement DeleteTicketReply API<br />
CORE-14455 - Implement BlockTicketSender API<br />
CORE-14456 - Implement MergeTicket API<br />

== Languages ==
CORE-14440 - Improvements for Hungarian translation<br />
CORE-14461 - Improvements for Hebrew translation<br />
CORE-14481 - Improvements for Admin Hebrew translation<br />

Changelog:WHMCS V7.10.0 GA

2020-04-07T14:40:19Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.0 Release Notes]]</noinclude>

== Maintenance ==
CORE-11923 - Improve Setup Wizard Enom signup input fields for country and phone number<br />   &Also known as: CORE-14211<br />
CORE-14429 - Correct translation string for Email Image Storage Asset Type<br />
CORE-14438 - Improve query for domain SSL Check<br />
CORE-14439 - Provide email_verified in GetClientsDetails API response<br />
CORE-14442 - Correct display of contacts in dropdown when creating a new client ticket in admin area<br />   &Also known as: CORE-14472<br />
CORE-14443 - Extend the Pay Method "Force Delete" option to Pay Methods where the module has been deactivated<br />
CORE-14445 - Prevent creation of back-dated invoices upon enablement of Continuous Invoice Generation<br />
CORE-14446 - Add Business Name to PayPal Addon output<br />
CORE-14447 - Provide translation strings for 2FA module name & description<br />
CORE-14450 - Prevent upgrade error when dynamic translations are defined<br />
CORE-14457 - Improve Automation Settings description & display of suggested cron command for external setup<br />
CORE-14458 - Correct import of Grace period for TLD Import & Sync<br />
CORE-14459 - Allow TLD Import & Sync to set Auto Register for existing TLDs with confirmation<br />
CORE-14462 - Ensure CC Capture succeeds when using the "Attempt CC Captures" link<br />
CORE-14471 - Correct parameters for single day duration on Sales Tax Liability report<br />
CORE-14475 - Correct display of non default pricing in TLD sync<br />
CORE-14476 - Prevent error from SaveQuote when no lineitems exist<br />
CORE-14478 - Improve messaging of currency display and converstion in TLD Sync<br />

== Modules ==
MODULE-7286 - Improve error handling for cPanel package change when using reseller credentials<br />
MODULE-7295 - Improve consistency of product detail and SSO for MarketConnect service<br />
MODULE-7296 - Display error message when no MarketConnect upgrade options are available<br />
MODULE-7326 - Auto invite Slack user to notification channel on setup or use<br />
MODULE-7327 - Create fallback routine to PayPal basic for Subscription Cancellation<br />
MODULE-7330 - Delete Stripe SEPA/ACH Webhook upon module deactivation<br />
MODULE-7333 - Add minor visual improvements for tld pricing window<br />
MODULE-7342 - Correct configuration validation routine for InternetBS<br />

== API ==
CORE-14452 - Provide attachment information for GetTicket API<br />
CORE-14453 - Implement GetTicketAttachment API<br />
CORE-14454 - Implement DeleteTicketReply API<br />
CORE-14455 - Implement BlockTicketSender API<br />
CORE-14456 - Implement MergeTicket API<br />

== Languages ==
CORE-14440 - Improvements for Hungarian translation<br />
CORE-14461 - Improvements for Hebrew translation<br />
CORE-14481 - Improvements for Admin Hebrew translation<br />

Version 7.10.0 Release Notes

2020-03-24T14:36:02Z

Chance:

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 7.10<br />
Release Type: RC<br />
Release Date: 24th March 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>7.10.0</td><td>Beta 1</td><td>12th March 2020</td></tr>
<tr><td>7.10.0</td><td>RC 1</td><td>24th March 2020</td></tr>

</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in Automatic Update utility.

Simply navigate to ''Utilities > Update WHMCS'' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click the Check for Updates button before the update will show as available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

== Release Notes ==

=== Registrar TLD & Pricing Sync ===
Import TLDs from your domain registrar for faster initial setup of TLDs and verification of prices. Perform a synchronization at any time to easily review and compare your current selling prices with cost prices from your registrar, as well as view and import TLDs that you are not currently selling. Sync options include automatically applying either a percentage or fixed monetary amount based markup with optional rounding to a number of your choice. Initial support includes Enom and all Logicboxes powered registrars, and developer documentation has been made available for integration into 3rd party and custom registrar modules.
[[Registrar_TLD_Sync|Learn more...]]

=== Cron Task Reporting ===
Get deeper insights into the actions and events that occur during automated cron tasks to give you a more complete picture of what's happened, and provide a faster and more convenient way to resolve things when they go wrong. New datapoints include information such as the invoices that are generated, invoices that have been attempted for capture, services that have been suspended or terminated and more. In the case of actions which involve communication with remote systems, the recorded data will indicate the success or failure of the action, and in the case of errors, provide the error message and direct shortcuts to allow you to easily resolve and retry the action.
[[Automation_Status#Cron_Task_Reporting|Learn more...]]

=== Knowledgebase Image Upload ===
Create rich and engaging knowledgebase articles with image upload functionality built directly into the article editor experience. Allows for uploading and re-use of recently uploaded images across multiple articles for added convenience.
[[Knowledgebase#Image_Uploading|Learn more...]]

=== Client Email Preferences ===
A new email preferences option in client profiles allows customers to choose the types of emails they wish to receive, enabling them to reduce noise and make better use of contacts and sub-accounts. Email preferences can be customised by customers themselves via the client area, or by admin level users, and more contextual and informative notification options make it easier for both clients and contacts to understand the email related settings.
[[Clients:Profile_Tab#Email_Notifications|Learn more...]]

=== Assigned User Ticket Filter ===
A new filter option has been made available in Support Tickets that allows you to filter tickets by assigned admin user.
[[Support_Tickets#Filter_Options|Ticket Filter Options]]

=== Update Service Ticket Association ===
Admin users can now set or alter the service associated with a support ticket. This new functionality allows admin users to modify (or in cases where none is selected by the customer, set) a related service, addon or domain for a support ticket.
[[Support_Tickets#Changing_Associated_Service|Learn more...]]

=== MarketConnect: MarketGoo SEO ===
Marketgoo is a self-service SEO tool which scans customers websites and gives them a simple report with easy to follow steps and recommendations to improve the search engine ranking of their website.
[[Marketgoo_via_WHMCS_MarketConnect|Learn more...]]

=== MarketConnect: Weebly Free Plan ===
We are pleased to announce the introduction of the Weebly Free Plan to MarketConnect. The new Free plan replaces Lite, and is designed to provide customers a free and easy way to get started with an online web presence. Available to all, and available to bundle by default with new hosting purchases, Weebly Free makes it easier for anyone to build a website, without any technical knowledge required.

=== Digicert Premium Certificates ===
DigiCert is discontinuing the sale of Symantec branded SSL Certificates. New DigiCert SSL Certificates have been launched that are a direct replacement for the previous Symantec SSL Certificates. On upgrade to WHMCS 7.10 if you have Symantec certificate selling enabled, all Symantec certificates will be replaced with their new DigiCert equivalents.
[[SSL_Certificates_via_WHMCS_MarketConnect|Learn more...]]

=== Single Sign-On Tokens ===
Single Sign-On tokens can now be generated for clients and sub-accounts using the API. The new CreateSsoToken API is a powerful yet simple mechanism for getting OAuth access tokens with automatic endpoint redirection. [[WHMCS Single Sign-On]]

== Deprecation & Removal Notices ==
===Modules===
During the v7.10.0 update, a one-time routine will inspect and attempt to remove the following modules
due to discontinued service by the service provider. Removal will only occur if the module is not actively in use.
The Activity Log will have a list of any removals. As well, if removal is not performed and the module remains
in your installation, an email will be generated to all full admins so that further investigation can be performed.
An inspection will be performed for the following modules:

* Gateways - Kuveytturk

===Other===
The [[AutoAuth]] client login feature is now deprecated. The [https://developers.whmcs.com/api-reference/createssotoken/ CreateSsoToken API] is a more robust and simpler mechanism for directing users from one authenticated system to a mapped client account within your WHMCS. AutoAuth will be completely removed from WHMCS no later than v8.1.

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* authorizenet/authorizenet: 1.9.6 to 1.9.7

== New Documentation ==

The following new documentation pages are available:

* [[Automation Status]] (Updated)
* [[Client Email Notification Preferences]]
* [[Client Management]] (Updated)
* [[Knowledgebase]] (Updated)
* [[MarketConnect]] (Updated)
* [[Marketgoo via WHMCS MarketConnect]]
* [[Registrar TLD Sync]]
* [[Support Tickets]] (Updated)
* [[Weebly via WHMCS MarketConnect]] (Updated)
* [[WHMCS Single Sign-On Developer Guide]] (Updated)

== Template Changes ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.9.2 and 7.10:
https://github.com/WHMCS/templates-six/compare/v7.9.2-release.1...v7.10.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.9.2 and 7.10:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.9.2-release.1...v7.10.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V7.10.0_Beta_1|Version 7.10.0 Beta 1]]
* [[Changelog:WHMCS_V7.10.0_RC_1|Version 7.10.0 RC 1]]

Version 7.10.0 Release Notes

2020-03-24T14:35:02Z

Chance:

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 7.10<br />
Release Type: RC<br />
Release Date: 24th March 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>7.10.0</td><td>Beta 1</td><td>12th March 2020</td></tr>
<tr><td>7.10.0</td><td>RC 1</td><td>24th March 2020</td></tr>

</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in Automatic Update utility.

Simply navigate to ''Utilities > Update WHMCS'' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click the Check for Updates button before the update will show as available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

== Release Notes ==

=== Registrar TLD & Pricing Sync ===
Import TLDs from your domain registrar for faster initial setup of TLDs and verification of prices. Perform a synchronization at any time to easily review and compare your current selling prices with cost prices from your registrar, as well as view and import TLDs that you are not currently selling. Sync options include automatically applying either a percentage or fixed monetary amount based markup with optional rounding to a number of your choice. Initial support includes Enom and all Logicboxes powered registrars, and developer documentation has been made available for integration into 3rd party and custom registrar modules.
[[Registrar_TLD_Sync|Learn more...]]

=== Cron Task Reporting ===
Get deeper insights into the actions and events that occur during automated cron tasks to give you a more complete picture of what's happened, and provide a faster and more convenient way to resolve things when they go wrong. New datapoints include information such as the invoices that are generated, invoices that have been attempted for capture, services that have been suspended or terminated and more. In the case of actions which involve communication with remote systems, the recorded data will indicate the success or failure of the action, and in the case of errors, provide the error message and direct shortcuts to allow you to easily resolve and retry the action.
[[Automation_Status#Cron_Task_Reporting|Learn more...]]

=== Knowledgebase Image Upload ===
Create rich and engaging knowledgebase articles with image upload functionality built directly into the article editor experience. Allows for uploading and re-use of recently uploaded images across multiple articles for added convenience.
[[Knowledgebase#Image_Uploading|Learn more...]]

=== Client Email Preferences ===
A new email preferences option in client profiles allows customers to choose the types of emails they wish to receive, enabling them to reduce noise and make better use of contacts and sub-accounts. Email preferences can be customised by customers themselves via the client area, or by admin level users, and more contextual and informative notification options make it easier for both clients and contacts to understand the email related settings.
[[Clients:Profile_Tab#Email_Notifications|Learn more...]]

=== Assigned User Ticket Filter ===
A new filter option has been made available in Support Tickets that allows you to filter tickets by assigned admin user.
[[Support_Tickets#Filter_Options|Ticket Filter Options]]

=== Update Service Ticket Association ===
Admin users can now set or alter the service associated with a support ticket. This new functionality allows admin users to modify (or in cases where none is selected by the customer, set) a related service, addon or domain for a support ticket.
[[Support_Tickets#Changing_Associated_Service|Learn more...]]

=== MarketConnect: MarketGoo SEO ===
Marketgoo is a self-service SEO tool which scans customers websites and gives them a simple report with easy to follow steps and recommendations to improve the search engine ranking of their website.
[[Marketgoo_via_WHMCS_MarketConnect|Learn more...]]

=== MarketConnect: Weebly Free Plan ===
We are pleased to announce the introduction of the Weebly Free Plan to MarketConnect. The new Free plan replaces Lite, and is designed to provide customers a free and easy way to get started with an online web presence. Available to all, and available to bundle by default with new hosting purchases, Weebly Free makes it easier for anyone to build a website, without any technical knowledge required.

=== Digicert Premium Certificates ===
DigiCert is discontinuing the sale of Symantec branded SSL Certificates. New DigiCert SSL Certificates have been launched that are a direct replacement for the previous Symantec SSL Certificates. On upgrade to WHMCS 7.10 if you have Symantec certificate selling enabled, all Symantec certificates will be replaced with their new DigiCert equivalents.
[[SSL_Certificates_via_WHMCS_MarketConnect|Learn more...]]

=== Single Sign-On Tokens ===
Single Sign-On tokens can now be generated for clients and sub-accounts using the API. The new CreateSsoToken API is a powerful yet simple mechanism for getting OAuth access tokens with automatic endpoint redirection. [[WHMCS Single Sign-On]]

== Deprecation & Removal Notices ==
===Modules===
During the v7.10.0 update, a one-time routine will inspect and attempt to remove the following modules
due to discontinued service by the service provider. Removal will only occur if the module is not actively in use.
The Activity Log will have a list of any removals. As well, if removal is not performed and the module remains
in your installation, an email will be generated to all full admins so that further investigation can be performed.
An inspection will be performed for the following modules:

* Gateways - Kuveytturk

===Other===
The [[AutoAuth]] client login feature is now deprecated. The [https://developers.whmcs.com/api-reference/createssotoken/ CreateSsoToken API] is a more robust and simpler mechanism for directing users from one authenticated system to a mapped client account within your WHMCS. AutoAuth will be completely removed from WHMCS no later than v8.1.

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* authorizenet/authorizenet: 1.9.6 to 1.9.7

== New Documentation ==

The following new documentation pages are available:

* [[Automation Status]] (Updated)
* [[Client Email Notification Preferences]]
* [[Client Management]] (Updated)
* [[Knowledgebase]] (Updated)
* [[MarketConnect]] (Updated)
* [[Marketgoo via WHMCS MarketConnect]]
* [[Registrar TLD Sync]]
* [[Support Tickets]] (Updated)
* [[Weebly via WHMCS MarketConnect]] (Updated)
* [[WHMCS Single Sign-On Developer Guide]] (Updated)
* [https://developers.whmcs.com/api-reference/createssotoken/ API: CreateSsoToken]
* [https://developers.whmcs.com/api-reference/createorupdatetld/ API: CreateOrUpdateTLD]

== Template Changes ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.9.2 and 7.10:
https://github.com/WHMCS/templates-six/compare/v7.9.2-release.1...v7.10.0-rc.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.9.2 and 7.10:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.9.2-release.1...v7.10.0-rc.1

== Changelog ==
* [[Changelog:WHMCS_V7.10.0_Beta_1|Version 7.10.0 Beta 1]]
* [[Changelog:WHMCS_V7.10.0_RC_1|Version 7.10.0 RC 1]]

Version 7.10.0 Release Notes

2020-03-24T14:34:31Z

Chance: /* Version History */

<div class="docs-alert-info" style="max-width:370px;">
<span class="title">Release Information</span>
<br />
Version: 7.10<br />
Release Type: Beta<br />
Release Date: 12th March 2020<br />
Distribution Types: Full and Via Automatic Updater
</div>

==Version History==

<table class="table table-striped">
<tr><td>7.10.0</td><td>Release Candidate 1</td><td>24th March 2020</td></tr>
<tr><td>7.10.0</td><td>Beta 1</td><td>12th March 2020</td></tr>

</table>

==Download==
Download the latest version of WHMCS from https://download.whmcs.com/

==Upgrade Process==
[[Upgrading|View Standard Upgrade Steps]]

===Automatic Updating===
If you are running WHMCS 7.0 or later, you can use the built-in Automatic Update utility.

Simply navigate to ''Utilities > Update WHMCS'' to begin the process.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i> If the update was released recently, you may need to click the Check for Updates button before the update will show as available.
</div>

For more information about updating, please refer to the [[Automatic Updater]] documentation.

== Release Notes ==

=== Registrar TLD & Pricing Sync ===
Import TLDs from your domain registrar for faster initial setup of TLDs and verification of prices. Perform a synchronization at any time to easily review and compare your current selling prices with cost prices from your registrar, as well as view and import TLDs that you are not currently selling. Sync options include automatically applying either a percentage or fixed monetary amount based markup with optional rounding to a number of your choice. Initial support includes Enom and all Logicboxes powered registrars, and developer documentation has been made available for integration into 3rd party and custom registrar modules.
[[Registrar_TLD_Sync|Learn more...]]

=== Cron Task Reporting ===
Get deeper insights into the actions and events that occur during automated cron tasks to give you a more complete picture of what's happened, and provide a faster and more convenient way to resolve things when they go wrong. New datapoints include information such as the invoices that are generated, invoices that have been attempted for capture, services that have been suspended or terminated and more. In the case of actions which involve communication with remote systems, the recorded data will indicate the success or failure of the action, and in the case of errors, provide the error message and direct shortcuts to allow you to easily resolve and retry the action.
[[Automation_Status#Cron_Task_Reporting|Learn more...]]

=== Knowledgebase Image Upload ===
Create rich and engaging knowledgebase articles with image upload functionality built directly into the article editor experience. Allows for uploading and re-use of recently uploaded images across multiple articles for added convenience.
[[Knowledgebase#Image_Uploading|Learn more...]]

=== Client Email Preferences ===
A new email preferences option in client profiles allows customers to choose the types of emails they wish to receive, enabling them to reduce noise and make better use of contacts and sub-accounts. Email preferences can be customised by customers themselves via the client area, or by admin level users, and more contextual and informative notification options make it easier for both clients and contacts to understand the email related settings.
[[Clients:Profile_Tab#Email_Notifications|Learn more...]]

=== Assigned User Ticket Filter ===
A new filter option has been made available in Support Tickets that allows you to filter tickets by assigned admin user.
[[Support_Tickets#Filter_Options|Ticket Filter Options]]

=== Update Service Ticket Association ===
Admin users can now set or alter the service associated with a support ticket. This new functionality allows admin users to modify (or in cases where none is selected by the customer, set) a related service, addon or domain for a support ticket.
[[Support_Tickets#Changing_Associated_Service|Learn more...]]

=== MarketConnect: MarketGoo SEO ===
Marketgoo is a self-service SEO tool which scans customers websites and gives them a simple report with easy to follow steps and recommendations to improve the search engine ranking of their website.
[[Marketgoo_via_WHMCS_MarketConnect|Learn more...]]

=== MarketConnect: Weebly Free Plan ===
We are pleased to announce the introduction of the Weebly Free Plan to MarketConnect. The new Free plan replaces Lite, and is designed to provide customers a free and easy way to get started with an online web presence. Available to all, and available to bundle by default with new hosting purchases, Weebly Free makes it easier for anyone to build a website, without any technical knowledge required.

=== Digicert Premium Certificates ===
DigiCert is discontinuing the sale of Symantec branded SSL Certificates. New DigiCert SSL Certificates have been launched that are a direct replacement for the previous Symantec SSL Certificates. On upgrade to WHMCS 7.10 if you have Symantec certificate selling enabled, all Symantec certificates will be replaced with their new DigiCert equivalents.
[[SSL_Certificates_via_WHMCS_MarketConnect|Learn more...]]

== Deprecation & Removal Notices ==
During the v7.10.0 update, a one-time routine will inspect and attempt to remove the following modules
due to discontinued service by the service provider. Removal will only occur if the module is not actively in use.
The Activity Log will have a list of any removals. As well, if removal is not performed and the module remains
in your installation, an email will be generated to all full admins so that further investigation can be performed.
An inspection will be performed for the following modules:

* Gateways - Kuveytturk

== Library Updates ==

The following libraries have been updated or removed:

=== PHP ===
* authorizenet/authorizenet: 1.9.6 to 1.9.7

== New Documentation ==

The following new documentation pages are available:

* [[Automation Status]] (Updated)
* [[Client Email Notification Preferences]]
* [[Client Management]] (Updated)
* [[Knowledgebase]] (Updated)
* [[MarketConnect]] (Updated)
* [[Marketgoo via WHMCS MarketConnect]]
* [[Registrar TLD Sync]]
* [[Support Tickets]] (Updated)
* [[Weebly via WHMCS MarketConnect]] (Updated)

== Template Changes ==

For a list of changed files and a graphical view of the exact changes, please refer to the Github repo's below.

=== Six Template ===

The following link provides a comparison of changes between 7.9.2 and 7.10:
https://github.com/WHMCS/templates-six/compare/v7.9.2-release.1...v7.10.0-beta.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 7.9.2 and 7.10:
https://github.com/WHMCS/orderforms-standard_cart/compare/v7.9.2-release.1...v7.10.0-beta.1

== Changelog ==
* [[Changelog:WHMCS_V7.10.0_Beta_1|Version 7.10.0 Beta 1]]

Automation Status

2020-03-12T17:08:37Z

Chance: /* Cron Task Reporting */

<div class="docs-alert-info"><i class="fa fa-info-circle"></i> This page describes a feature available in version 7.1 and above</div>

The Automation Status page gives you insights and information about the daily automation activity that occurs in WHMCS. It provides a way of viewing and monitoring automation activity over time, allowing you to see trends and identify any issues more easily.

==How to use it==

To view the automation status, click any summary graph shown in the Automation Overview widget on the admin dashboard. Or alternatively navigate to ''Utilities > System > Automation Status''.

Upon first visiting the Automation Status page, you will be shown a summary of invoice generation activity for the last 7 days, and the results and totals from the current day's automation tasks.

You can browse to earlier days by using the arrow keys, or selecting a date from the calendar.

[[File:AutomationStatusPage.png]]

<div class="docs-alert-info">Be aware that historic automation activity information will only start being recorded from the day you upgrade to WHMCS 7.1 or later</div>

==Available Information==
The page details items completed by a cron run for the selected date:
* '''Invoices''' - The count of invoices generated.
* '''Late Fees''' - The count of late fees applied to invoices.
* '''Credit Cards''' - The count of successful and declined credit card attempts.
* '''Invoice & Overdue Reminders''' - The count of any invoice and overdue reminders sent.
* '''Cancellation Requests''' - The count of any processed cancellation requests. This also details the failed requests.
* '''Overdue Suspensions''' - The count of successful and failed suspensions.
* '''Overdue Terminations''' - The count of successful and failed terminations.
* '''Fixed Term Terminations''' - The count of terminations defined by a product configuration.
* '''Domain Renewal Notices''' - The count of any domain renewal emails sent.
* '''Inactive Tickets''' - The count of inactive tickets closed.
* '''Delayed Affiliate Commissions''' - The count of commissions applied.
* '''Email Marketer Rules''' - The count of emails sent for the marketer.
* '''Database Backup''' - Was the last database backup setup.
* '''WHMCS Updates''' - Was the check for Updates successful?
* '''Currency Exchange Rates''' - Was the currency exchange rate update successful?
* '''Product Pricing Updates''' - Was the update of product pricing successful?
* '''Server Usage Stats''' - Did the usage information update?

==Failed Actions==
If you see a number marked as failed items, this indicates some items failed to complete successfully.

In the case of credit card captures declining, these will be retried automatically based upon your settings defined in ''Setup > Automation Settings''.

For failure items relating to Suspensions, Terminations, Cancellations, etc..., these will be retried daily until successful. They will also be added to the Module Queue from where you can view and resolve them. See the [[Module Queue]] page for more information.

==Historic Data and Trends==
The graph allows you to view a number of the task metrics over time.

By default the current week is displayed showing the number of invoices generated each day. You can choose other metrics and also choose from timeline options including the previous week, this month and last month.

Historic data is purged periodically.

[[File:automation-status-graph-new.png|600px]]

== Cron Task Reporting ==
<div class="docs-alert-info"><i class="fa fa-info-circle"></i> This section describes features available in version 7.10 and above</div>

From the first daily cron run after upgrading to WHMCS 7.10, detailed information about actions completed will be saved and available in WHMCS.

From the Automation Status Page clicking on the Cron Task boxes will open a modal that will detail the actions that completed successfully or failed with a link to the appropriate location in WHMCS.

The following table lists the cron tasks that have additional detail:

{| class="table table-striped"
! Task Name
! Logs
! Additional Links
! Notes
|-
| Invoices
|| A list of invoices generated via the cron run
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Invoice & Overdue Reminders
|| A list of reminders sent separated by type
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Late Fees
|| A list of invoices that had a late fee added
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Credit Card Charges
|| A list of attempted payments whether successful or failed
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
The error message is the latest decline reason
|-
| Cancellation Requests
|| A list of services that had a cancellation request processed separated by success and failure
||
* To Invoice using ID and Edit icon
* To client using client name
* To the [[ModuleLog|Module Log]] for the failed task if unresolved
|| The status is the current status of the service
The error message is message that occurred on cron run.
|-
| Overdue Suspensions
|| A list of suspensions attempted separated by success and failure
||
*To the service/addon using the ID and Edit icon
*To the client using client name
*To the [[ModuleLog|Module Log]] for the failed task if unresolved
||
*The status is the current status of the service/addon
*The error message is message that occurred on cron run.
|-
| Overdue Terminations
|| A list of terminations attempted separated by success and failure
||
*To the service/addon using the ID and Edit icon
*To the client using client name
*To the [[ModuleLog|Module Log]] for the failed task if unresolved
||
*The status is the current status of the service/addon
*The error message is message that occurred on cron run.
|-
| Fixed Term Terminations
|| A list of fixed term terminations attempted separated by success and failure
||
*To the service/addon using the ID and Edit icon
*To the client using client name
*To the [[ModuleLog|Module Log]] for the failed task if unresolved
||
*The status is the current status of the service/addon
*The error message is message that occurred on cron run.
|-
| Domain Renewal Notices
||A list of domains that a renewal notice was sent for. Separated into first to fifth and also lists emails that failed to send
||
* To Domain using ID and Edit icon
* To client using client name
||The status is the current status of the domain
|-
| Inactive Tickets
|| A list of tickets automatically closed due to inactivity
||
* To Ticket using ID and Edit icon
* To client using client name (if a registered client)
|| The status is the current status of the ticket
|-
| Client Status Update
|| A list of clients updated separated by status being set
|| To the client using the id, client name, and edit icon
|| The status is the current status of the client
|}

Automation Status

2020-03-12T16:17:36Z

Chance: /* Cron Task Reporting */

<div class="docs-alert-info"><i class="fa fa-info-circle"></i> This page describes a feature available in version 7.1 and above</div>

The Automation Status page gives you insights and information about the daily automation activity that occurs in WHMCS. It provides a way of viewing and monitoring automation activity over time, allowing you to see trends and identify any issues more easily.

==How to use it==

To view the automation status, click any summary graph shown in the Automation Overview widget on the admin dashboard. Or alternatively navigate to ''Utilities > System > Automation Status''.

Upon first visiting the Automation Status page, you will be shown a summary of invoice generation activity for the last 7 days, and the results and totals from the current day's automation tasks.

You can browse to earlier days by using the arrow keys, or selecting a date from the calendar.

[[File:AutomationStatusPage.png]]

<div class="docs-alert-info">Be aware that historic automation activity information will only start being recorded from the day you upgrade to WHMCS 7.1 or later</div>

==Available Information==
The page details items completed by a cron run for the selected date:
* '''Invoices''' - The count of invoices generated.
* '''Late Fees''' - The count of late fees applied to invoices.
* '''Credit Cards''' - The count of successful and declined credit card attempts.
* '''Invoice & Overdue Reminders''' - The count of any invoice and overdue reminders sent.
* '''Cancellation Requests''' - The count of any processed cancellation requests. This also details the failed requests.
* '''Overdue Suspensions''' - The count of successful and failed suspensions.
* '''Overdue Terminations''' - The count of successful and failed terminations.
* '''Fixed Term Terminations''' - The count of terminations defined by a product configuration.
* '''Domain Renewal Notices''' - The count of any domain renewal emails sent.
* '''Inactive Tickets''' - The count of inactive tickets closed.
* '''Delayed Affiliate Commissions''' - The count of commissions applied.
* '''Email Marketer Rules''' - The count of emails sent for the marketer.
* '''Database Backup''' - Was the last database backup setup.
* '''WHMCS Updates''' - Was the check for Updates successful?
* '''Currency Exchange Rates''' - Was the currency exchange rate update successful?
* '''Product Pricing Updates''' - Was the update of product pricing successful?
* '''Server Usage Stats''' - Did the usage information update?

==Failed Actions==
If you see a number marked as failed items, this indicates some items failed to complete successfully.

In the case of credit card captures declining, these will be retried automatically based upon your settings defined in ''Setup > Automation Settings''.

For failure items relating to Suspensions, Terminations, Cancellations, etc..., these will be retried daily until successful. They will also be added to the Module Queue from where you can view and resolve them. See the [[Module Queue]] page for more information.

==Historic Data and Trends==
The graph allows you to view a number of the task metrics over time.

By default the current week is displayed showing the number of invoices generated each day. You can choose other metrics and also choose from timeline options including the previous week, this month and last month.

Historic data is purged periodically.

[[File:automation-status-graph-new.png|600px]]

== Cron Task Reporting ==
<div class="docs-alert-info"><i class="fa fa-info-circle"></i> This section describes features available in version 7.10 and above</div>

From the first daily cron run after upgrading to WHMCS 7.10, detailed information about actions completed will be saved and available in WHMCS.

From the Automation Status Page clicking on the Cron Task boxes will open a modal that will detail the actions that completed successfully or failed with a link to the appropriate location in WHMCS.

The following table lists the cron tasks that have additional detail:

{| class="table table-striped"
! Task Name
! Logs
! Additional Links
! Notes
|-
| Invoices
|| A list of invoices generated via the cron run
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Invoice & Overdue Reminders
|| A list of reminders sent separated by type
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Late Fees
|| A list of invoices that had a late fee added
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Credit Card Charges
|| A list of attempted payments whether successful or failed
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
The error message is the latest decline reason
|-
| Cancellation Requests
|| A list of services that had a cancellation request processed separated by success and failure
||
* To Invoice using ID and Edit icon<br />
* To client using client name <br />
* To the [[ModuleLog|Module Log]] for the failed task if unresolved
|| The status is the current status of the service
The error message is message that occurred on cron run.
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
|}

Changelogs

2020-03-12T16:14:49Z

Chance: /* WHMCS */

Our changelogs provide details about additions, updates and fixes in each version of our software.

==WHMCS==

<table style="width:100%"><tr><td width="50%" valign="top">

*[[Changelog:WHMCS V7.10|Version 7.10]]
*[[Changelog:WHMCS V7.9|Version 7.9]]
*[[Changelog:WHMCS V7.8|Version 7.8]]
*[[Changelog:WHMCS V7.7|Version 7.7]]
*[[Changelog:WHMCS V7.6|Version 7.6]]
*[[Changelog:WHMCS V7.5|Version 7.5]]
*[[Changelog:WHMCS V7.4|Version 7.4]]
*[[Changelog:WHMCS V7.3|Version 7.3]]
*[[Changelog:WHMCS V7.2|Version 7.2]]
*[[Changelog:WHMCS V7.1|Version 7.1]]

</td><td width="50%" valign="top">

*[[Changelog:WHMCS V7.0|Version 7.0]]
*[[Changelog:WHMCS V6.3|Version 6.3]]
*[[Changelog:WHMCS V6.2|Version 6.2]]
*[[Changelog:WHMCS V6.1|Version 6.1]]
*[[Changelog:WHMCS V6.0|Version 6.0]]
*[[Changelog:WHMCS V5.3|Version 5.3]]
*[[Changelog:WHMCS V5.2|Version 5.2]]
*[[Changelog:WHMCS V5.1|Version 5.1]]
*[[Changelog:WHMCS V5.0|Version 5.0]]

</td></tr></table>

==Addons==

<table style="width:100%"><tr><td width="50%" valign="top">

===Project Management===
*[[Changelog:Project Management V2.2|Version 2.2]]
*[[Changelog:Project Management V2.1|Version 2.1]]
*[[Changelog:Project Management V2.0|Version 2.0]]
*[[Changelog:Project Management V1.1|Version 1.1]]
*[[Changelog:Project Management V1.0|Version 1.0]]

===Licensing Addon===

*[[Changelog:Licensing Addon V3.0|Version 3.0]]

===Live Chat & Visitor Tracking Addon===

*[[Changelog:Live Chat V4.1|Version 4.1]]
*[[Changelog:Live Chat V4.0|Version 4.0]]

</td><td width="50%" valign="top">

===iWHMCS iPhone App===

*[[Changelog:iWHMCS V2.2|Version 2.2]]
*[[Changelog:iWHMCS V2.1|Version 2.1]]
*[[Changelog:iWHMCS V2.0|Version 2.0]]

===aWHMCS Android App===

*[[Changelog:aWHMCS V2.8|Version 2.8]]
*[[Changelog:aWHMCS V2.6|Version 2.6]]
*[[Changelog:aWHMCS V2.5|Version 2.5]]

</td></tr></table>

__NOTOC__

Changelog:WHMCS V7.10.0 Beta 1

2020-03-12T16:13:27Z

Chance: /* Modules */

Changelog:WHMCS V7.10.0 Beta 1

2020-03-12T16:13:02Z

Chance: /* Maintenance */

<noinclude>[[Version 7.10.0 Release Notes]]</noinclude>

== Implemented ==
FEATURE-2180 - MarketConnect: Introduce Marketgoo SEO Service Offering<br />
FEATURE-2182 - Add Image Upload to Knowledgebase Article Editor<br />
FEATURE-2186 - Add Assigned Admin search field in ticket search<br />
FEATURE-2237 - Provide UI for Admin to alter the associated service for a support ticket<br />
FEATURE-2238 - Add TLD Import & Pricing Sync Tool for Domain Registrars<br />
FEATURE-2245 - Add Additional Cron Task Action & Event Logging<br />
FEATURE-2249 - Provide Email Preferences for primary client profile users<br />
FEATURE-2253 - MarketConnect: Introduce the Weebly Free Plan<br />
FEATURE-2263 - Add Cron Task Reporting to Automation Status UI<br />
FEATURE-2266 - Add TLD Import & Pricing Sync support to Enom module<br />
FEATURE-2268 - Add TLD Import & Pricing Sync support to ResellerClub/Logicboxes modules<br />

== Maintenance ==
ADDON-5957 - Ensure Bulk Pricing Updater does not affect secondary TLDs<br />    Also known as: ADDON-6008, MODULE-7305<br />
ADDON-6117 - Add Module Debug Logging to PayPal Transaction Lookup<br />
CORE-10554 - Improve efficiency of cart.php with large amount of configurable options<br />
CORE-13545 - Correct calculation for "Auto recalculate on save" option on service in system with inclusive tax for tax exempt client <br />
CORE-13616 - Correct invisible recaptcha and field validation order precedence<br />
CORE-13885 - Improve Server Sync Tool reseller package name detection<br />
CORE-14028 - Prevent Auto Client Status Sync from deactivating clients with recurring billable items<br />
CORE-14033 - Ensure Status Change Event Notifcation is triggered by actioned escalation rule <br />
CORE-14071 - Remove reference to jQueryUI in Modern orderform<br />
CORE-14109 - Update SpamExperts logo<br />
CORE-14120 - Show translated support department name on submitticket.php as guest<br />
CORE-14124 - Ensure translated KB articles are not returned in search results if language is not selected<br />
CORE-14132 - Ensure server group save retains associated servers<br />
CORE-14139 - Correct language key used for billable item descriptions<br />
CORE-14157 - Correct generated links for Current Quotes on Client Summary<br />
CORE-14163 - Prevent erroneous error for case changes to email address in client area<br />
CORE-14178 - Ensure Escalation Rules can manage custom ticket status with comma character<br />
CORE-14181 - Optimize Usage Billing data collection from cPanel<br />
CORE-14190 - Update GoDaddy logo<br />
CORE-14192 - Ensure credit applied to invoice shows on Credit Reviewer Report<br />
CORE-14200 - Improve Admin login button generation for Centovacast<br />
CORE-14201 - Translate "Stage" on Quotes page<br />
CORE-14205 - Correct PDF invoice line item generation for domain names of transliterated equivalence<br />
CORE-14209 - Improve duration description of Client For on new clients<br />
CORE-14219 - Improve SSL Certificate Monitoring report aggregation<br />
CORE-14227 - Improve WHMCS\Domain\Registrar\Domain class documentation<br />
CORE-14231 - Add health check to warning when directories expected to be restricted are browseable<br />
CORE-14245 - Ensure checkout preselects default payment method<br />
CORE-14250 - Allow configuration of suggest TLD list for registrar based lookup providers<br />
CORE-14264 - Gracefully redirect when attempting to view a nonexistent product in Admin area<br />
CORE-14269 - Perform appropriate redirect with directly referencing cart fraud check URL<br />
CORE-14272 - Translate "Email Sent" for client area email verification status/button<br />
CORE-14276 - Improve checkout redirect for remote input gateway<br />
CORE-14278 - Add {$service_subscription_id} merge field for product/service e-mail templates<br />
CORE-14289 - Minor styling improvements for Admin download management<br />
CORE-14294 - New UI/UX for Email Marketer<br />
CORE-14307 - Prevent erroneous deletion block of pay method when associated to a nonexistent billing contact<br />
CORE-14311 - Ensure both payment and overpayment on a Add Funds invoice is applied to client account<br />
CORE-14313 - Correct displayed price for upgrade orders with 100% discount promo<br />    Also known as: CORE-14325<br />
CORE-14315 - Improve knowledgebase tag search<br />    Also known as: CORE-14330<br />
CORE-14316 - Correct disk & bandwidth metrics on cPanel<br />CORE-14319 - Prevent error when using a Duotone FontAwesome icon is custom sidebar<br />
CORE-14331 - Correct typo in Credit Card Expiring Soon email template<br />    Also known as: CORE-14332<br />
CORE-14372 - MarketConnect: Introduce new DigiCert SSL Certificates<br />
PMA-155 - Correct data range usage for Staff Logs Report<br />
PMA-156 - Correct version in manifest file<br />

== Modules ==
MODULE-6567 - Correct package change for cPanel reseller accounts<br /> Also known as: MODULE-7233<br />
MODULE-7237 - Improve error message on Plaid failure<br />
MODULE-7240 - Improve error handling if Stripe and Plaid have not been linked<br />
MODULE-7255 - Update Slack integration to utilize their Conversations API<br />
MODULE-7265 - Improve accuracy of rounded percentage saving on VPN landing page<br />
MODULE-7267 - Correct logo overflow in MarketConnect landing pages<br />
MODULE-7271 - Update Authorize.net cert.pem file<br />
MODULE-7280 - Ensure Slack notification recieves correct entity encoding for URL parameter<br /> Also known as: INTDESK-6072<br />
MODULE-7294 - Remove erroneous country restriction for PayPal account linking<br />
MODULE-7302 - Correct cPanel API usage for changing reseller package<br />
MODULE-7303 - Remove Kuveytturk gateway module<br />
MODULE-7306 - Correct disk & bandwidth metrics for resellers on DirectAdmin<br />
MODULE-7308 - Improve feedback for ResellerClub disallowed IP error<br />
MODULE-7309 - Prevent fatal error when collecting cPanel reseller stats with underprivileged API credentials<br />

== Languages ==
CORE-14248 - Improve Turkish translation<br />

Automation Status

2020-03-12T16:04:10Z

Chance: /* Cron Task Reporting */

<div class="docs-alert-info"><i class="fa fa-info-circle"></i> This page describes a feature available in version 7.1 and above</div>

The Automation Status page gives you insights and information about the daily automation activity that occurs in WHMCS. It provides a way of viewing and monitoring automation activity over time, allowing you to see trends and identify any issues more easily.

==How to use it==

To view the automation status, click any summary graph shown in the Automation Overview widget on the admin dashboard. Or alternatively navigate to ''Utilities > System > Automation Status''.

Upon first visiting the Automation Status page, you will be shown a summary of invoice generation activity for the last 7 days, and the results and totals from the current day's automation tasks.

You can browse to earlier days by using the arrow keys, or selecting a date from the calendar.

[[File:AutomationStatusPage.png]]

<div class="docs-alert-info">Be aware that historic automation activity information will only start being recorded from the day you upgrade to WHMCS 7.1 or later</div>

==Available Information==
The page details items completed by a cron run for the selected date:
* '''Invoices''' - The count of invoices generated.
* '''Late Fees''' - The count of late fees applied to invoices.
* '''Credit Cards''' - The count of successful and declined credit card attempts.
* '''Invoice & Overdue Reminders''' - The count of any invoice and overdue reminders sent.
* '''Cancellation Requests''' - The count of any processed cancellation requests. This also details the failed requests.
* '''Overdue Suspensions''' - The count of successful and failed suspensions.
* '''Overdue Terminations''' - The count of successful and failed terminations.
* '''Fixed Term Terminations''' - The count of terminations defined by a product configuration.
* '''Domain Renewal Notices''' - The count of any domain renewal emails sent.
* '''Inactive Tickets''' - The count of inactive tickets closed.
* '''Delayed Affiliate Commissions''' - The count of commissions applied.
* '''Email Marketer Rules''' - The count of emails sent for the marketer.
* '''Database Backup''' - Was the last database backup setup.
* '''WHMCS Updates''' - Was the check for Updates successful?
* '''Currency Exchange Rates''' - Was the currency exchange rate update successful?
* '''Product Pricing Updates''' - Was the update of product pricing successful?
* '''Server Usage Stats''' - Did the usage information update?

==Failed Actions==
If you see a number marked as failed items, this indicates some items failed to complete successfully.

In the case of credit card captures declining, these will be retried automatically based upon your settings defined in ''Setup > Automation Settings''.

For failure items relating to Suspensions, Terminations, Cancellations, etc..., these will be retried daily until successful. They will also be added to the Module Queue from where you can view and resolve them. See the [[Module Queue]] page for more information.

==Historic Data and Trends==
The graph allows you to view a number of the task metrics over time.

By default the current week is displayed showing the number of invoices generated each day. You can choose other metrics and also choose from timeline options including the previous week, this month and last month.

Historic data is purged periodically.

[[File:automation-status-graph-new.png|600px]]

== Cron Task Reporting ==
<div class="docs-alert-info"><i class="fa fa-info-circle"></i> This section describes features available in version 7.10 and above</div>

From the first daily cron run after upgrading to WHMCS 7.10, detailed information about actions completed will be saved and available in WHMCS.

From the Automation Status Page clicking on the Cron Task boxes will open a modal that will detail the actions that completed successfully or failed with a link to the appropriate location in WHMCS.

The following table lists the cron tasks that have additional detail:

{| class="table table-striped"
! Task Name
! Logs
! Additional Links
! Notes
|-
| Invoices
|| A list of invoices generated via the cron run
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Invoice & Overdue Reminders
|| A list of reminders sent separated by type
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Late Fees
|| A list of invoices that had a late fee added
||
*To Invoice using ID and Edit icon
*To client using client name
|| The invoice status is the current invoice status
|-
| Credit Card Charges
|| A list of attempted payments whether successful or failed
|| To Invoice using ID and Edit icon
To client using client name
||
*The invoice status is the current invoice status
*The error message is the latest decline reason
|-
| Cancellation Requests
|| A list of services that had a cancellation request processed separated by success and failure
||
* To Invoice using ID and Edit icon<br />
* To client using client name <br />
* To the [[ModuleLog|Module Log]] for the failed task if unresolved
|| The status is the current status of the service
The error message is message that occurred on cron run.
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
| Value || Value || Value || Value
|-
|}