WHMCS Documentation - User contributions [en]

IonCube Loader Version Matrix

2024-03-18T14:07:40Z

David:

<div class="docs-alert-info">[[System Environment Guide|Minimum]] ionCube® Loader Version by WHMCS Version</div>
{| class="table table-striped"
! 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
! PHP v8.1
|-
| 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 (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|| -- || --
|-
| v8.0 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || --
|-
| v8.1 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || --
|-
| v8.2 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || --
|-
| v8.3 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || --
|-
| v8.4 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || --
|-
| v8.5 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || --
|-
| v8.6 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || style="font-weight: bold;" | 12.0.1
|-
| v8.7 (EOL) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || style="font-weight: bold;" |12.0.1
|-
| v8.8 (LTS) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || style="font-weight: bold;" |12.0.1
|-
| v8.9 (Active) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || style="font-weight: bold;" |12.0.1
|-
| v8.10 (Beta) || -- || -- || -- || -- || -- || -- || style="font-weight: bold;" | 10.2.0 || style="font-weight: bold;" | 10.3.1
| style="font-weight: bold;" | 10.4.3 || style="font-weight: bold;" |12.0.1
|}

Version 8.9 Release Notes

2024-03-06T16:01:33Z

David: /* Changelog */

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

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

==Version History==

<onlyinclude>
<table class="table table-striped">
<tr><td>8.9.0</td><td>Beta</td><td>6th December 2023</td></tr>
<tr><td>8.9.0</td><td>Release Candidate</td><td>7th February 2024</td></tr>
<tr><td>8.9.0</td><td>General Availability</td><td>6 March 2024</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 ==

=== New PayPal® Payment Gateways ===

The new '''PayPal Payments''' payment gateway module allows merchants to process and store payment methods using PayPal's latest secure tokenization system, including the advanced security of merchant-level vaulting with PayPal Vault for supported merchants.

<div class="docs-alert-info">
Currently, PayPal supports vaulting for merchants in:
* The United States
* Canada
* The United Kingdom
* Australia
* The following EU countries: Belgium, Bulgaria, The Republic of Cyprus, Czech Republic, Germany, Denmark, Estonia, Spain, Finland, France, Greece, Hungary, Italy, Lithuania, Luxembourg, Latvia, Malta, Netherland, Poland, Portugal, Romania, Sweden, Slovenia, and Slovakia.
</div>

When you use '''PayPal Payments''', clients can make one-click payments using PayPal during checkout and on invoices.

When you activate '''PayPal Payments''', it also activates the '''[[PayPal Card Payments]]''' module. This module augments '''PayPal Payments''', allowing you to display a separate unbranded option to accept credit and debit cards during checkout. Both modules use the '''PayPal Payments''' configured PayPal account information for a seamless experience.

You can enable the new '''PayPal Payments''' module at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]'''.

<div class="docs-alert-warning">If you enabled these modules while using the Beta release of WHMCS 8.9, you '''must''' reactivate them before using them with WHMCS 8.9 Release Candidate or later. If you do not do this, you may experience problems with some payment methods.</div>

[[PayPal|Learn More]]

=== Transactions List ===

We have updated the displayed transaction details at '''Billing > [[Transactions List]]''' to include additional information and currency codes for some amounts.

=== On-Demand Renewals ===

On-Demand Renewals now allow early renewals for product addons. When you enable on-demand renewals, clients can renew services in the Client Area before WHMCS generates their next invoice, with no manual action from your staff.

* You can configure on-demand renewals globally in the '''[[Ordering_Tab|Ordering]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings'''.
* You can configure on-demand renewals for individual product addons in the '''Pricing''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Product Addons]]'''.

[[On-Demand Renewals|Learn More]]

==== On-Demand Renewal Product Settings ====

We have moved the product-specific '''On-Demand Renewals''' settings at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' from the '''Other''' tab to the '''Pricing''' tab.

[https://help.whmcs.com/m/payments/l/1706772-configuring-on-demand-renewals Learn More]

=== Separated Invoice Viewing and Management ===

Invoices in the WHMCS Admin Area now default to a view-only mode. This prevents accidental editing while viewing an invoice and gives admins more fine-grained control over staff permissions.

* This change affects invoices at '''Billing > [[Invoices]]''' and in a client's profile's '''[[Clients:Invoices_Tab|Invoices]]''' tab.
* Admins can still add payments, resend emails, and perform certain other tasks in view-only mode if they have the related permissions for those tasks.

A new ''View Invoice'' permission at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Administrator Roles]]''' grants admins the ability to view, but not alter, existing invoices. Admins who already had the ''Manage Invoices'' permission will continue to be able to edit invoices by clicking '''Manage Invoice''' while viewing an invoice.

[[Invoices|Learn More]]

=== Duo® Universal Prompt ===

We have updated our integration with Duo Security to use the new [https://guide.duo.com/universal-prompt|Universal Prompt] login process. This change replaces the previous iframe-based experience and implements a simplified interface that continues to support Duo's wide range of Two-Factor Authentication options.

<div class="docs-alert-info">
Duo has announced that support for the previous iframe-based Duo Prompt will [https://duo.com/docs/universal-prompt-update-guide end on March 30, 2024].

* Duo Security will '''not''' function in WHMCS 8.8 and earlier after this date.
* After you upgrade to WHMCS 8.9 or later, we '''strongly''' recommend activating [https://guide.duo.com/universal-prompt Duo Universal Prompt] in your Duo customer portal to ensure continued functionality. If you do not do this, your customers may experience problems.
</div>

[[Duo Security|Learn More]]

=== Show on Order Form State ===

Payment gateway modules now support a <tt>VisibleDefault</tt> metadata parameter that defines the default '''Show on Order Form''' setting. This parameter defaults to <tt>true</tt> for all payment gateway modules.

[https://developers.whmcs.com/payment-gateways/meta-data-params/ Learn More]

=== Improved Invoice ID Incrementation ===

To improve how WHMCS handles incrementing invoice ID numbers, we have updated the following settings in the '''[[Invoice_Tab|Invoices]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''':

* '''Invoice # Incrementation''' now has a maximum value of <tt>999</tt>.
* '''Invoice Starting #''' now has a maximum value of <tt>499,999,999</tt>.
* The maximum invoice ID number that the system can generate has increased from <tt>2,147,483,647</tt> to <tt>4,294,967,295</tt>.

=== Improved Apps & Integrations Experience ===

We have optimized page performance at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps_and_Integrations|Apps & Integrations]]''', allowing you to search for modules faster.

=== Stripe™ Module API Updates ===

We have updated the [[Stripe]], [[Stripe ACH]], and [[Stripe SEPA]] modules. We have updated the Stripe PHP Library and implemented other module improvements.

Additionally, '''Stripe ACH''' and '''Stripe SEPA''' now use Stripe's <tt>PaymentIntents</tt> API instead of the now-deprecated Stripe API. Patches will be available soon for installations that run WHMCS 8.5, 8.6, 8.7, or 8.8.

[[Stripe|Learn More]]

=== Enhanced Domain Pricing Validation ===

The system now validates your PHP configuration's <tt>max_input_vars</tt> setting before saving changes at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Pricing]]'''. This helps to prevent MySQL® errors and other issues that low <tt>max_input_vars</tt> values may cause.

[https://go.whmcs.com/1809/PHP-max-input-vars-Setting-Errors Learn More]

=== Blesta 5 Support in ImportAssist ===

The [[ImportAssist]] addon module now supports importing data from Blesta 5. This is a direct change to the '''ImportAssist''' module and is not specific to WHMCS 8.9.

[[ImportAssist|Learn More]]

== Deprecation and Removal Notices ==

=== Plaid Settings in Stripe ACH Module ===

We have removed support for Plaid from the [[Stripe ACH]] payment gateway module. This includes removing the '''Plaid Client Id''', '''Plaid Secret''', and '''Plaid Environment''' settings from the module's configuration.

== 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.8.0 and 8.9.0:

https://github.com/WHMCS/templates-twenty-one/compare/v8.8.0-release.1...v8.9.0-release.1

=== Six Theme ===

The following link provides a comparison of changes between 8.8.0 and 8.9.0:

https://github.com/WHMCS/templates-six/compare/v8.8.0-release.1...v8.9.0-release.1

=== Standard Cart Order Form ===

The following link provides a comparison of changes between 8.8.0 and 8.9.0:

https://github.com/WHMCS/orderforms-standard_cart/compare/v8.8.0-release.1...v8.9.0-release.1

== Changelog ==

* [[Changelog:WHMCS_V8.9.0_Beta_1|Version 8.9.0 Beta 1]]
* [[Changelog:WHMCS_V8.9.0_RC_1|Version 8.9.0 RC 1]]
* [[Changelog:WHMCS_V8.9.0_GA|Version 8.9.0 GA 1]]

Version 8.9 Release Notes

2024-03-06T15:59:49Z

David: /* Changelog */

Version 8.9 Release Notes

2024-03-06T15:59:26Z

David: /* Changelog */

2021-11-29T15:37:36Z

David: Created page with "An update routine in WHMCS 8.3.1 introduced a severe bug (CORE-17294) when using the Affiliate system with the commission delay feature. <div class="docs-alert-info"><i class..."

An update routine in WHMCS 8.3.1 introduced a severe bug (CORE-17294) when using the Affiliate system with the commission delay feature.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i>This bug only affects systems that updated directly to version 8.3.1 and that use the Affiliate system with the commission delay feature.</div>

= Overview =

The bug removes pending affiliate commission records during the update to version 8.3.1. The error occurs only once and is not persistent. WHMCS 8.3.2 provides a fix that recreates any erroneously-removed records using the invoice and commission payout history.

When you update from version 8.3.1 to 8.3.2 or later, the removed data will be restored and, in most cases, no further action will be required. For more information, see Further Considerations below.

If your system restored records as part of the upgrade, a notification banner will display in the Admin Area.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i>The notification banner is for informational purposes only. You can dismiss it by clicking the X.</div>

= Further Considerations =

''Most users will only need to perform the update from version 8.3.1 to version 8.3.2 or higher.''

Some conditions may affect version 8.3.2's ability to recreate records.

Manually inspect the restored data if any of these conditions apply to your WHMCS installation:

== Previous Manual Deletion of Pending Commissions ==

The update will recreate any pending commission that does not have a corresponding payout history entry for the affected time frame. Because manually-removed pending commissions are not tracked in affiliate accounting records, they will be recreated with any other pending commissions.

If you normally remove pending commissions manually, you must check all of the restored records after you update. Then, manually remove the unwanted records again.

== Disabled Affiliate Systems ==

The restorative routine will not run if the affiliate system is disabled. In these cases, no automated discovery or record recreation will be performed.

If you need to know whether the routine would have restored records if the Affiliate system had been enabled, contact WHMCS Technical Support. They can analyze your database, help determine whether any pending commissions exist, and assist you in creating them.

To determine whether the affiliate system was disabled after applying the 8.3.1 update, perform these steps:

# Log in to the WHMCS Admin Area.
# Go to '''Configuration > System Logs'''.
# Use the '''Search/Filter''' tab to search for Affiliate Enabled Disabled.
# Examine the results:
* If there are no results, no further action is required.
* If there are results, check to ensure that the timestamp shows a date occurring after your update to version 8.3.1.

== Commission Delay Change ==

Decreases in the '''Commission Delay''' setting's value after you update may result in fewer restored records. The restorative routine only analyzes a limited invoice and commission history. The setting is required to determine the maximum invoice history to cross reference. The decrease will result in referencing an equally fewer number of days of history.

To determine whether the setting was lowered after updating to version 8.3.1:

# Log in to the WHMCS Admin Area.
# Go to '''Configuration > System Logs'''.
# Use the '''Search/Filter''' tab to search for Affiliate Delay Commission Changed.
# Examine the results:
* If there are no results, no further action is required.
* If there are results, check to ensure that the timestamp shows a date occuring after your update to version 8.3.1.

If you know that the setting changed, review the invoice payment history for affiliate-tracked services. To find the oldest invoice to inspect, count the previous setting's number of days, working backwards from October 26th, 2021. For example, if your delay was 30 and is now 15, inspect paid affiliate invoices from September 26th to October 11th.

<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i>You can use a database backup from before your 8.3.1 update to compare the tblaffiliatespending table after the update to version 8.3.2. In most cases, the restorative routine will recreate all of the previous entries. Any entry that it did not recreate will have a correlative entry in the tblaffiliatehistory table clearing the pending amount. If an entry is still missing, check for the above conditions.</div>

WHMCS Technical Support is available to assist with and address any concerns or questions you may have.

__NOTOC__

Changelog:WHMCS V8.3.0 beta 1

2021-09-16T13:10:14Z

David:

Changelog:WHMCS V8.3.0 beta 1

2021-09-16T13:08:29Z

David: Created page with "{{:WHMCS_V8.3.0_Beta_1}}"

2021-06-04T15:39:20Z

David: Addon Type - AddOn Feature

Addon Type - AddOn Feature