How To Update WHMCS Module

Follow the steps one by one to ensure a smooth update process while minimizing the risk of data loss or unexpected issues.
It also includes a set of cron commands that can help automate certain tasks related to module updates.

Carefully review the entire guide before proceeding to avoid potential complications.

• Before proceeding, create a full backup of your WHMCS files and database. This step is crucial in case of an update failure or other issues.

• Navigate to your WHMCS root directory.
• Delete all files related to the previous module version, except for the license.php file to retain the module’s configuration settings.
• If you have custom attachments or additional files uploaded to the module, ensure you do not delete them.

• Upload the latest module files to your WHMCS directory.
• Verify the module’s folder structure, as some packaging changes might have occurred.

• In some cases, you may need to navigate to the module's folder and delete the existing license.php file.
• Rename license_RENAME.php to license.php and edit it by entering your module’s license key.

• Navigate to /your_whmcs/template_c/ and delete all files except index.php to remove old cache data.
• Refresh your browser cache using one of the following key combinations:
  • Windows/Linux: Ctrl + F5, Shift + F5, or Ctrl + Shift + R
  • Mac: Command ⌘ + Shift + R

• Some modules may require additional actions for a successful update.
• Review the module’s documentation for specific instructions related to file permissions, cron jobs, integration codes, or PHP version compatibility.

• Log in to the WHMCS admin area.
• Navigate to 'System Settings' → 'Addon Modules' and locate the updated module.
• Click the Activate button to enable the module.

• Log in to the client area where your license is managed.
• Navigate to Products and find the relevant license.
• Click Reissue License to update the installation.

• Check available product versions for updates:

 php cron.php upgrade list  

• Run an upgrade to a specified version (replace <version> with target version number):

 php cron.php upgrade run <version>   

for example:

 php -q /.../whmcs/modules/addons/WordressManager/cron/cron.php upgrade run 3.0.0 

• Activate the module (triggers module logic without affecting WHMCS activation):

 php cron.php activate   

• Deactivate the module (triggers module logic without affecting WHMCS activation):

 php cron.php deactivate 

• Deactivate the module and remove database tables (irreversible action, permanently deletes module-related tables):

 php cron.php deactivate --remove-database-tables