*Notice: You can only migrate the following theme installation versions:
- Allure WHMCS Theme 1.0.5+
- SwiftModders WHMCS Client Theme 22.214.171.124+
- SwiftModders WHMCS Admin Theme 126.96.36.199+
1. Backup your WHMCS database and files
It’s always important to make sure that your previous setup is preserved in case of an error with either the process or the module itself. Once you have a full backup of both your MySQL database and your WHMCS installation, you can move forward to the next step.
2. Download the theme you wish to migrate
More than likely, you already have the theme files installed on your WHMCS installation. That’s OK, but you must download the “Theme Installer” version and replace those files. There are minor changes that add support for the theme installer. Skipping this step could break your installation or prevent the display of the migration button. To download your theme again, simply login to the Client Area and navigate to “Services” > “My Licenses”. Select the theme license you wish to migrate and click on the “Downloads” option in the sidebar.
Once loaded, you will notice a handful of downloads for your theme license. The correct download will be the one specified with “Theme Installer Version”. Be sure to download those files to your local machine.
3. Unzip the download to your local machine
After downloading the theme, you will need to unzip the files compressed file onto your local machine. There are many different tools you can use to handle this and both Windows and Macs have built-in uncompression tools. My preference for Windows machines would WinRAR, but you’re free to use the tool you feel most comfortable with.
For more information on how to unzip a file, please read this tutorial on WikiHow.
4. Upload the files to your WHMCS installation
Once your ZIP file has been extracted, you can now upload the module files to your WHMCS installation. The best way to do this would be to use your favorite FTP program. I use SmartFTP and FileZilla regularly to handle my FTP uploads, but more modern control panels like cPanel and DirectAdmin have File Managers available as well.
In the theme folder, look for the “upload” folder. Upload the contents of the “upload” directory, not the folder itself, to the root directory of your WHMCS installation. This will add the necessary theme files into the appropriate folders so that the Theme Installer will recognize the theme is available for install.
5. Access the Theme Installer and run the migration
Once your upload has completed you will need to login to your WHMCS admin portal and navigate to “Addons” > “SwiftModders WHMCS Theme Installer”. You should see the theme you downloaded available in the module and a “Migrate” option present. If you do not see this option, make sure you have uploaded the theme folders to the correct location. If you continue to have problems, please open a support ticket.
Click on the “Migrate” button and the process will start immediately. The module will copy your settings from the original theme module to the new Theme Installer. This ensures that you do not lose your customizations done via the module. Keep in mind this will not remember your file customizations.
6. Re-issue your license for activation
Your license key has been migrated during the migration process but needs to be reissued. The reason for this is because the path of the module installation has changed and the module handles the licensing checks in addition to customizations. To reissue your license, you will need to login to the Client Area and navigate to “Services” > “My Licenses”. Select the theme license you wish to reissue and click on the item. Once loaded, you will see a large button that says “Reissue” and click it. Once done, you can head back to your WHMCS admin portal.
*Notice: If you have a license that supports unlimited installations, this should not be a problem for you.
7. Reload the Theme Installer to confirm license activation
Simply head back to your WHMCS admin portal and navigate to “Addons” > “SwiftModders WHMCS Theme Installer”. You will see that your theme should now have an “active” checkmark status and the “Edit Settings” button loads without issue. If your license is still showing errors, please be sure to open a support ticket.
To re-apply your customizations, be sure to click the “Recompile” option under “Actions”.
8. Deactivate the original theme module
This is a cleanup step and is highly recommended. Now that the Theme Installer is set up and running successfully, you can deactivate and remove the original theme module. Head to your WHMCS admin portal and navigate to “Setup” > “Addon Module”. In your list of addon modules, there may be a few different SwiftModders modules for each theme. Here is a list of all the older addon modules:
- Allure WHMCS Theme
- SwiftModders WHMCS Client Theme
- SwiftModders WHMCS Admin Theme
Each module corresponds to the theme you may have, so it should be fairly easy to determine which belongs to the theme you just migrated to. Once you’ve identified the module, you will now click the “Deactivate” button. This will remove all of the tables associated with the module from your MySQL database.
This will not remove the files for your WHMCS installation, but you can remove those as well by utilizing your favorite FTP client or control panel file manager. You will find the module folders in:
Each theme will have a module folder labeled as follow:
Similarly to the module names, the following folder names clearly identify which theme module you would be removing. Select the correct folder and delete the files. Once the deletion is complete you have completely removed all traces of the old module.
Congratulations! You’ve completely migrated your theme to the new SwiftModders WHMCS Theme Installer. If you encounter any issues when going through this process, do not hesitate to reach out and open a support ticket.
Did you find this answer helpful?
2 out of 3 people (66%) found this helpful.