Setting up our Demo

This template offers a versatile layout with three columns and multiple module areas placed under the component, four footer modules and finally a module position for your hero/ slideshow module.

Due to the nature of the site both sidebars (left and right) have two module areas. This give you ultimate control over your content. If you use the kiwi_Right_Lower position in larger screens (1500px and above) a fifth column will appear, displaying the sidebar modules in two columns instead of one.

Template functionality.

From the template’s settings view apart from the colours, you can also control most of the template’s functionality.

• You can select each category’s main colour.
• Specify a fixed site width
• Enable the heading and the date on the header (see the demo)
• Use your own colour variations
• Enter your social links

Setting the site width

As you can see from the demo page the site will extend to the full width of the viewport. The layout will stretch from a one to a five columned layout depending on the screen size.

You can easily change this option and specify your site’s width by simply enabling the option in the template’s parameters.
Make sure you follow the instructions and enter a value in pixels. For more information please see the visual walkthrough.

Setting up the menus.

This is a template designed to support multiple menus with each one being different.

Setting up and using the main menu

This part is really straightforward. Simply publish a menu module in the kiji_Menu position.

If you want a menu similar to the demo site then read the “Hiding the main menu on smaller viewports” section bellow.

Using the mega menu

Using the mega menu is very easy. Publish your menu module at the kiji_MegaMenu position and use the secondary-menu suffix.

Now all you need to do it publish a module, there is a K2 Content template for these modules, for each sub-menu item.
Go to Menus -> (Your Menu name ) select the menu item you wish to have a lower level and write down its id.

The id is the last part of the URL e.g. of xxxx: id=100 keep the 100. Then publish a module at the mega-menu-item- position. In this case the position would be mega-menu-item-100. The visual walkthrough contains images of this procedure.

Using a custom menu

Several custom menus appear on the demo site. The App menu and custom menus are both Joomla menus.
Use the custom-menu module suffix if you want your menu links to be underlined like the demo.

Using the login/ register menu

Another feature of this template is the login menu and the kiji_Login_Menu module position. This is a small menu which due to space restriction can ideally contain only a link to login or to register to the site.

Hint: If you want your menu links to turn into icons in smaller screens you can use the register-link and login-link CSS classes.

Using a social menu

The social menu (the one placed on the footer) uses its own overrides. You need to choose the appropriate layout for the module’s settings. You can do this by selecting the “social” option from the Alternate Layout select box.

Finally don’t forget to set the appropriate CSS class (Link CSS Style). The class should be the name of the network, e.g. facebook, twitter, google-plus, vimeo etc.

Hiding the main menu on smaller viewports (Like the demo).

If you want to have your main menu in two different module areas like the demo site you have to follow these simple steps.

1) To hide the main menu module area from smaller viewports you need to enablet the “Hide the main menu in smaller viewports” setting from the template params.

2) Then you need to publish your menu module in another position e.g. in the Kiji_Left position like demo.

3) Finally use the show-for-medium-down module suffix to hide the module in larger viewports.

K2 Content and Categories setup

Using the leading items

This template uses a specific template for leading items (category_item_leading.php). This template is different from the rest of the item listings. It hides several elements like the intro text and it uses another layout and image size. It’s image is much larger and stretches from end to end while the text is enclosed in a white box with a coloured border. If you do not want this layout or your content does not consist of larger images then you should probably not use any leading items.

Using the primary items

Primary items are used throughout the site. They have the typical blog/portal look and feel. The medium image size is suggested since the image will be floated to the left.

Using the secondary items

Secondary items once again have are different. They also use a different template - category_item_grid.php. From the template name it is clear that these items are intended to be used if you want a gridded layout instead of a blog layout.

Example:
In the homepage we are using one leading item. This it the first item which has a full sized (large) image. We are also using four “normal” items, these are all primary items with medium sized images.

K2 Content module templates

• 2ColWithImages - Used in the homepage, the two columned module with background images.
• Default - The default item listing.
• Hero - The two columned module above the main component area.
• Masonry - The “Quick Reads” modul, uses the Masonry jQuery plugin.
• MegaMenuItem - The module for the mega menu items.
• ReadThis -The template for the "Read this" module.
• Slider - The slider used for the “Latest Reviews” module.
• Video - The main video module. Clicking on the image will start the video.
• VideoSidebar - Similar module but with no video playing functionality.

Module positions

• kiji_Menu
• kiji_Login_Menu
• kiji_MegaMenu
• kiji_Search
• kiji_Left
• kiji_Right
• kiji_Hero
• kiji_Component
• kiji_Under_Component_1
• kiji_Under_Component_2
• kiji_Under_Component_3
• kiji_Under_Component_4
• kiji_Under_Component_5
• kiji_Under_Component_6
• kiji_Above_Footer
• kiji_Footer_1
• kiji_Footer_2
• kiji_Footer_3
• kiji_Footer_4

Image Sizes

The following image sizes are recommended for this template:

• XSmall 100
• Small 200
• Medium 320
• Large 900
• XLarge 1200
• Generic 320
• Category Image 100
• Avatar Size 150
• Commenter Image 112

Module Suffixes

• .left adds a float:left to a block.
• .right adds a float:right to a block.
• .text-center adds a center alignment to a block.
• .text-right adds a right text alignment to a block.
• .text-left adds a left text alignment to a block.

Module headers

The "Quick Reads”, “Read This” and “Latest reviews” modules use icons as a part of their headers. To use these icons you have to use there module suffixes:

• loading-header
• phone-header
• eye-header
• Additional Components

Apart from the K2 component we offer CSS styling for the following components
com_contact (form only)
com_users ( all views )
com_search
com_weblinks
com_newsfeeds

Commercial Extensions

Simple Image Gallery Pro - After installing it go to the Extension's parameters Layout template for image galleries and choose the one named after the template, i.e. getK2.

For developers and enthusiasts

The Grid

We are using ZURB's foundation grid for this template. You can find out more about foundation here: http://foundation.zurb.com/

Addtionally we have added a grid for larger (xl) and very large (xxl) viewports.

Block Grid 

We have included Foundation's block grid.
More info can be found here. http://foundation.zurb.com/docs/components/block-grid.html

Visibility Classes

If you need complete control over your modules in responsive states we 've got you covered. This template uses the power of the The most advanced responsive front-end framework in the world, ZURB's foundation.

.hide-for-small Hides the module in viewports bellow 767px
.show-for-small Shows the module in viewports bellow 767px
.hide-for-medium Hides the module in viewports above 768px and bellow 1279px
.hide-for-medium-up Hides the module in viewports above 768px
.show-for-medium Shows the module in viewports above 768px and bellow 1279px
.show-for-medium-up Shows the module in viewports above 768px
.show-for-medium-down Shows the module in viewports bellow 1279px
.show-for-large Shows the module in viewports above 1280px and bellow 1440px
.show-for-large-up Shows the module in viewports above 1280px
.hide-for-large Hides the module in viewports above 1280px and bellow 1440px
.hide-for-large-up Hides the module in viewports above 1280px
.show-for-xlarge Shows the module in viewports above 1440px
.hide-for-xlarge Hides the module in viewports above 1440px
.show-for-landscape Shows the module in the landscape orientation
.hide-for-landscape Hides the module in the landscape orientation
.show-for-portrait Shows the module in the portrait orientation
.hide-for-portrait Hides the module in the portrait orientation

All these classes are located in the template.css and can be easily expanded and/or edited and can be used for every block of your template, not just your modules.

More info can be found here: http://foundation.zurb.com/docs/components/visibility.html

Icon Fonts

We have included the Entypo family from fontello.com and the drip icon font family http://demo.amitjakhu.com/dripicons/ in this template. The stylesheet is embedded with the main template.css file.

k2.css

As you might have noticed this template does not use the default k2.css. We have completely rewritten all the template's styles to be more efficient. In case you download the standalone template package we have included a blank k2.css file in our distribution to avoid 'breaking' you site.

SASS

In your template's /css folder you will find a /src subfolder. There you will find all out .sass files.
We have also used Bourbon which is a simple and lightweight mixin library for Sass

What is SASS: http://sass-lang.com/
What is Bourbon: http://bourbon.io/ 

Visual Walkthrough