LIMITED TIME OFFER: Use the promo code “SPRINGSAVINGS” during checkout to save 40% on all SwiftModders products! Activate Discount

How do I configure the SwiftModders Blesta Theme Installer?

Now that you have completed the SwiftModders Blesta Theme Installer plugin installation, you can adjust the plugin’s global areas, giving you greater control of your Blesta Themes. This article will walk you through what’s possible:

Accessing the Theme Installer plugin settings

You can access the plugin settings by visiting the Blesta admin panel and logging in with your admin credentials. Once logged in, look for the “Theme Installer” link under the “Tools” menu item and click on it.

The location of the SwiftModders Blesta Theme Installer in Blesta

Once the Theme Installer has loaded, you will be able to click on the “Settings” option in the right-hand corner of the Theme Installer:

The location of the settings for the SwiftModders Blesta Theme Installer

You’ve reached the “Settings” area of the Theme Installer plugin. Now, let’s break down each option to understand better what they could do for you.

Understanding the Theme Installer plugin settings

General Settings

The general settings of the SwiftModders Blesta Theme Installer
  • Enable Debug? – When enabled, a custom display box will be displayed at the bottom of your theme and plugin pages. This display will contain a collection of set variables that Blesta and the theme use. Do not enable this option in any production environment.
  • Enable Logs? – When enabled, error logging for specific plugin functions will be generated. Your Blesta installation has a specific logs folder defined in “Settings” > “System” > “General” > “Basic Setup” > “Log Directory”. Do not enable this option in any production environment.
  • Font Awesome API Token – If you have a Font Awesome account and utilize their kits deployment system, you can define your Font Awesome API token here.
  • Font Awesome Kit Token – This is the token generated when creating a Font Awesome kit under your account.
Notice: The cookie message functionality has no cookie blocking or additional compliance functionality. Depending on your location, you will need a more robust solution that will be applicable for the laws you wish to comply with.
The cookie message settings for the SwiftModders Blesta Theme Installer
  • Enable Cookie Message? – A cookie message bar will be displayed on your themes when enabled.
  • Cookie Policy URL – If the cookie message is enabled, setting your Cookie/Privacy policy page is essential.

Enabling Font Awesome Pro icons

Notice: All SwiftModders Blesta Themes support Font Awesome 5 at this time. Attempting to utilize Font Awesome 6 will result in your icons breaking.

The SwiftModders Blesta Theme Installer plugin will allow you to use Font Awesome Pro, but you need to enable it through your Font Awesome account. Follow the below steps to enable it to:

1. Log in to your Font Awesome account

Visit the Font Awesome website and locate the “Sign In” icon in the upper right-hand corner of the website.

Sign into the Font Awesome website

Once the page loads, input your login credentials or sign up for a new account.

2. Visit your account page and grab your Font Awesome API token

After logging into your Font Awesome account, click on the “Account” icon in the top right-hand corner of the website. You’ll see a section called “API Token.” You can generate or copy an existing token for the first time.

The API token in the Font Awesome account dashboard.

Save the API token in a secure location. Next, we’ll set up a new Font Awesome kit to generate a kit token.

3. Create a new Font Awesome kit and grab the kit token

To access the Font Awesome “Kits” section, you can click on the “Kits” menu item in the header of the Font Awesome website.

Access your kits on Font Awesome

Once the “Kits” section has loaded, you will see a list of all the kits you’ve created. You may already have a kit you want to use, but if not, you must click on the “Add New Kit” button to get started.

Add a new kit in Font Awesome

Font Awesome will automatically generate the kit with some default settings. We must customize these settings to ensure they work with any of your Blesta Themes. Look for the “Settings” option in the “Kit” menu to access the kit options.

Font Awesome kit settings

Once loaded, you will see a handful of options you can adjust. First, I would recommend changing the name of the Kit to something that makes sense for its usage, but before you do, copy the current name, which represents your kit token. Now let’s make some additional customizations.

Adjust the Font Awesome kit settings
  • Icons – If you can access the “Pro” icons, you should enable that option. It gives you greater flexibility to select a wide range of icon styles.
  • Technology – Always select “Web Font.” None of the Blesta Themes by SwiftModders support the SVG technology.
  • Subset – Since we will be using Font Awesome v5, no sub-setting option exists.
  • Styles – Pick and choose which styles you would like to use. This can help with performance.
  • Version – At this time, only v5 is supported. Please ensure that v5 has been selected.
  • Domains – Add your domain name to avoid malicious users leeching off your impressions.
  • Features – Conflict Detection would not be necessary on any of these Blesta Themes.

Once you’ve made the necessary changes to the kit settings, click the “Save Changes” button to apply them. It can take about 5-10 minutes for your kit data to update if this kit is already in use.

4. Add the Font Awesome API token and Kit token to the plugin settings

Now that you have the Font Awesome API token and Kit token, you must supply these credentials to the SwiftModders Blesta Theme Installer plugin. If you’re not already logged into your Blesta Admin, please do so and click on the “Theme Installer” menu item. Once loaded, click on the “Settings” menu item in the Theme Installer. You should now be on the plugin settings for the Theme Installer.

Set the Font Awesome API token and Kit token

Input the proper values into the “Font Awesome API Token” and “Font Awesome Kit Token” fields. Next, click the “Save Settings” buttons to trigger the Font Awesome integration. In the background, the plugin will contact the Font Awesome API and pull in the icons you can access.

Congrats! You’ve completed the Font Awesome Pro integration. You should see “Pro” icons available in the Font Awesome Selector functionality.

The “Cookie Message” feature in the plugin settings is a great way to inform your customers of how you’re using cookies. You may need to adjust the language of the cookie message to match your multi-lingual requirements. To adjust and translate the cookie message copy, you will need to visit the following folder:


There will be a folder labeled “en_us” in this folder. If you’re looking to translate the cookie message, you must copy this folder and change the name to one of the many Blesta-supported languages. Inside the folder will be a file called “swiftmodders_blesta_theme_installer.php. You can edit this file and change the cookie message language to the correctly translated text:

$lang['SwiftmoddersBlestaThemeInstaller.views.cookie_message'] = 'We use cookies to bring you the best user experience possible. By using our website, you agree to the use of cookies. <a href="%1$s" target="_blank">View our Cookie Policy</a>.';

Congrats! You’ve translated/adjusted the cookie message copy.

Looking for something a little more custom?

Since 2007 we have been offering tech-focused businesses quality web development services catered to meet the needs of your business and customers. We offer a wide range of project options, flexible budgets, and quality coding standards. Hire us to take care of your web project needs.

Our services
Back to top

Get 15% OFF Your Next Order

Join the SwiftModders newsletter by entering your information below and get an exclusive discount code for your next order!

You can opt-out of our newsletter at any time by visiting our Privacy Policy page.