Personal tools
Namespaces

Variants
Actions

How To Update WHMCS Module

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
m (Protected "Modules Update" (‎[edit=sysop] (indefinite) ‎[move=sysop] (indefinite)) [cascading])
(→‎Module Cron Commands)
 
(85 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
<meta name="keywords" content="modulesgarden whmcs modules update, whmcs 5.2 addon modules, whmcs 5.2.2 addon modules, whmcs v.5.2 addon modules, whmcs v.5.2.2 addon modules, whmcs v5.2 addon modules, whmcs v5.2.2 addon modules"></meta>
+
<meta name="keywords" content="modulesgarden whmcs modules update, whmcs products update, whmcs modules update, whmcs modules download, whmcs modules version, whmcs modules upload, update instructions, update guide, whmcs modules upgrade"></meta>
−
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About Addons And Modules Update In WHMCS V5.2.2"></meta>
+
<meta name="description" content="We Will Guide You Step By Step And Show You How To Successfully Update Any WHMCS Module Designed By ModulesGarden."></meta>
  
−
 
−
=How To Update Provisioning Modules For WHMCS V5.2.2=
 
 
{|
 
{|
−
|style="padding: 10px 0px 10px 0px;"|<span style="color: #ff0000">'''If you downloaded our provisioning module/modules before 19.03.2013 and updated your WHMCS to V5.2.2, you need to also update module/modules.''' </span><br />
+
|style="padding: 10px 0px 30px 15px;"|This guide provides essential instructions for updating any [https://www.modulesgarden.com/products/whmcs ModuelsGarden modules for WHMCS]. <br/>
−
<span style="color: #ff0000">'''If you downloaded our provisioning module/modules first time on 19.03.2013 or later, you don't need to update anything.''' </span><br />
+
Follow the steps one by one to ensure a smooth update process while minimizing the risk of data loss or unexpected issues.<br /> It also includes a set of cron commands that can help automate certain tasks related to module updates. <br/>
−
'''Please note that since WHMCS V5.2.1, server types nor modules names can not contain the underscore ( <span style="color: #ff0000">_</span> ). '''<br /><br />
+
 
−
'''Here is the list of modules which requires your special attention:'''
+
Carefully review the entire guide before proceeding to avoid potential complications.
 
|}
 
|}
 +
==Update Process==
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ cPanel Extended For WHMCS
+
|style="padding: 10px 0px 20px 15px;"|To successfully update a module, follow these steps:<br/>
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ DirectAdmin Extended For WHMCS
+
|style="padding: 0px 0px 15px 15px;"|1. '''Backup your WHMSC installation:'''
 +
*  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.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Plesk Extended For WHMCS
+
|style="padding: 0px 0px 20px 15px;"|2. '''Download the latest version of the module''' from our [https://www.modulesgarden.com/client-area/products client area].
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Rackspace Email For WHMCS
+
|style="padding: 0px 0px 15px 15px;"|3. '''Remove the old module files:'''
 +
* 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.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Rackspace Email Extended For WHMCS
+
|style="padding: 0px 0px 15px 15px;"|4. '''Upload and extract the new files:'''
 +
* Upload the latest module files to your WHMCS directory.
 +
* Verify the module’s folder structure, as some packaging changes might have occurred.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Zimbra Email For WHMCS
+
|style="padding: 0px 0px 15px 15px;"|5. '''Adjust the license file (if required):'''
 +
* In some cases, you may need to navigate to the module's folder and delete the existing <code>license.php</code> file.
 +
* Rename <code>license_RENAME.php</code> to <code>license.php</code> and edit it by entering your module’s license key.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ cPanel Manage2 For WHMCS
+
|style="padding: 0px 0px 15px 15px;"|6. '''Clear cache:'''
 +
* 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: <code>Ctrl + F5</code>, <code>Shift + F5</code>, or <code>Ctrl + Shift + R</code>
 +
** Mac: <code>Command ⌘ + Shift + R</code>
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Google Apps For WHMCS
+
|style="padding: 0px 0px 15px 15px;"|7. '''Check for additional update steps:'''
 +
* Some modules may require additional actions for a successful update.
 +
* Review the module’s [https://www.docs.modulesgarden.com documentation] for specific instructions related to file permissions, cron jobs, integration codes, or PHP version compatibility.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ WWD GoDaddy Domaind For WHMCS '''(more details in the next section below)'''
+
|style="padding: 0px 0px 15px 15px;"|8. '''Activate the updated module:'''
 +
* 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.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 20px 0px 10px 0px;"|'''Follow these instructions:'''
+
|style="padding: 0px 0px 30px 15px;"|9. '''Reissue the license:'''
 +
* 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.
 
|}
 
|}
 +
 +
==Module Cron Commands==
 
{|
 
{|
−
|style="padding: 10px 0px 10px 15px;"|1. Create backup of your WHMCS system.
+
|style="padding: 10px 0px 0px 0px;"|The following cron commands are available for managing modules based on the new framework:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 10px 15px;"|2. Remove old module files from your system.
+
|style="padding: 0px 0px 30px 0px;"|
 +
 
 +
* '''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
 
|}
 
|}
 +
<!--
 +
==Additional Instructions==
 
{|
 
{|
−
|style="padding: 0px 0px 10px 15px;"|3. Download the latest module version from your clientarea.
+
|style="padding: 10px 0px 15px 15px;"|In case of some modules, for example ''SMS Center For WHMCS'', additional steps are required.  
 +
 
 +
Please move to the module's documentation page and check whether there are any specific actions required. <br />
 +
Review  the following sections: '' "Installation", "Update Instructions" ''  and '' "Common Problems" '' sections:<br />
 +
 
 +
Search for information on:<br/>
 +
1. Folders which need specific writing permissions (chmods).<br />
 +
2. Previous settings of chmods which were overwritten.<br />
 +
3. Either a new cron job added or an old one removed.<br />
 +
4. The use of the migration tool needed to import the settings from the previous version.<br />
 +
5. Settings removed during the update.<br />
 +
6. Integration codes that need to be changed after the update.<br/>
 +
7. Additional steps listed in the installation instruction.<br/>
 +
8. If you upgraded your WHMCS server from the PHP 5.x to PHP 7.x version, make sure that the uploaded module's package supports the correct PHP version as well.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 10px 15px;"|4. Upload all the module files into your main WHMCS directory.
+
|style="padding: 0px 0px 30px 15px;"|'''In case of failure, return to the previous version of the module and [https://www.modulesgarden.com/support/ticket/general-support contact us.]'''
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|5. Update server/servers type through choosing new module name e.g. '' 'CpanelExtended' '' from a dropdown menu.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:MU1.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|6. Update product/products module settings through choosing new module name e.g. '' 'CpanelExtended' '' from a dropdown menu.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 30px 25px;"|[[File:MU2.png]]
+
 
|}
 
|}
 +
-->
  
−
==WWD GoDaddy Domains For WHMCS Update==
+
==Conclusions==
−
{|
+
−
|style="padding: 10px 0px 10px 0px;"|'''Follow these instructions:'''
+
−
|}
+
−
{|
+
−
|style="padding: 10px 0px 10px 15px;"|1. Create backup of your WHMCS system.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 10px 15px;"|2. Remove old module files from your system.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 10px 15px;"|3. Download the latest module version from your clientarea.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 10px 15px;"|4. Upload all the module files into your main WHMCS directory.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|5. Update registrar settings through choosing registrar module '' 'WwdGoDaddy' '' from a dropdown menu. Then enter your Go Daddy API User login and password.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:MU3.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|6. Update domain pricing through choosing '' 'WwdGoDaddy' '' from an 'Auto Registration' '' dropdown menu.
+
−
|}
+
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:MU4.png]]
+
|style="padding: 10px 0px 30px 0px;"|Following these steps will ensure proper module management in WHMCS. Always back up your installation before making changes, and verify the module functionality after updating. <br/>If any issues arise, refer to your module [https://www.docs.modulesgarden.com/Main_Page documentation] or [https://www.modulesgarden.com/support/ticket contact] our support team for assistance.
 
|}
 
|}

Latest revision as of 12:18, 4 March 2025

This guide provides essential instructions for updating any ModuelsGarden modules for WHMCS.

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.

[edit] Update Process

To successfully update a module, follow these steps:
1. Backup your WHMSC installation:
  • 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.
2. Download the latest version of the module from our client area.
3. Remove the old module files:
  • 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.
4. Upload and extract the new files:
  • Upload the latest module files to your WHMCS directory.
  • Verify the module’s folder structure, as some packaging changes might have occurred.
5. Adjust the license file (if required):
  • 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.
6. Clear cache:
  • 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
7. Check for additional update steps:
  • 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.
8. Activate the updated module:
  • 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.
9. Reissue the license:
  • 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.

[edit] Module Cron Commands

The following cron commands are available for managing modules based on the new framework:
  • 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

[edit] Conclusions

Following these steps will ensure proper module management in WHMCS. Always back up your installation before making changes, and verify the module functionality after updating.
If any issues arise, refer to your module documentation or contact our support team for assistance.
Retrieved from "https://www.docs.modulesgarden.com/index.php?title=How_To_Update_WHMCS_Module&oldid=74985"
Navigation
WHMCS Modules
WHMCS Widgets
Tools And Applications
Translations
cPanel Modules
General
FAQ
Community