1. Install the SwiftModders WHMCS Theme Installer
Before proceeding with the installation of the SwiftModders WHMCS Admin Theme, you must first install the SwiftModders WHMCS Theme Installer. The Theme Installer handles the licensing checks and activation of the theme. Please follow the guide linked above to get started.
2. Download the latest version of the SwiftModders WHMCS Admin Theme
Now that the Theme Installer has been installed, you’re prepped and ready to install the theme. Head to the Client Area and navigate to “Services”> “My Licenses”. You should see a list of all your theme purchases and click your “SwiftModders WHMCS Admin Theme” license.
Once loaded, select the “Downloads” option on the sidebar menu. You will potentially see multiple downloads available for your license. Download the version of the theme that says “Theme Installer Version”.
3. Unzip the download to your local machine
After downloading the Theme Installer, 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 theme 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 (only the contents of the “upload” directory). This will add the necessary theme files into the appropriate folders so that the Theme Installer will recognize the theme is available for install.
*Notice: For security reasons, you may have changed the name of the “admin” folder within your WHMCS installation. Before uploading, be sure to change the “admin” folder within the “upload” folder to the same name as your WHMCS admin portal directory.
5. Access the Theme Installer and install the theme
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 an “Install” option present. If you do not see this option, make sure you have uploaded the theme folder to the correct location. If you continue to have problems, please open a support ticket.
Click on the “Install” button, and the process will start immediately. The installer will add a table to your WHMCS MySQL database that is used to house your customization settings. Once completed you will be presented with a success message. Now we will need to activate your SwiftModders WHMCS Admin Theme license.
6. Activate your theme license
To begin the activation process, you will simply need to click on the “Edit Settings” button. Once loaded you will see a form that asks for your license key. In step 2 you copied that license key, so let’s use that to input into the form here and click “Save”. If your activation was successful you will now see the settings for your SwiftModders WHMCS Admin Theme installation. If your license does not activate, please make sure you did not copy in any additional spaces. If that is not the issue, please be sure to open a support ticket.
7. Check your installation for health issues
One of the new features of the SwiftModders WHMCS Theme Installer is the ability to check for health issues. These issues involve:
- Permissions issues with files necessary to save your customizations
- An incorrect WHMCS theme in use
- Missing cache files for the SCSS compiler system
You will most likely see health warnings for using the incorrect theme and unsupported order form. This will be addressed in the next step. If you have permissions issues with any of the files that require write access, please use your FTP client or control panel file manager to handle adjusting your files write permissions.
8. Change your admin template under your admin account
Once you have fixed any issues with your theme installations’ health, the last step will involve changing your admin settings to use the appropriate template. Head to your WHMCS admin portal and click on the “My Account” link in the top bar (on the “Blend” theme). You will see an option called “Template,” and in the dropdown, select “Swiftmodders_v5”.
Congratulations, your SwiftModders WHMCS Admin Theme installation is now complete! As always, if you have any issues during the installation process, please be sure to open a support ticket. You can also order the “Theme Installation” service via the Client Area if you would like us to take care of it for you. To order, simply navigate to “Services”> “View Available Addons”. You will see the “Theme Installation” service listed as an option for your theme purchases.
Did you find this answer helpful?
2 out of 2 people (100%) found this helpful.