How do I customize the SwiftModders WHMCS Admin Theme?

One of the most powerful features of any SwiftModders WHMCS Theme is that you can customize many different aspects of your theme. The SwiftModders WHMCS Admin Theme is no different and offers many ways you can make your installation unique to your brand. In this guide, I’ll walk you through the various settings you can customize.

Editing the General Settings

These settings are general theme options that will impact multiple areas of the theme. Some will have more impact than others, but this is the first step in making your theme unique.

Font CDN URL: This field will utilize the Montserrat font family call via Google Fonts by default. Of course, any font CDN is available, so you can change this CDN URL to anything you would like. Keep in mind if you’re not interested in using a custom font, you can leave this field blank to disable its usage.
Font Family: This field will match whichever font you’ve selected via your preferred Font CDN. If you’re not using a Font CDN, you’ll be expected to call a font stack supported in most browsers. For a safe list of CSS font stacks that do not require a CDN, check out this guide: https://www.cssfontstack.com/
Gravatar Support: Gravatar is a global user avatar system provided by WordPress.com. Your selected avatar will be attached to the email address you used when you signed up, and this option will pull your user’s avatar into the header and ticket views. If no avatar was uploaded, then it will show a default silhouette image.
SwiftModders Footer Copyright: If you would like to show support for SwiftModders, you can enable our copyright message to display in the theme's footer. If disabled, it will be removed.

Adding Your Company Logo

Most organizations will want to use their company branding on the theme instead of the default SwiftModders logo. I highly recommend that you do this to give your site a better professional feel and avoid branding confusion when your customers need support for your products. Let’s walk through the best way to change this.

Logo: A knockout white version of your logo

Notice: The recommended logo size is 518×78. It would be best to use your favorite photo manipulation tool to adjust your logo to fit these specifications. If your logo looks too small with this format, it might be best to make a custom logo for your theme.

Adjusting the Theme Colors

By default, the SwiftModders WHMCS Admin Theme will be using the brand colors of the SwiftModders website. While we enjoy those colors, you might not! If your company or organization features its color palette, this section will be the best place to display it.

As you can see, the theme has many color options you can change to make your installation unique quickly. The “Brand Colors” are the primary colors used throughout the theme. The “Theme Colors” are default color sets used by Bootstrap 3. The “Gray Colors” are shades of gray that scale from lightest to darkest. It is recommended that you always keep the scale as close to the default as possible. You may end up with legibility issues on your theme otherwise.

Modifying the Theme Layout

In addition to editing essential branding elements of your theme installation, you can also edit general layout settings to help make your install feel more unique! Let’s walk through the various options available to you.

Login Background Image: This background image will be used on the login template to invite your staff to log in. You can leave this image name the same, or you can change the name. I recommend changing the name to avoid having your customizations overwritten on updates. Be sure to upload your image in the following path: /**yourwhmcsinstall**/**youradminfolder**/templates/swiftmodders_v5/images/
Menu Location: By default, the menu navigation will be located on the side, but you can also select the top horizontal version.
Header Style: The header has two different style options, light or dark.
Menu Style: Similarly to the “Header Style,” you can pick between two different menu styles, light or dark.
Login Style: When you or your staff are attempting to login to the WHMCS admin panel, you will either be presented with a modern “split-screen” style or “classic” style login form.

Inserting my own custom CSS/SCSS

For those that are a little more advanced and have a clear understanding of how to use CSS or SASS/SCSS syntax, you can use the “Custom CSS” tab to insert your CSS into the theme directly. This is especially helpful for areas of the theme I do not provide an easy way to edit. Be careful; adding incorrect CSS or SCSS syntax can break the CSS compilation library and result in your changes not being saved.

The Theme Installer provides an easy-to-use syntax formatter that should help make the editing process simpler. If you make a mistake, your changes will give an error rather than save. Do not forget to consider any changes that impact not only the desktop but also tablet and mobile versions.

Notice: Due to the complex nature of this section, I cannot provide support for your custom CSS changes. If you have issues with your changes not applying, I’ll try my best to deduce them, but it may require you to seek help from the web development community. A great resource would be StackOverflow, as you can ask many questions about your CSS/SCSS code.

Congratulations, you’ve completed the guide on how to customize your SwiftModders WHMCS Admin Theme installation! I hope this was helpful and provides greater insight into just how powerful this theme can be. As always, if you have any issues during the installation process, please be sure to open a support ticket.