JA Vitality

Installation and set up documentation

The section will help you with steps to install the JA Vitality quickstart or manual installation.

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

System requirement

Please make sure your system meets the following requirements:

Software

  • Software: PHP (Magic Quotes GPC off): 7.2+ (8.0 recommended)

Databases

  • MySQL(InnoDB support required): 5.61+
  • MSSQL 10.50.1600.1 +
  • PostgreSQL 11.0

Web Servers

  • Apache 2.4+
  • Microsoft IIS 7
  • Nginx 1.10 (1.18+ recommended)

Browser requirement

  • Firefox 13+
  • IE (Internet Explorer) 8+
  • Google Chrome XY and the 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

Download packages

JA Vitality download section includes the following files:

  • Quickstart package for Joomla 4
  • JA Vitality template
  • T4 Framework plugin
  • JA ACM Module
  • JA Extension manager component

Quickstart installation

Quickstart installation allows you to replicate the demo site to your server with all T4 extensions installed and demo content

Joomla 4 tutorial

Manual Installation

Installing the JA Vitality, T4 framework, and other extensions on your existing Joomla website.

From your back-end setting panel, go to: "Extensions > Extension Manager", browse the extension installation files then hit the "Upload and Install"

  • T4 Framework plugin
  • JA Vitality template
  • JA ACM module
  • JA Extension manager component

JA Vitality template documentation

JA Vitality template installation guide

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.

Set JA Vitality as default template style

Joomla 4: Go to: "System > Site Template Styles", set JA Vitality template style as your default template style.

Joomla template style access panel

Joomla default template style


Template folder structure

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

JA Vitality template

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

/templates/ja_vitality/
	+-- scss/                 /*  all SCSS files */ 
	+--     scss/tpl                 /*  theme tpl SCSS files */ 
	¦    +--  _acm.scss
	¦    +--  _all.scss
	¦    +--  _offcanvas.scss
	¦    +--  _styles.scss
	¦    +--  _typo.scss
	¦    +--  _utilities.scss
	¦    +--  _variables.scss
	¦    +--  _vars.scss
	¦    +--  _virtuemart.scss
	¦    +--  jpages.scss
	¦    +--  rtl.scss
	¦    +--  template.scss
	¦    +--  theme.scss
	¦    +--  _bootstrap.scss
	¦    +--  _components.scss
	¦    +--  _forms.scss
	¦    +--  _global.scss
	¦    +--  _joomla.scss
	¦    +--  _megamenu.scss
	¦    +--  _modules.scss
	¦    +--  _navigations.scss
	+-- scss/tpls 
	+-- css/                     /*compiled files from SCSS*/
	¦    +-- template.css
	¦    +-- rtl.css
	¦    +-- acm.css
	¦    +-- jpages.css
	¦    +-- off-canvas.css/
	¦    +-- offline.css/
	+-- html/               /*override modules and Joomla com_content*/
	¦    +-- com_content/
	¦    ¦    +-- article/
	¦    ¦    +-- category/
	¦    ¦    +-- featured/
	¦    +-- com_contact/
	¦    ¦    +-- contact/
	¦    +-- mod_articles_categories/
	¦    +-- mod_articles_category
	¦    +-- layouts/
	¦    +-- ...
	+-- fonts/ 
	+-- js/ 
	¦    +--owl-carousel/
	¦    +--html5lightbox/
	¦    +-- bootstrap.bundle.js
	¦    +-- template.js
	¦    +-- imagesloaded.pkgd.js
	¦    +-- isotope.pkgd.js
	+-- images/
	+-- language/
	+-- templateDetails.xml  
	+-- templateInfo.php/
	+-- templateHook.php/
	

CSS and SCSS customization

Any customization is not recommended in the t4 plugin.

To customize your site style, you can use either CSS or SCSS customization tool.

Joomla template style customization

More details


1. Layout configuration

JA Vitality supports different layouts by default and you can create more layouts using layout builder.

Assign Layout for a template style

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

Joomla template layout configuration

Set sub-layout

The sub layout is used for child pages. For example, if the Category page is assigned to the main layout, the article detail page is the child page of the Category page, and it will be using the sub-layout, in case the setting is active.

To configure the sub-layout, in the layout setting panel, scroll down and you will find the Sub Layout setting, assign a layout and save the layout setting.

Joomla template layout configuration

Layout positions:

Note: You can create multiple template styles with different layouts assigned. Then assign each template style to specific pages.

Layout builder detail docs


3. Site settings

Joomla template site setting

Logo settings

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

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

Joomla template logo setting

Typography settings

The typography includes the global settings for font family, font weight, and line height.

You can enable the custom font setting for heading and navigation (menu).

Joomla template font setting

Local font supported: due to the GDPR issue, you can disable Google font, and use the local font that is already supported at core.

Other settings:

  • Page: set page backgroud image and background style attributes
  • Author Settings: show, hide the author block and link for the author
  • Favicon setting: add custom favicon

Site setting detailed docs


JA Festival supports Megamenu for Desktop layout and dropdown or Off-canvas for Mobile layout.

Megamenu setting

Go to Navigation > Megamenu, select a menu and configure the megamenu. You can build a mega menu with multiple rows, each row can include multiple columns. You can assign menu items, modules or a module position to each column.

Joomla template megamenu setting

Megamenu detailed docs

Off-canvas Menu setting

Enable Off-canvas (it is enabled by default), select module position, module style and other options.

Next, create a menu module, assign it to the position: off-canvas.

Joomla template megamenu setting


Menu Breakpoint setting

The Mobile Menu Breakpoint is an additional customization option. Using this feature, you can choose the screen width necessary for the Mobile Menu to be triggered. With a larger Breakpoint Width, you can make the mobile menu appear on the desktop.

Joomla template menu breakpoint setting


5. Theme color settings

The theme color allows you to use the color picker to change color for brand colors, base colors, main menu colors, and footer colors.

Joomla template theme color setting

You can view the changes in the website preview on the right panel.

6. Global settings

Joomla template global setting

JA Vitality template global settings include:

  • T4 edit layout: this is the front-end editor (article, module) layout setting, you can select to use clean layout or full position layout
  • CSS & JS optimization: JS and CSS optimization is the process of making your website smaller and faster to load by minifying the JS and CSS codes.
  • Custom Code: You can insert any CSS, JS, meta tags, links, and verification codes using the custom code option. With multiple options to add custom to specific tags.
  • Add-ons: includes settings to enable or disable font icons like Font Awesome, Iconmoon. When an Addon is disabled, its CSS and JS will not be loaded on your website, this is to help keep your site clean and load faster.
  • Open Graph:

Detailed docs

7. CSS & SCSS editor tool

Customizing style for your site is even simpler with the inbuilt custom CSS Editor. In the Tools panel, hit the Edit Custom CSS button and you can add your own custom CSS rules to the editor.

Joomla template custom style

You can override the default variables in the Variables customization editor, as well as the adding custom SCSS.

Joomla template scss customization

Detailed docs


Step 1 - Create menu item

Go to Menu » Main menu, add a new menu item, select Articles » Featured Article menu type, or single article menu type.

Joomla home menu settings

Step 2 - Assign content to the Home page

The home page includes multiple sections, each section is a module.

home layout structure

1. Make weight loss fun permanent and natural: JA ACM Module

JA Vitality template hero module

Hero : style-1

Module position: hero
Module Suffix: NOT USED
Layout: Default

2. Start eating, feeling & living better today: JA ACM Module

JA Vitality template hero module

Features Intro : style-1

Module position: section-1
Module Suffix: NOT USED
Layout: Default

3. Statistics: JA ACM Module

JA Vitality template hero module

Statistics : style-1

Module position: section-2
Module Suffix: NOT USED
Layout: default

4. Personalized coaching that helps you lose the weight for good: JA ACM Module

JA Vitality template hero module

Features Intro : style-6

Module position: section-3
Module Suffix: NOT USED
Layout: Default

5. Our diet & nutrition services: JA ACM Module

JA Vitality template hero module

This section include 2 module is: Our diet & nutrition services, Weight loss program: Day-by-day plan

5.1. Our diet & nutrition services

Features Intro : style-3

Module position: section-4
Module Suffix: NOT USED
Layout: Default

5.2. Weight loss program: Day-by-day plan

CTA : style-1

Module position: section-4
Module Suffix: NOT USED
Layout: Default

6. Listen to our podcast

JA Vitality template hero module

This section will need to create a JA ACM Module with a tab item position, then create the Articles - Category Module and select the "tab-item" position.

6.1. Listen to our podcast: JA ACM Module

[Container] Tabs : style-1

Module position: section-5
Module Suffix: NOT USED
Layout: Default

6.2. Get up and Go: Articles - Category Module

Module position: tab-item
Module Suffix: NOT USED
Layout: Default

7. Our team includes experts: JA ACM Module

JA Vitality template hero module

Features Intro : style-4

Module position: section-6
Module Suffix: NOT USED
Layout: Default

8. Let's join our membership catering: JA ACM Module

JA Vitality template hero module

Pricing : style-1

Module position: section-7
Module Suffix: NOT USED
Layout: Default

9. Our shop: VirtueMart Category Module

JA Vitality template hero module

Module position: section-8
Module Suffix: NOT USED
Layout: Default

10. Explore our blogs: Articles - Category Module

JA Vitality template hero module

Module position: section-9
Module Suffix: NOT USED
Layout: Default

JA Vitality template hero module

This section include 4 module position

1. Subscribe to newsletter: AcyMailing subscription form Module

Module position: subscription
Module Suffix: NOT USED
Layout: Default

2. Talk to our experts now: JA ACM Module

Features Intro : style-5

Module position: footer-info
Module Suffix: NOT USED
Layout: Default

3.1. copyright information: Footer Module

Module position: copyright

3.2. Footer Menu: Menu Module

Module position: footer-menu

1. Blog pages

This includes Grid layout and list layout.

1.1. Blog - Grid layout

JA Vitality template hero module

Create News menu item: go to Menu, add a new menu item, select Articles » Category Blog menu type.

JA Vitality template hero module

1.2. Blog - List layout

JA Vitality template hero module

Create News menu item: go to Menu, add a new menu item, select Articles » Featured Articles menu type and assign "ja_vitality - Home" template style.

JA Vitality template hero module

2. Shop page

This menu type displays the Shop section of the website using VM Category layout.

Here is the instruction to create the same Shop page

Create Shop page menu item

Go to Menu » Main menu, add a new menu item, select Virtuemart » Category Layout menu type.

JA Vitality template hero module

Virtuemart Default Page

This page shows Product layout using Virtuemart-Default style, Here is the instruction to create the same page

Create Virtuemart Default page menu item

Go to Menu » Main menu, add a new menu item, select Virtuemart » Product Details Layout menu type.

JA Vitality template hero module


Take a full backup

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

The best method to upgrade JoomlArt products is using JA Extension Manager. The FREE extension brings a new way to manage extensions: upgrade, rollback, remote install, internal repository, 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 selects Service Manager, now set JoomlArt as your default service. Next, hit the "Edit" button then add your account.

JA extension manager

2. Upgrade JA Vitality template

Check the new version of the JA Vitality template. Use the filter to find the JA Vitality template then hit the "Check Update" button.

3. Upgrade T4 Framework and 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 Upgrade Now to upgrade the extension to the latest version.

JA Vitality joomla extensions update

Check out more details about JA Extension manager