Difference between revisions of "Version 8.5 Release Notes"

From WHMCS Documentation

(Created page with "<div class="docs-alert-info" style="max-width:370px;"> <span class="title">Release Information</span> <br /> Version: 8.5<br /> Release Type: Beta<br /> Latest Update: 20th Ap...")
 
 
(28 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
<span class="title">Release Information</span>
 
<span class="title">Release Information</span>
 
<br />
 
<br />
Version: 8.5<br />
+
Version: 8.5.2<br />
Release Type: Beta<br />
+
Release Type: Security<br />
Latest Update: 20th April 2022<br />
+
Latest Update: 30th November 2022<br />
 
Distribution Types: Full and Via Automatic Updater
 
Distribution Types: Full and Via Automatic Updater
 
</div>
 
</div>
Line 12: Line 12:
 
<table class="table table-striped">
 
<table class="table table-striped">
 
<tr><td>8.5.0</td><td>Beta 1</td><td>20th April 2022</td></tr>
 
<tr><td>8.5.0</td><td>Beta 1</td><td>20th April 2022</td></tr>
 +
<tr><td>8.5.0</td><td>Release Candidate 1</td><td>13th May 2022</td></tr>
 +
<tr><td>8.5.0</td><td>General Availability</td><td>9th June 2022</td></tr>
 +
<tr><td>8.5.1</td><td>Maintenance</td><td>15th June 2022</td></tr>
 +
<tr><td>8.5.2</td><td>Security</td><td>30th November 2022</td></tr>
 
</table>
 
</table>
 
</onlyinclude>
 
</onlyinclude>
Line 43: Line 47:
 
== Release Notes ==
 
== Release Notes ==
  
=== cPanel SEO via MarketConnect ===  
+
=== cPanel SEO via MarketConnect ===
 
   
 
   
You can now offer a powerful SEO tool to help clients optimize their website content and reach the top rankings in Google®'s search results. MarketConnect and WHMCS automatically handle provisioning, renewals, and upgrades between two high-value plans.
+
You can now offer cPanel SEO, a tool to help clients optimize their website content and reach the top rankings in Google®'s search results. MarketConnect and WHMCS automatically handle provisioning, renewals, and upgrades between two plans.
 
   
 
   
 
[[cPanel SEO via WHMCS MarketConnect|Learn More...]]
 
[[cPanel SEO via WHMCS MarketConnect|Learn More...]]
Line 51: Line 55:
 
=== Multi-Year SSL Orders with DigiCert via MarketConnect ===
 
=== Multi-Year SSL Orders with DigiCert via MarketConnect ===
 
   
 
   
You can now offer two-year or three-year DigiCert SSL certificate orders through MarketConnect. WHMCS will automatically handle reissuance and reinstallation throughout the order period, including automated emails and renewals.
+
You can now offer two-year and three-year DigiCert SSL certificate orders through MarketConnect. WHMCS will automatically handle reissuance and reinstallation throughout the length of the order, including automated emails and renewals.
 +
 
 +
WHMCS installations should not have existing pricing for multi-year certificates. However, if your installation already specifies custom prices for them, the update process may overwrite them.
 
   
 
   
 
[[SSL Certificates via WHMCS MarketConnect|Learn More...]]
 
[[SSL Certificates via WHMCS MarketConnect|Learn More...]]
+
 
 
=== Client Area Home Page SSO ===
 
=== Client Area Home Page SSO ===
 +
 
 +
Clients can now use single sign-on (SSO) to access their active services directly from the main page of the Client Area Home Page. Due to this addition, it is now possible to [[Working With Client Area Home Page Panels|create custom Client Area Home Page panels]] that span both columns of the desktop web browser page layout.
 
   
 
   
Clients can now use single sign-on to access their active services directly from the main Client Area Home Page. Due to this addition, it is now possible to [[Working With Client Area Home Page Panels|create custom Client Area Home Page panels]] that span both columns of the desktop web browser page layout.
+
=== Custom Actions ===
 
   
 
   
 +
In the WHMCS 8.5.0 RC 1 release and later, custom actions are available for use in provisioning modules. The <tt>[https://developers.whmcs.com/provisioning-modules/custom-actions/ CustomAction]</tt> object lets developers define items that can perform actions and then redirect the user to a defined URI. Currently, you can use this to define a list of SSO items that will display on the Client Area Home Page.
 +
 +
<div class="docs-alert-warning">
 +
<span class="title">SSO Links</span><br />
 +
Due to these changes, you may need to update custom hooks that use menu item methods (for example, the <tt>getChild()</tt> and <tt>removeChild()</tt> methods) and the menu item names for existing SSO buttons may have changed. For example, the <tt>Log In to cPanel</tt> menu item in WHMCS 8.4 and earlier is now the <tt>cpanel</tt> menu item.
 +
</div>
 +
 +
[https://developers.whmcs.com/provisioning-modules/custom-actions/ Learn More...]
 +
 
=== Shopping Cart Cross-selling ===
 
=== Shopping Cart Cross-selling ===
 
   
 
   
 
You can now configure cross-selling to display recommendations when customers add a related item to the shopping cart. You can control recommendation locations, content, and appearance as well as individually configuring the recommendations to associate with each product.
 
You can now configure cross-selling to display recommendations when customers add a related item to the shopping cart. You can control recommendation locations, content, and appearance as well as individually configuring the recommendations to associate with each product.
 
   
 
   
[[Cross-selling and Product Recommendations in the Client Area|Learn More...]]
+
[[Cross-selling_and_Product_Recommendations_In_WHMCS|Learn More...]]
+
 
 
=== Metric Billing for Plesk ===
 
=== Metric Billing for Plesk ===
 
   
 
   
The Plesk provisioning module now supports usage billing in the '''Metric Billing''' tab at '''Configuration > System Settings > [[Products and Services|Products/Services]]'''. This functionality allows you to bill clients for the individual resources they use, such as email addresses, disk space, or bandwidth.
+
The Plesk provisioning module now supports usage billing in the '''Metric Billing''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]'''. This functionality allows you to bill clients for the individual resources they use, such as email addresses, disk space, or bandwidth.
 
   
 
   
 
[[Plesk|Learn More...]]
 
[[Plesk|Learn More...]]
+
 
 
=== Improved System Settings and Setup Tasks Display ===
 
=== Improved System Settings and Setup Tasks Display ===
+
 
When you view '''Configuration > System Settings''', you can now view the list of interfaces in several predetermined categories and use sorting to find features fast. We have also improved how the '''Setup Tasks''' list displays.
+
When you view '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings''', you can now view the list of interfaces in several predetermined categories and use sorting to find features fast.  
+
 
 +
We have also improved how the '''Setup Tasks''' list displays, and, in the WHMCS 8.5.0 GA 1 release, we added a list of recently-visited features to the sidebar menu.
 +
 
 
[[Setup Tasks|Learn More...]]
 
[[Setup Tasks|Learn More...]]
 +
 +
=== Updates to iDeal via Mollie Module ===
 
   
 
   
 +
We have updated the '''[[IDEALMollie|iDEAL via Mollie]]''' module to use the new Mollie API.
 +
 +
Because Mollie has deprecated their prior XML API, in WHMCS 8.4 and earlier this module will cease to function.
 +
 
=== Hook System Improvements ===
 
=== Hook System Improvements ===
 +
 
 +
Developers can now specifically exclude hook files from execution by prefixing their filenames with an underscore character (<tt>_</tt>).
 
   
 
   
The hook system now explicitly disallows use of the <tt>index.php</tt> file and files with names that begin with an underscore (<tt>_</tt>).
+
The hook system now also explicitly disallows use of the <tt>index.php</tt> file.
 
   
 
   
 
[https://developers.whmcs.com/hooks/ Learn More...]
 
[https://developers.whmcs.com/hooks/ Learn More...]
 +
 +
=== Custom Actions in Sidebar Menus ===
 +
 
 +
In the WHMCS 8.5.0 GA 1 release and later, custom actions can appear in Client Area sidebar menus in addition to the existing support for Home Page panels. The <tt>[https://developers.whmcs.com/provisioning-modules/custom-actions/ CustomAction]</tt> object lets developers define items that can perform actions and then redirect the user to a defined URI.
  
 
== Deprecation and Removal Notices ==
 
== Deprecation and Removal Notices ==
  
N/A
+
=== Removed Modules ===
 +
 +
We have removed the [[GMO Internet]] module.
 +
 +
Additionally, the third-party '''BuycPanel''' module has been deprecated and will not function in earlier versions of WHMCS. Upgrading to WHMCS 8.5 will remove the module and update any products that used it to use the '''[[Auto Release]]''' module instead.
 +
 +
=== ClientDelete Hook ===
 +
 +
We have deprecated the <tt>[https://developers.whmcs.com/hooks-reference/client/#clientdelete ClientDelete]</tt> hook and recommend using the <tt>[https://developers.whmcs.com/hooks-reference/client/#predeleteclient PreDeleteClient]</tt> hook instead.
 +
 
 +
=== SiteLock VPN ===
 +
 +
SiteLock discontinued its support for [[SiteLock VPN via MarketConnect|SiteLock VPN]] in May 2022. As a result, new purchases and renewals of SiteLock VPN are no longer possible.
 +
 
 +
This will not currently affect clients' currently-active SiteLock VPN purchases, but renewals will not be available in the future.
  
 
== Templates ==
 
== Templates ==
Line 93: Line 138:
 
===Twenty-One Theme===
 
===Twenty-One Theme===
  
The following link provides a comparison of changes between 8.4.1 and 8.5.0 (Beta):
+
The following link provides a comparison of changes between 8.4.1 and 8.5.2 (Maintenance):
  
https://github.com/WHMCS/templates-twenty-one/compare/v8.4.1-release.1...v8.5.0-beta.1
+
https://github.com/WHMCS/templates-twenty-one/compare/v8.4.1-release.1...v8.5.2-release.1
  
 
=== Six Theme ===
 
=== Six Theme ===
 
          
 
          
The following link provides a comparison of changes between 8.4.1 and 8.5.0 (Beta):
+
The following link provides a comparison of changes between 8.4.1 and 8.5.2 (Security):
  
https://github.com/WHMCS/templates-six/compare/v8.4.1-release.1...v8.5.0-beta.1
+
https://github.com/WHMCS/templates-six/compare/v8.4.1-release.1...v8.5.2-release.1
  
 
=== Standard Cart Order Form ===
 
=== Standard Cart Order Form ===
 
          
 
          
The following link provides a comparison of changes between 8.4.1 and 8.5.0 (Beta):
+
The following link provides a comparison of changes between 8.4.1 and 8.5.2 (Security):
  
https://github.com/WHMCS/orderforms-standard_cart/compare/v8.4.1-release.1...v8.5.0-beta.1
+
https://github.com/WHMCS/orderforms-standard_cart/compare/v8.4.1-release.1...v8.5.2-release.1
  
 
== Changelog ==
 
== Changelog ==
 
* [[Changelog:WHMCS_V8.5.0_Beta_1|Version 8.5.0 Beta 1]]
 
* [[Changelog:WHMCS_V8.5.0_Beta_1|Version 8.5.0 Beta 1]]
 +
* [[Changelog:WHMCS_V8.5.0_RC_1|Version 8.5.0 RC 1]]
 +
* [[Changelog:WHMCS_V8.5.0_GA|Version 8.5.0 GA]]
 +
* [[Changelog:WHMCS_V8.5.1|Version 8.5.1 Maintenance]]
 +
* [[Changelog:WHMCS_V8.5.2|Version 8.5.2 Security]]

Latest revision as of 19:28, 30 November 2022

Release Information
Version: 8.5.2
Release Type: Security
Latest Update: 30th November 2022
Distribution Types: Full and Via Automatic Updater

Version History

8.5.0Beta 120th April 2022
8.5.0Release Candidate 113th May 2022
8.5.0General Availability9th June 2022
8.5.1Maintenance15th June 2022
8.5.2Security30th November 2022


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.

You will only see the WHMCS 8 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 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.

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

View Standard Upgrade Steps

Automatic Updating

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

Go to Utilities > Update WHMCS to begin the process.

If the update was released recently, you may need to click Check for Updates before the update will be available.

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

Release Notes

cPanel SEO via MarketConnect

You can now offer cPanel SEO, a tool to help clients optimize their website content and reach the top rankings in Google®'s search results. MarketConnect and WHMCS automatically handle provisioning, renewals, and upgrades between two plans.

Learn More...

Multi-Year SSL Orders with DigiCert via MarketConnect

You can now offer two-year and three-year DigiCert SSL certificate orders through MarketConnect. WHMCS will automatically handle reissuance and reinstallation throughout the length of the order, including automated emails and renewals.

WHMCS installations should not have existing pricing for multi-year certificates. However, if your installation already specifies custom prices for them, the update process may overwrite them.

Learn More...

Client Area Home Page SSO

Clients can now use single sign-on (SSO) to access their active services directly from the main page of the Client Area Home Page. Due to this addition, it is now possible to create custom Client Area Home Page panels that span both columns of the desktop web browser page layout.

Custom Actions

In the WHMCS 8.5.0 RC 1 release and later, custom actions are available for use in provisioning modules. The CustomAction object lets developers define items that can perform actions and then redirect the user to a defined URI. Currently, you can use this to define a list of SSO items that will display on the Client Area Home Page.

SSO Links
Due to these changes, you may need to update custom hooks that use menu item methods (for example, the getChild() and removeChild() methods) and the menu item names for existing SSO buttons may have changed. For example, the Log In to cPanel menu item in WHMCS 8.4 and earlier is now the cpanel menu item.

Learn More...

Shopping Cart Cross-selling

You can now configure cross-selling to display recommendations when customers add a related item to the shopping cart. You can control recommendation locations, content, and appearance as well as individually configuring the recommendations to associate with each product.

Learn More...

Metric Billing for Plesk

The Plesk provisioning module now supports usage billing in the Metric Billing tab at Configuration () > System Settings > Products/Services. This functionality allows you to bill clients for the individual resources they use, such as email addresses, disk space, or bandwidth.

Learn More...

Improved System Settings and Setup Tasks Display

When you view Configuration () > System Settings, you can now view the list of interfaces in several predetermined categories and use sorting to find features fast.

We have also improved how the Setup Tasks list displays, and, in the WHMCS 8.5.0 GA 1 release, we added a list of recently-visited features to the sidebar menu.

Learn More...

Updates to iDeal via Mollie Module

We have updated the iDEAL via Mollie module to use the new Mollie API.

Because Mollie has deprecated their prior XML API, in WHMCS 8.4 and earlier this module will cease to function.

Hook System Improvements

Developers can now specifically exclude hook files from execution by prefixing their filenames with an underscore character (_).

The hook system now also explicitly disallows use of the index.php file.

Learn More...

Custom Actions in Sidebar Menus

In the WHMCS 8.5.0 GA 1 release and later, custom actions can appear in Client Area sidebar menus in addition to the existing support for Home Page panels. The CustomAction object lets developers define items that can perform actions and then redirect the user to a defined URI.

Deprecation and Removal Notices

Removed Modules

We have removed the GMO Internet module.

Additionally, the third-party BuycPanel module has been deprecated and will not function in earlier versions of WHMCS. Upgrading to WHMCS 8.5 will remove the module and update any products that used it to use the Auto Release module instead.

ClientDelete Hook

We have deprecated the ClientDelete hook and recommend using the PreDeleteClient hook instead.

SiteLock VPN

SiteLock discontinued its support for SiteLock VPN in May 2022. As a result, new purchases and renewals of SiteLock VPN are no longer possible.

This will not currently affect clients' currently-active SiteLock VPN purchases, but renewals will not be available in the future.

Templates

For a list of changed files and a graphical view of the exact changes, please refer to the GitHub repositories below.

Twenty-One Theme

The following link provides a comparison of changes between 8.4.1 and 8.5.2 (Maintenance):

https://github.com/WHMCS/templates-twenty-one/compare/v8.4.1-release.1...v8.5.2-release.1

Six Theme

The following link provides a comparison of changes between 8.4.1 and 8.5.2 (Security):

https://github.com/WHMCS/templates-six/compare/v8.4.1-release.1...v8.5.2-release.1

Standard Cart Order Form

The following link provides a comparison of changes between 8.4.1 and 8.5.2 (Security):

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.4.1-release.1...v8.5.2-release.1

Changelog