Knowledgebase

Joomlabamboo template and extension documentation

Overview

This document is for the Zen Grid Bridge version of of the Ascent template.

For more information on the Zen Grid Bridge framework please see this document.

Key differences between the original Ascent theme and the Zen Grid Bridge version.

 

Common Overrides - ZGB based themes are a hybrid of the Zen Grid Framework and the One Web framework from Seth Warburton (Zen Grid Bridge themes use Seth's html overrides). So there may be some small differences for the styling of author, category, date etc when compared to the original release.

Interface - ZGB themes use the standard Joomla interface in the administrator and no longer sports the zgf interface that you will have used in Joomla 1.5 and Joomla 2.5.

Logo control - ZGF themes use a module position called "logo" and do not provide any other control of the logo position except for font control. The font used for the logo module is set via the template admin while the content of the logo position is entirely set via what ever is published to that position. See below for more information.

Advert1 to advert6 modules no longer available - The Advert1 to 6 module positions have been replaced by the above and below module positions.

Layout control uses new settings - Please see below for a description of how layouts of modules can be set. jQuery is loaded via Joomla - ZGB themes use the standard Joomla 3 method of using jQuery on the page.

Copyright is now in a module rather than the template - See below

Social icons are rendered via the Zen Social module - See below

Toggle Menu is the only mobile option - Previous Zen Grid Framework themes had the option of using a select menu however this is not available in the bridge themes.

Module Positions

 Ascent Bridge Positions2

Setting up the logo

The content for the logo in all Zen Grid Bridge themes is created via publishign a custom html module to the logo position.

Please note this is a different method to creating the module that users of the previous version of this theme would be used to.

It is still possible to create either google font rendered text based logos or use image based logos.

Creating the logo position:

1. In your Joomla administrator naviugate to the module manager via extensions > moduel manager.

2. Click the new button on the top left of the screen.

3. Select Custom HTML module

4. Create a title for the module that you will easily recognise later eg Site Logo.

5. Assign the module to the "logo" position.

6. Ensure that the module title is set to hide.

7. Click on the "Custom Output" tab.

8. Add your logo content:

a. Using a font for the logo text.

If you are using just text for your logo you can add the logo content as per the following.

<h2>My site logo</h2> <p><em>My tagline</em></p>

- You can use any tag that you like here.

- The font family for the h1,h2,h3,h4,h5,h6 headings are controlled via the template settings. You can assign a google font to be used for your logo here.

 

b. Using an image for your logo.

Using a logo in this position is as simple as using the default Joomla editor image upload feature to insert an image into the module.

 

Adding Social Icons

The Zen Grid Bridge based themes use the Zen Social module to replicate the social icons seen in earlier versions of this template.

There may be visual variations with the social icons used in the Zen Social module. This module uses font icons to render the social icons. The colour, size and position for the social icons can be controlled via the module settings.

The Zen Social module must be published to the social module position to replicate the styling seen in the original Ascent template.

Adding your copyright

Copyright can be added to your site by publishign a custom html module to the copyright position.

This will automatically be positioned to the right of the footer position at the very bottom of the page.

Template settings

Ascent-General


Template Width

Sets the maximum width for the template - can be px or % value.

 

Hilite

Sets the colour scheme for the template.

Loads a separate css file found in the css/ folder fo the template.

 

Navigation Colour

Sets the background colour for the menu


Top Style

Sets the background image and or colour for the area above and including the banner.

 

Middle Style

Sets the background image and or colour for the main content area below the banner row and above the footer row.

 

Bottom Style

Sets the background image and or colour for the area below the main content area.

 

Responsive

Allows the user to enable or disable the responsive features of the template.

 

Toggle Menu title

If responsive is enabled this sets the string used for the word that triggers the opening of the toggle menu on small screens.

 

Menu alignment

Sets the left, center or right alignment of the menu.

 

 

Font Settings

 

 Ascent-Fonts

 The font family for the body, heading, navigation and logo font are specified in this panel.
 
Using Google Fonts.
To specify a google font for your font family in this section simply paste the name of the font family found on the google web font library page.
 
On the google webfont page:
 
 
1. Click the quick use button
Google Fonts3
 
 
2. Click on the tab that says javascript at the bottom of the page.
 
Google Fonts3
 
3. Highlight the text located in the brackets for that font. eg Kavoon::latin

Google Fonts3
 
4. Paste this into the input box in the template admin for the appropriate font family setting.
 
5. Set the font weight as a valid css rule depending on your needs. eg you can set it as a number (300) or as a word value (thin)
 
Ascent-Layout-Main
 
Main content and right content value.
The layout-main panel allows the user to specify the relative widths for the main content and the sidebar.
The values here must add up to the number 12. The entire template width is divided into a 12 column grid.
 
Hide content on front page
When enabled this setting hides the content on the front page, enabling an all module display for the front page.
 
 
Ascent-layout-modules
 
The Layout Module Widths panel determines the width of module positions.
 
Equalise all module widths
When enabled all modules wil be given equal spacing across a row. So if there are two module published on a specific page then both modules will take approximately half of the width available for that row.
 
Setting individual module widths
When the Equalise all module widths function is disabled the settings for the module widtsh seen in the screenshot above are applied to the modules in each row.
 
Once again the numbers in this setting must add up to the number 12 (eg 12 columns) and each value must be separated using the | (pipe) separator. If you wish to set a specific module to have zero width - eg it is not being used pelase specify 0 here eg 6|0|3|3.
 
 
Ascent-Effects
 
Sticky Nav
When enabled the navigation is attached to the top of the screen when the user scrolls down the page.
 
Sticky nav threshold
This value determines the distance the user needs to scroll from the top for the sticky nav to take effect.
 
Lazy load
When enabled images below the visible area of the users screen are only loaded if the user scrolls down the page.
 
Lazyload Selector
By default this is set to img but if you want to be more specific you can target images in a specific div using the follwoing syntax #midCol img
 
Avoid Lazyload on this selector

Specifies a selector to not sue the lazy load effect on. eg .sidebar img.
 
Back to top
When enabled this adds an arrow to the bottom of the page that when clicked smooth scroills the user to the top of the page.
 

Mobile navigation

The Ascent Zen Grid Bridge theme uses a toggle menu for displaying the menu on small screens. The mobile menu is a separate module position called "togglemenu" and is automatically displayed when the browser is narrower than 740px.

To display a menu for small screens simply publish a new menu module to the togglemenu position.