Knowledgebase

Joomlabamboo template and extension documentation

PureBusinessDoc Image

Getting Started

Please ensure that you read the getting started articles in preparation for working with this template.

This template also uses the Zen Grid Framework which makes controlling widths, colours and sub themes for the Joomla template a breeze. Please make sure that you familiarise yourself with the documentation for working with the Zen Grid Framework before you get started.

Please note that the new Reveal plugin we have used for the hidden panel in this template requires jQuery 1.5+ for optimum performance.

Module Positions

The screenshot below highlights the module positions available in this joomla template.

PureBusinessModulePositions

More settings

The Zen Grid Framework allows for flexibiility within individual templates while maintaining the same core codebase. The following are the specific variations to the Shopignition template.

Layout Overrides: Pure uses the Zen Grid framework layout overrides to help create the unique layout that you see on the Shopignition demo site. You can find these files in the templates/jbpure/layout folder. In general you do not need to touch these files but if you need to make some changes to any of the following areas, then this is where you need to make them:

  • banner
  • bottom
  • footer
  • header
  • grid1
  • grid2
  • grid3
  • jbtabs - The markup for the tabs has been moved into the grid3.php file
  • main
  • nav
  • panel
  • splitmenutop

If you need to edit or change the layout across any of these areas of the template then you will need to edit the files in the layout/ folder.

 

Rebranding

Please note that v1.1 of the framework provides the ability to easily replace the Joomlabamboo copyright in the admin of your template. In order to do this you still need to have either a developer membership or have purchased rebranding. Please ensure that you look at the documentation for the framework for how to use this new feature. You can read more regarding this in the Zen Grid Framework knowledgebase.

Extensions featured on the demo

All of the extensions available from Joomlabamboo are compatible with this template. Not all are required for the running of the template and only some are featured as a part of the demo site.

The modules used on the demo site include:

Please see below in the frontpage setup for screenshots of the modules as they are setup on the demo site of this template.

Pure front page setup

The screenshot below shows you the modules we have published on the front page of the demo site. Please see the descriptions below regarding the usage and any other relevant information of the modules.

PureFrontPageSetup

Description

  • Logo - The logo is using the Raleway font via Google Font replacement.
  • Tagline - A proven pure business formula text is derived from the template's tagline setting
  • Header4 - A custom html module with an h2 tag for the slogan. There is a slight offset int he template css for this position to help match the height of the logo on the left.
  • Header4 -A core Joomla menu module published to the header4 position. 
  • Panel1 - The JB microblog module is published to panel1. Once any module is published to panel1 to panel4 the Site Index Text (configured via the template) is displayed.
  • Banner - The JB Slideshow3 module is published to the banner position. You can see the specific configuration below. 
  • Bannerextra - A custom html module is published to the bannerextra position. The width and left offset for this position is controlled via the template under the layout panel. It will automatically position itself at the bottom of the banner module row.
  • Main Content Area - The content in the main area is a frontpage menu type which has two columns specified in the layout options.
  • Right - The right module position - or sidebar - has three separate custom html modules published to it.
  • Grid13 - A custom html module i spublished to the grid13 position.
  • Grid17 - A custom html module is published to the grid13 position.
  • Bottom1 - A custom html module with some social icons that can be found int he quickstart folder under the images/stories/icon folder.
  • Bottom2-6 - These modules are using latest news and most read modules.
  • Footer - the footer position has a core Joomla menu module published.

 

Slideshow settings

The screenshots below highlights the settings of the various modules included on the front page.

PureSlideshowFrontpage

    Controlling the bannerextra position.

    The bannerextra position is a non standard framework position and we have introduced the position for this template so as to allow the user to sit a module above either the left or right sidebar and have it extend into the banner area. This position needs to have an explicit width and left margin offset set in the templates layout panel  in order to allow for a variety of situations. The values set here do not need to have a px unit specified.

    There are three settings for this area.

    • Banner Height - Sets the height of the banner explicitly. This is required int he case that you do not also have a module published to the banner position.
    • Banner Extra Width - Sets the width of the bannerextra module.
    • Banner Extra Offset - This setting determines the distance between the bannerextra module and the left edge of the main content container.

     

    bannerextramodule

    The Pure demo site uses a standard .jbReadon class on the link tag in order to generate the styling used in that position.

    The custom modules below in the sidebar are custom html modules that use the following code as an example:

    <img class="floatleft" alt="clockIcon" height="63" width="53" src="/showcase/apr11/images/stories/democontent/icons/clockIcon.png"><p><strong>Save Time</strong><br>Lorem ipsum dolor sit amet, conse ctetuer adipiscing elit.</p>

     

    Configuring the K2 template

    The Pure Joomla template has K2 overrides built in and are activated simply by assigning the Pure template in the K2 category or via the K2 menu item if you are displaying multiple categories form that menu item. As you can see from the screenshot below the Pure K2 template takes all of the K2 meta information and outputs it into a slim right aligned column. If the meta info like date, comments, rating etc are not published then the item will just stretch to the full width of the content body.

    To assign the Pure template to your k2 categories and items you need to edit the category and apply the Pure K2 template as per the screenshot below:

    k2template

     

    In addition to this the Pure template also loads the k2.css file into it's own array which means that you can compress the k2.css file when you enable the template's css compressing setting. This means that to avoid the css file from loading twice you need to make sure that you disable the core K2 css in the K2 global parameters as per the screenshot below.

    k2disablecss

    Starting with Pure from a fresh installation of Joomla

    Although the this Joomla template is a simple design the default Joomla sample data doesnt quite do it justice and so here are a few steps to do if you are installing this Joomla template into a default Joomla installation.

    Elements to install.

    Essential elements

    • Install the Zen Grid Framework
    • Install the template and set it to default
    • Install the JB LIbrary plugin and enable it in the extensions > plugin manager
    Optional Elements
    • Install JB Slideshow
    • Install Microblog
    • Install the JB BB Code plugin (For two line menus)
    • Install K2

     

    Elements to unpublish

    • Disable the module title in the breadcrumb module.
    • Disable main menu items except for home menu item.
    • Disable the core banner module in the footer position.
    • Disable the core footer module in the footer position.
    • Unpublish modules published to the left module position.

    Change the position of some elements on the page

    • Move main menu to the menu position and make sure the module title is disabled. 

    At this stage you should have a pretty simple and straight forward site to start creating your site from.  It's important to remember that the slideshow and micro blog modules rely heavily on images in terms of the way that they present your content so it might be worth adding placeholder or stock images in your content as you go through setting up the rest of the modules.

     

    The screenshot below shows you the default Joomla installation after following the points above.

    Purefreshstart

     

    Troubleshooting

    A note about progressive enhancement

    The Shopignition template takes advantage of a few different css3 selectors that will render flawlessly in all modern and intelligent browsers - namely firefox, safari, chrome and opera. However, the rounded edges and text shadow on some of the elements will not display in internet explorer 6, internet explorer 7 or internet explorer 8.

    Rather than add extra javascript or convert these features to image based solutions we have chosen to allow these features to degrade gracefully. This in effect means that the shadow on the text will not display and nor will the rounded edges on the social icons and read more buttons.

    For more information regarding the philosophy behind graceful degradation or progressive enhancement in web design please read this post on A list apart.

    Are you using the latest version of the Zen Grid Framework?

    Oure is only compatible with v1.1 + of the Zen Grid Framework

    The super fish menu does not fade or slide it just drops down

    Please make sure you have installed and published the JB library plug-in and that there is only one version of the jQuery library loading on your page.

    My main content is not displaying

    Version 1.05+ of the Zen Grid Framework comes with the option of hiding the main content area on the front page e.g. the default menu item of your site. We've done this in order to help trim up any spacing or padding that is generated from the main content area that is not needed if you are not displaying any content on the front page. If you would prefer to display your content on the front page of your site, then please set the option to hide the main content area in the template parameters under layout >  Gen. settings to show.

     

    I get the following error after installing the Zen Grid Framework and a Zen Grid compatible template.

    Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in /homepages/26/d171984212/htdocs/tradenet/templates/zengridframework/includes/yth.php on line 36

    This error means that your server is using php v4 while the Zen Grid Framework needs php5 to function properly. Often changing to php5 is a matter of adding a rule to the htaccess file on your site but it's best to ask your host for help in determining the best way to use php on your server.