How do I install the SwiftModders WHMCS Admin Theme?
1. Install the SwiftModders WHMCS Theme Installer
Before installing 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. Log into your account and navigate to “My Services”> “Downloads.” You should see a list of all your theme purchases and click your “SwiftModders WHMCS Admin Theme” download.
3. Unzip the download to your local machine
After downloading the Theme Installer, you will need to unzip the compressed file onto your local machine. You can use many different tools 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.
In the theme folder, look for the “upload” folder. Then, 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: You may have changed the name of the “admin” folder within your WHMCS installation for security reasons. 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 been 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 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 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 were successful, you would now see your SwiftModders WHMCS Admin Theme installation settings. 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 checking 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.