The section will help you with steps to install JA Tour template - Quickstart and Manual installation.

System requirement

JA Tour is in Beta version please do not use it for the live site. Please make sure your system meets the following requirements:

Software

  • Software: PHP (Magic Quotes GPC off): 5.3.10+ (7.3+ recommended)

Databases

  • MySQL(InnoDB support required): 5.1+
  • MSSQL 10.50.1600.1 +
  • PostgreSQL 9.1+

Web Servers

  • Apache 2.4+
  • Microsoft IIS 7
  • Nginx 1.0 (1.8+ recommended)

Browser requirement

  • Firefox 13+
  • IE (Internet Explorer) 8+
  • Google Chrome XY and latest
  • Opera 11.6+
  • Safari 5.1+

Development Environment

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

Windows

  • WAMP SERVER
  • XAMPP for Windows

Linux

  • LAMP Bundle
  • XAMPP for Linux

Mac OS

  • MAMP & MAMP Pro
  • XAMPP for Mac OS

Installation

The section will help you with the steps to install the T4 template framework. There are 2 options to install the Template.

  • Quickstart installation: replicate template demo to your server.
  • Manual installation: install template, plugin manually on your Joomla site

Download packages

T4 Framework download section includes following files:

  • Quickstart package
  • JA Tour template
  • T4 Framework plugin
  • JA ACM Module
  • JA Masthead Module
  • VikBooking extension (commercial 3rd party extension)

JA Tour documentation

Quickstart installation

Using quickstart installation allows you to replicate T4 demo to your server with all T4 extensions installed and demo content

Joomla 3 quickstart Installation tutorial

Joomla 4 quickstart Installation tutorial

Manual Installation

Installing T4 framework on your existing Joomla website.

Step 1. Install T4 framework plugin

From your back-end setting panel, go to: "Extensions → Extension Manager", browse the T4 plugin installation file then hit the "Upload and Install"

By default, the T4 plugin will be auto-enabled after installation. You can check this by going to: "Extensions → Plugin Manager" then find T4 Plugin.

enable t4 joomla template framework plugin

Step 2: Install JA Tour template

From your back-end setting panel, go to: "Extensions → Extension Manager", browse JA Tour template installation package then hit the "Upload and Install".

Go to: "Extensions → Template Manager", set JA Tour template style as your default template style.

JA Tour documentation


Template folder structure

This section is to help you understand the folder structure of JA Tour template, where to find the files you want.

JA Tour template

JA Tour template is built on T4 Framework so its folder structure is almost the same with any other JA Templates that are developed with T4 Framework.

/templates/ja_Tour/
+-- scss/                 /*  all SCSS files */ 
+--     scss/tpl                 /*  theme tpl SCSS files */ 
¦    +--  acm.scss
¦    +-- all.scss
¦    +--  offcanvas.scss
¦    +--  styles.scss
¦    +--  type.scss
¦    +--  utilities.scss
¦    +--  variables.scss
¦    +-- vars.scss
¦    +--  jpages.scss
¦    +--  rtl.scss
¦    +--  template.scss
¦    +--  bootstrap.scss
¦    +--  components.scss
¦    +--  forms.scss
¦    +--  global.scss
¦    +--  joomla.scss
¦    +--  megamenu.scss
¦    +--  com_solidres.scss
¦    +--  modules.scss
¦    +--  navigations.scss
+-- scss/tpls 


+-- css/                     /*compiled files from SCSS*/
¦    +-- template.css
¦    +-- rtl.css
¦    +-- acm.css
¦    +-- vik-booking.css
¦    +-- jpages.css
¦    +-- off-canvas.css/
¦    +-- offline.css/
+-- acm/               /*JA Advanced Custom Module content type*/
¦    +-- slideshow/
¦    ¦    +-- config.xml
¦    ¦    +-- css/
¦    ¦    +-- tmpl/
¦    ¦    +-- js/
+-- html/               /*override modules and Joomla com_content*/
¦    +-- com_content/
¦    ¦    +-- article/
¦    ¦    +-- category/
¦    ¦    +-- featured/
¦    +-- com_contact/
¦    +-- com_finder/
¦    +-- com_search/
¦    +-- com_users/
¦    +-- mod_masthead/
¦    +-- mod_breadcrumbs/
¦    +-- mod_articles_latest/
¦    +-- mod_articles_categories/
¦    +-- mod_articles_category/
¦    +-- layouts/
¦    +-- ...
+-- fonts/ 
¦    +-- font-awesome/
¦    ¦    +-- css/
¦    ¦    +-- fonts/

+-- js/ 
¦    +-- bootstrap.bundle.js
¦    +-- template.js
¦    +-- imagesloaded.pkgd.js
¦    +--  ekko-lightbox.js
¦    +-- isotope.pkgd.min.js
¦    +-- template.js
¦    +-- owl-carousel/
¦    +--   html5lightbox/
+-- images/
+-- language/
+-- templateDetails.xml  
+-- templateInfo.php/
+-- thememagic.xml/     /*the file is to add new group, parameters to ThemeMagic*/
+-- templateHook.php/

T4 Framework

You can find the folder structure of T4 Framework at: http://t4-framework.org/documentation/installation#folder-structure.

Recommendation

Any customization in the t4 plugin is not recommended. To customize your template, please do it in the templates/ja_tour folder

Instructions to configure supported commercial extensions in JA Tour : VikBooking

VikBooking Configuration

JA Tour template supports VikBooking component. Here is the instruction to configure the extension as the demo site.

1. Install VikBooking component

VikBooking is a commercial extension so you will need to buy it from VikBooking. Download the package and install to your site.

2. Configuration

Once the Configuration is done, go to Components » VikBooking and you can configure the extension. In the template demo, we use default settings.

VikBooking

Customized style of 3rd extensions

The custom style of VikBooking in an independent .scss file - templates/ja_tour/scss/vik-booking.scss/. That means, if you upgrade VikBooking, the custom style will not be lost. use the .scss file to do customization.

You can assign the custom style to the pages you want. In any JA Tour template style, open the Global configurations Addons tab and turn on Vik CSS style.

This section will help you build the pages the same as the JA Tour demo site.

1. Homepage

View homepage position layout:

JA Tour documentation
View Full Image

Here is instruction to create the same Homepage page

Step 1 - Create template style

The page uses Home layout so we have to create template style. The best way to create the template is by cloning the JA Tour default template style. to create the different types of Homepages like in the demo you need to duplicate the default template style and assign it to the different pages.

Here is the default layout structure of the template used for all other pages.

JA Tour default layout

Step 2 - Create Home page menu item

Go to Menu » Main menu, add new menu item, select Articles » Featured Articles menu type and assign "JA Tour- Home" template style.

home menu JA Tour

Step 3 - Assign content to the Home page

Content of Homepage is loaded from modules. Here is the detailed configuration of each module.

1.Slideshow JA ACM Module

home menu JA Tour

Module position: Slideshow
Module Suffix: NOT USED
Alternative layout: default

2.About Luvan Travel JA ACM Module

home menu JA Tour

Module position: section-1
Module Suffix: NOT USED
Alternative layout: default

3.Our Blogs Module

JA Tour documentation

Module position: section-2
Module Suffix: NOT USED
Alternative layout: tours

4. Video Intro JA ACM Module

home menu JA Tour

Module position: section-3
Module Suffix: NOT USED
Alternative layout: default

5. Choose Your Travel Style JA ACM Module

home menu JA Tour

Module position: section-4
Module Suffix: NOT USED
Alternative layout: default

6. Top Destinations Articles - Categories Module

home menu JA Tour

Module position: section-5
Module Suffix: NOT USED
Alternative layout: default

7. Ready to rest Module

home menu JA Tour

Module position: section-6
Module Suffix: NOT USED
Alternative layout: default

8. Recent Blog Posts Module

home menu JA Tour

Module position: section-7
Module Suffix: NOT USED
Alternative layout: default

9. AcyMailing subscription form Module

home menu JA Tour

Module position: section-8
Module Suffix: NOT USED
Alternative layout: default

10. We value relationships Module

home menu JA Tour

Module position: section-9
Module Suffix: NOT USED
Alternative layout: default

11. Client ACM Module

home menu JA Tour

Module position: section-10
Module Suffix: NOT USED
Alternative layout: default

Footer Module

Template footer part consist multiple module position from footnav-1 to footnav-5 with a custom html module with logo and menu module

home menu JA Tour

12. Free Call ACM Module

Module position: footnav-5
Module Suffix: NOT USED
Alternative layout: default

13. Social ACM Module

Module position: footnav-5
Module Suffix: NOT USED
Alternative layout: default

2. Homepage Vik Bookings

Here is an instruction to create the same Booking Homepage page

Create Home page menu item

Go to Menu » Main menu, add new menu item, select Articles » Featured Articles menu type and assign "JA Tour- Home" template style.

home menu JA Tour

Step 3 - Assign content to the Home page

Content of Homepage is loaded from modules. Here is the detailed configuration of each module.

The Vik Booking Home Page uses most of the same module as on the demo home page. There are some modules replaced with VikBooking extension

1. Most Popular Tours vikbooking rooms Module

Home-vik menu JA Tour

Module position: section-2
Module Suffix: NOT USED
Alternative layout: default

2. Top Destinations vikbooking rooms Module

Home-vik menu JA Tour

Module position: section-5
Module Suffix: NOT USED
Alternative layout: default

3. Ready to rest vikbooking Search Module

Home-vik menu JA Tour

Module position: section-6
Module Suffix: NOT USED
Alternative layout: default

3.About us Page

JA Tour documentation

Here is an instruction to create the same About us page

Create About us page menu item

Go to Menu » Main menu, add new menu item, select Articles » Single Article menu type and assign "JA Tour- Home" template style.

About us menu JA Tour

Assign content to the About us page

Content is loaded from modules. Here is the detailed configuration of each module.

1. Our Origins and Story Module

home menu JA Tour

Module position: section-7
Module Suffix: NOT USED
Alternative layout: default

2. Why We Are The Best ACM Module

home menu JA Tour

Module position: section-7
Module Suffix: NOT USED
Alternative layout: default

3. What People Say ACM Module

JA Tour documentation

Module position: section-7
Module Suffix: NOT USED
Alternative layout: default

4. Our Teams ACM Module

JA Tour documentation

Module position: section-7
Module Suffix: NOT USED
Alternative layout: default

3.Tour Page

Tour Page contains the Different type of menu inside it. One is Using Joomla Articles and another is from VikBooking extension.

JA Tour documentation

There are 2 Menu dropdown :

Tours List: It will contain multiple tours Content menu that uses Joomla articles with extra fields option to add tour article information.

Vik Bookings: VikBooking Use different types of VikBooking menu types to display rooms, search, booking, etc.

4. Tour List Page

This menu type is used to display special tour type articles that display the tour item with extra information for booking using Joomla articles.

Tour list category menu JA Tour

Step 1 - Create Tour list category page menu item

Go to Menu » Main menu, add new menu item, select Articles » Tour list category Articles menu type and assign "JA Tour- default" template style.

Tour list category menu JA Tour

Step 3 - Assign content to the Tour list category page

Extra Fields

Tour Articles use Extra fields to provide more information inside the articles with Gallery and Tour location plane.

Tour extra fields - JA Tour

  • Extra fields for Tour Information
  • Gallery extra fields to add gallery in Article

Tour extra fields - JA Tour

To show these option in Article open Article manager > Category > Open Category > Extra fields > Tours. save and check all articles under this category will have the extra fields.

5. Vik Bookings Page

This menu type will show the list of rooms from the VikBooking extension.

VikBooking JA Tour

Step 1 - Create Vik Bookings page menu item

Go to Menu » Main menu, add new menu item, select VikBooking » Rooms List menu type and assign "JA Tour- default" template style.

VikBooking rooms menu JA Tour

Step 3 - Assign content to the Tour list category page

6. Rooms Availability Page

This menu type will display the Rooms Availability.

VikBooking  Rooms Availability JA Tour

Step 1 - Create Vik Bookings page menu item

Go to Menu » Main menu, add new menu item, select VikBooking » Rooms Availability menu type and assign "JA Tour- default" template style.

VikBooking rooms Availability menu JA Tour

7. News Blog Page

This menu type display the news section of website using Joomla articles.

JA Tour documentation

Here is instruction to create the same News page

Create blog page menu item

Go to Menu » Main menu, add new menu item, select Articles » Category blog menu type and assign "JA Tour- default" template style.

blog menu JA Tour

Here is module configuration loaded on News Page

1. Masthead Module

Module position: masthead
Module Suffix: NOT USED
Alternative layout: default

2. Login Module

Module position: sidebar-r
Module Suffix: NOT USED
Alternative layout: default

3. Latest Posts Module

Module position: sidebar-r
Module Suffix: NOT USED
Alternative layout: default

8. Contact page

A special Contact page for JA Tour template.

JA Tour

Here is instruction to create the same contact page

Create Contact menu item

Go to Menu » Main menu, add new menu item, select Contact » Single contact menu type and assign "JA Tour - Default" template style.

In the Contact component, please make sure You have created contact item so you can assign it to the menu item

In Component > Contact > Create a new contact item before creating the Menu item

Supported Layouts

Access T4 working panel

Access working panel of JA Tour template: from back-end > Extensions > Templates > and open JA Tour template style.

JA Tour supports default layouts by default. Here is the structure of the supported layout.

Assign Layout for a template style

To assign a layout for a JA Tour template style, open the template style » Layout setting panel » assign a layout for the template style.

joomla template layout

You can create multiple templates style for JA Tour template, each template style is assigned to one layout and the template style is assigned to specific menu items so that in one site, you use 1 template but you can use as many layouts as you want Also, you can choose a different theme for different template styles.

Joomla template layout

Another option is save as copy

JA Tour joomla template layout

Get more details in Layout customization on T4 here : https://www.joomlart.com/documentation/t4-framework/layout-builder

The Logo settings are present under Site configuration > Logo Settings.

logo settings

For the logo, you can select to use an image logo or text logo. You can also select the different logo for mobile view.

Get more details in Site configuration on T4 framework templates here : https://www.joomlart.com/documentation/t4-framework/layout-builder


You can choose different Mega menu for different template style in JA Tour Joomla template. To change the Mega menu : Navigation to JA Tour template style > Navigation > Mega menu.

menu settings

You can enable Mega menu to select different submenu items

menu settings

Off canvas Menu settings

menu settings

Take a full backup

Please always make a back-up before proceeding to any of the upgrade process. In case there is any problem, you can always restore from the back-up files.

Upgrade instruction

Before back-up, take a full backup

Please always make a back-up before proceeding to any of the upgrade processes. In case there is any problem, you can always restore from the back-up files.

The best method to upgrade JoomlArt products is using JA Extension Manager. The FREE extension brings a new way to manage extensions: upgrade , roll back, remote install, internal repository and compare versions and more.

1. Set up JA Extension Manager Component

Download this free extension from this link. Install the extension to your website.

Go to Components → JA Extension Manager then select Service Manager, now set JoomlArt as your default service. Next, hit the "Edit" button then add your account.

enable t4 joomla template framework plugin

2. Upgrade T4 framework plugin and JA Tour template

Check the new version of the T4 plugin template. Using the filter to find the JA Property template then hit the "Check Update" button.

upgrade t4 joomla template framework

3. Upgrade other JA extensions

Using the filter to find the extensions you want to upgrade (JoomlArt products only), hit the "Check Update" button to check for a new version then hit the Upgrade Now to upgrade the extension to the latest version.

Check out more details about JA Extension manager

Documentation is a WIP. If you have any specific requests or feedback as well as suggestions, feel free to drop us a line in the JA Tour template forum. We'll try to cover them all.

Let us know in the forum