Template configuration

How to configure template developed with T3 Framework

T3 Bootstrap 2 version

T3 Framework version 2.0.x supports 2 base template: T3 Blank template and T3 BS3 Blank template. T3 Blank template integrates Bootstrap 2 while T3 BS3 Blank template integrates Bootstrap 3.

The global settings are applied for all styles, themes and layout, no matter the settings are changed in any styles.

Development Mode

This is an important option. You should clearly define the differences between enabling and disabling the option.

Enable Development Mode

When you are developing your site, you should enable this option. Once it's turned on, your site directly runs on original files - LESS files. The LESS files are located in templates/t3_bs3_blank_less/ or templates/t3_blank/less

When developing your site, Firebug is a good tool. You can use this tool to track

In this mode, it is easy for you to develop your site with LESS but it will decrease your site speed so when you finish developing, turn the option off.

Disable Development Mode

When you are not developing your site, you should disable the option. This will increase your site speed. In this mode, your site runs on CSS, not LESS. The CSS files are compiled from LESS files.

The CSS files are located in templates\t3_bs3_blank\css. But we don't recommend you to customize your site with the CSS files in this folder as each time you compile LESS to CSS, the files will be overridden.

In case Development mode is off, you are allowed to enable or disable option: Optimize CSS. This option will optimize and join CSS files. By this way it will improve your site performance.

When enabled, the optimized and joined CSS files will be located in the defined T3 Assets Folder folder. By default this folder is t3-assets.

Enable Responsive

T3 is a responsive template framework. You can turn this feature on or off.

When the option is disabled, your site is a non-responsive site and you can set the fixed width size for your site. Once it's disabled, all responsive files will not be loaded.

Enable ThemeMagic

  • Step 1: Enable the option "Enable ThemeMagic"
  • Step 2: Access The ThemeMagic setting panel

Note: This option should be enabled only when you customize your theme using ThemeMagic, after you finish your customization, you should turn it off.

Follow THIS LINK to see how to work with ThemeMagic and customize.

Enable Bootstrap 2 compatibility and Font Awesome 3

This option will make your site compatible with Bootstrap 2. For example, you use some extensions that intergrates Bootstrap 2. To make the extensions work in your site, it will load some CSS of Bootstrap 2. It will load font awesome version 3 as well.

Ultilize LESS

T3 is developed with LESS. When customize your site, we suggest you to work with LESS files. The LESS files will be compiled to CSS files later on. All the LESS files for customization are located in templates/t3_bs3_blank/less.

When site development is complete, you should compile LESS to CSS. This option will compile LESS files to CSS files. All your customization in LESS files will be compiled to corresponding CSS files.

Build CSS for RTL language

T3 supports RTL (right to left) language style. The LESS file of RTL is located in templates/t3_bs3_blank/less/rtl.

When compile LESS to CSS, you can select to build CSS for RTL language or not. To active this option, please enable option Build RTL CSS in the General tab then run the Compile LESS to CSS.

The Theme settings allows you to configure themes, logo. The settings can be also configured in the ThemeMagic setting panel

Theme Setting

Select a theme for current style. Each style goes with one theme.

Logo Setting

T3 allows you to select image or text logo. If you select to use image logo, browse to the image that is displayed as logo. If you select text logo, enter the text that is displayed as logo, slogan is optional.

Now, let's see how front-end looks like.

Change Logo Image and Customize Logo size

An other way to change logo is change the logo image path in the file: variables.less in: templates/ja_t3v3_blank/less. You can also customize the logo size in this file.

 // T3 LOGO
// --------------------------------------------------
@T3logoWidth: 270px;
@T3logoHeight: 65px;

@T3LogoImage: "../images/logo.png";

Please refer this LINK to know more detail about how to customize logo.

Layout configuration

T3 comes with ease of layout customization. The visual layout configuration allows you to configure layout never easier.

Still have trouble?

Select Layout for style

In T3 framework, each style will use one layout (but please keep in mind that one site use many styles --> so one site can use multiple layouts simultaneously because T3 use multiple styles simultaneously).

Layout Configuration

In the layout setting, there are 2 parts to be configured: Layout structure and Responsive layout configuration.

Layout Structure Configuration

Assign module position.

Set number of columns in each spotlight block.

Responsive Layout Configuration

Select responsive layout.

In each responsive layout, you can enable/disable content, resize module positions in spotlight block.

The section has been moved to Menu system section. Check it out now.

The section has been moved to Menu system section. Check it out now.

The tab includes settings that allows you to add scripts like Google Analytic, Live chat service ... to the any position.

To add scripts, please open tab Custom Code then select to add the scripts to: after , before , after , or before .

In front-page, view source to see whether the scripts are added or not.

Available version: 2.1.0

Optimize CSS and JS is to improve your site performance by join and compress CSS and JS files so that the total size and number of requests will be decreased.

Now let's check how the feature affect your site.

#1: CSS optimization

#2: JS optimization

Enable optimization

To enable this feature, please turn off the development mode in General tab in any T3 blank template style back-end setting.

Now enable options Optimize CSS and Optimize JS.

For JS optimization, we provide 2 tools to compress:

  • Closure Compiler
  • JSMIN

In comparision, Closure compiler has better compress and more accurate but it limits the size of optimization group (under 200kb).

Exclude files to be optimized

You can exclude CSS and JS files that you don't want to optimize, just add the file name, if you have many files, please saperate them with comma. If you have 2 same files, please add full path to the files to distinguish.

How optimized files are generated?

When the optimization option is enabled, the optimized CSS and JS files will be auto generated when a page is viewed in the first time. If there is any change in the CSS, JS loaded in a page, new optimized JS and CSS files will be auto gererated again. So to prevent from having a lot of optimized CSS and JS files, you should check before turn the Optimization option on.

All the optimized CSS are located in templates/purity_iii/t3-assets/css folder and the optimized JS files are located in templates/purity_iii/t3-assets/js.

Available version: 2.1.0 and only for T3 BS3 Blank template

In back-end setting of template style any template developed with T3 framework, you will see Add-ons tab, this tab include add-ons for T3. Currently it has configuration for Off-canvas sidebar and Extended template style.

Off-canvas sidebar

Off-canvas sidebar can be used to display flexible content, you can use it to display static content or use it as a menu system of your site.

Looking for how-to docs of Off-canvas sidebar? Check it out now.

Template extended style

This feature allows to load a Stylesheet (.less) file to specific pages. It's specially useful when you want to make a third party extension to be compatible with your site or customize the style of the third party extension.

Step 1: create stylesheet file

Create .less file in templates\t3_bs3_blank\less\extras. If you don't see the extras folder, please create the folder.

Step 2: assign the stylesheet to pages you want

Open back-end setting of T3 BS3 blank template style, in the Add-ons tab, assign the new created stylesheet to the pages that will load the stylesheet.

If you don't want the stylesheet to load in any page, just leave it blank or assign to Not use. If you want to use it in all pages, assign to All pages.

Purity III is the first template that apply the new feature. In Purity III, it supports number of third party extensions, the customized style of each third party extensions is stored in its own .less file.

Step 3: compile LESS to CSS

When you compile LESS to CSS, the .less file will be compiled to .css file and it's stored in templates\t3_bs3_blank\css\extras.

About Template and style

T3 Framework supports 2 starter templates: T3 Blank template (Bootstrap 2 integration) and T3 BS3 Blank template (Bootstrap 3 integration).

For each template, you can create unlimited styles that are to override the default style.

Style Override

Each style includes its own theme, layout, logo, navigation ... When creating new style, you can configure those things and override the default style.

3 steps to override style

Step 1: Create override style

To create new override style, you can duplicate the default style or you can save as copy in setting panel of any style.

Duplicate Style

Or Save as Copy

Step 2: Configure style

Now open the clone style then configure theme, layout, navigation ...

Step 3: Assign menu items for the style

Open the tab Assignment the tick on the menu items that you want to apply the style. The style will override default style in selected menu items.

Thanks to community who helped us to make french and italian translation package. You can download and install to the your system.

Step 1: download translation package

When you view T3 framework project on Github, you will see translation folder.

Download T3 framework

Download the T3 framework package, zip the folder of translation folder of the 2 languages.

Step 2: install French language

Go to Extensions >> Extension manager >> Install languages, select language then install.

Step 3: create content language for French

Go to Extensions >> Language manager >> content, create new content langauge.

Step 4: install French translation package

Access your template style manager >> Extensions >> Extension Manager. Browse the translation package then install.

Step 5: set French as default langauge

Back to Extensions >> Language manager >> Installed Administrator, set French as default language.

Now go to T3 blank template style, you will see it's translated to french.