Install & folder structure

How to install T3 framework and its folder structure

T3 Bootstrap 2 version

How To Install T3 Framework

This video tutorial will guide you how to install T3 framework. There are 2 types of installation: Quickstart installation and Manual Installation.

Server Requirement

Software: PHP 5.3.1 +

Database

  • MySQL 5.1 +
  • MSSQL 10.50.1600.1 +
  • PostgreSQL 8.3.18 +

Web Sever

  • Apache 2.x +
  • Microsoft IIS 7 +
  • Nginx 1.0 (1.1 recommended)

Browser Requirement

  • Firefox 4 +
  • IE (Internet Explorer) 8 +
  • Google Chrome 10 +
  • Opera 10 +
  • Safari 5 +

Development Environment

During development process, Localhost is preferred. You can use the following servers in your PC to develop your site.

Windows

  • WAMPSEVER
  • XAMPP for Windows

Linux

  • LAMP Bubdle
  • XAMPP for Linux

Mac OS

  • MAMP & MAMP Pro
  • XAMPP for Mac OS

The instruction is appicable for both Joomla 2.5 and Joomla 3. We highly recommend you to use the stable version of Joomla, T3 version is now stable.

Now we move the project to github and you can check our project from: https://github.com/t3framework/t3

You can download our latest work or the released package. We suggest you to download the released version, it is tested and checked.

Download T3

You can select to install package (the package includes: T3 Blank Template and T3 Framework Plugin) or install one by one. The procedure includes the following steps:

Step 1: Install T3 Package

Step 2: Enable The T3 plugin

By default, when you install the plugin, it is enabled already. To check, go to: Extensions --> Plugin Manager --> find the plugin T3 Framework.

Step 3: Set T3 blank template as your default template

To set T3 Blank template as your default template, go to: Extensions --> Template Manager --> set T3 Blank template as your default template.

Step - 1: Select Language

Step -2: Main Configuration

Enter the required information of your site: sitename, email ...

Step - 3: Database Configuration

Enter the required information of your site: sitename, email ...

Step - 4: Install Sample Data

If you install sample data, you will have a site like our demo. If you select default sample data, you will a fresh site site with T3 framework plugin and T3 blank template installed and enabled.

Step - 5: Remove or Rename the Installation folder

The final step is removing or renaming the Installation folder

We recommend you to use JAEC (JA extension manager component) to upgrade T3. The component is FREE.

Video tutorials

Folder Structure

After this video tutorial, you will be able to know about your T3 System pluign folder structure, your JA Templates which developed with the T3 Framework and the functionality of the folders and files - all the materials you should be aware of before getting started in customizing your template.

After Installation, you should know the folder structure of the framework which shows you where and how to work with files.

T3 BS3 Blank template

T3 integrates Bootstrap, developed with LESS. Check the folder structure to know where to start.

templates/t3_bs3_blank/
+--less/            		/*  all LESS files */ 
¦    +-- rtl/			/*all files of right to left layout*/
¦    +-- themes/         	/*all theme folders theme files */
¦    +-- bootstrap.less
¦    +-- core.less
¦    +-- home.less
¦    +-- joomla.less
¦    +--  ...
+-- css/                     /*all compiled files*/
¦    +-- themes/             /*all theme folders and files*/ 
¦    +-- bootstrap.css
¦    +-- home.css
¦    +-- megamenu.css
¦    +-- template.css
+-- fonts/ 
+-- js/ 
¦    +-- scripts.js
+-- tpls/             /* all layout files and block files*/
¦    +-- blocks/       /*all block files here*/
¦    ¦    +-- head.php
¦    ¦    +-- mainbody.php
¦    ¦    +-- footer.php
¦    ¦    +-- ...
¦    +-- default.php
¦    +-- default-content-left.php
¦    +-- default-content-right.php
¦    +-- home-1.php
¦    +-- home-2.php
+-- images/
+-- languages/
¦    +-- en-GB.tpl_t3_bs3_blank.ini
¦    +-- en-GB.tpl_t3_bs3_blank.sys.sys.ini
+-- templateDetail.xml  
+-- templateInfo.php/
+-- thememagic.php/ 	/*the file is to add new group, parameters for ThemeMagic*/
+-- index.php/
+-- index.html

The most important folder is: less. The folder contains all LESS files that are used to develop your site, the LESS files can be compiled to CSS files.

T3 system plugin

When you install the t3 system plugin, the plugin includes the Bootstrap library that is used to develop your site. We recommend you not to customize files of the plugin, all your work should be operated in t3_blank template.

plugins/system/t3/
+-plugins/system/t3/base     /* base theme for T3 Blank template (bootstrap 2)*/
+-- css/
¦    +-- layout-preview.css
¦    +-- megamenu.css
¦    +-- thememagic.css
¦    +-- ...
+-- bootstrap/       /*Bootstrap 2 library folder*/
¦    +-- css/        /*css files in bootstrap library*/
¦    +-- ico/
¦    +-- img/
¦    +-- js/
¦    +-- less/    /*include all less files*/
¦    ¦    +-- code.less
¦    ¦    +-- form.less
¦    ¦    +-- ...
+-- less/
+-- fonts/
+-- js/
+-- html/
+-- tpls/
+-- params/
+-- tpls/
+-- component.php
+-- error.php
+-- index.html
+-- index.php
+-- offline.php
+-plugins/system/t3/base-bs3       /* base theme for T3 BS3 Blank template (Bootstrap 3)*/
+-- css/
¦    +-- layout-preview.css
¦    +-- megamenu.css
¦    +-- off-canvas.css
¦    +-- ...
+-- bootstrap/      Bootstrap 3 library folder
¦    +-- css/        /*css files in bootstrap library*/
¦    +-- ico/
¦    +-- img/
¦    +-- js/
¦    +-- less/    /*include all less files*/
¦    ¦    +-- grid.less
¦    ¦    +-- mxins.less
¦    ¦    +-- ...
+-- less/
+-- fonts/
+-- js/
+-- html/
+-- tpls/
+-- params/
+-- tpls/
+-- component.php
+-- error.php
+-- index.html
+-- index.php
+-- offline.php
+--admin/
+--includes/
+--language/
+--t3.php
+--t3.xml
+--t3.script.php