Documentation

In the package, you have :

Introduction

I don't provide any quickstart install so your website will be all white at the beginning. Don't worry. Read this manual and follow the steps in the next paragraph "How to obtain the Home page of the demo ?"

To customize the appearance of your website, read carefully the paragraph "Module positions" and "Responsive options in Template manager". It's the most important.

How to obtain the Home page of the demo ?

Template Settings

You can access to template manager with the top menu : "Extensions --> Template Manager --> joomspirit_117 "

With "joomspirit_117" template, you can set a lot of parameters. All the details here.


Module Positions

You can publish the slider module or a Google map on the left or right side of your website. These module positions are "media_left" and "media_right". By default, the width of each of them is 50% of the browser. But you can can change that in template manager. Your content will be displayed on the other side. In Template manager (section "width") you can set the maximum width (in pîxels) for your content part. If you choose a small value, you obtain a large empty space around your text.

This is a screenshot with all the module positions in the content part (all positions except "media_left" and "media_right")

:


How to display your logo ?

With this template, you choose if you want insert your logo image or just write your site name (by default) :

Go to the Template manager (section "Logo") and choose/upload your image. If no image is selected, the text of website title will be displayed.



And I added an option to display your logo on all pages, only on the Home page or never. Moreover, you can choose 2 positions : normal (above the content) or on the upper left corner with a small size.

How to configure your menus ?

The dropdown menu (main menu):

To use it, you must select your main menu in module manager and enter these settings :

  • position : "menu"
  • Always show sub-menu items : "yes"
  • No Module class suffix

Important : This main menu use javascript. If you have a javascript conflict with another extension, the menu can stop to work (it's not possible to open it).
Of course I recommend you to solved this javascript problem or search another extension. But if it's not possible, you can replace this menu by a classic menu without any javascript code. It's the last option of the section "Menu" in Template manager.

Additionnal horizontal and vertical menu

If you want display a second menu in the content part, you can choose almost 22 differents possibilities.

Click here to read all the details in the demo page with some examples.



Note : Except the main menu, all these menus work without javascript code (pure CSS : no risk of conflict with another extension !).

How to display the slideshow of the demo ?

This module is included in the package and I created specifically for this template.

Install the module and edit it :



How to add a link in the text like in the Home page demo ?

You must write the html code directly in the text field. Example :



Is it possible to display a different slider on each page ?

Yes of course. In Module manager, select the module and duplicate it. Edit the copy. Choose your new image(s) and set the Option Menu assignment for each instance of your module.

Why the first image load slowly ?

I added an animation for the first image (the first rotation of the cube). If you want display the first image very quickly, you can disable this first animation (first option in the section "general").

Why my images are cropped ?

Your images are automatically resize to fill all the area of the module position. And your images will not be distorted of course. So each image will be cropped a little to according with each screen size. I recommend you to put the main subject of your image in the center.
For my demo, the size of my images is 800 * 1000 pixels.

Responsive options in Template manager

In this section you can disable the Responsive feature but I do'nt recommend you that.

Most important, you can choose when the cube slider will be displayed above the content (7 possibilities). I recommend you to make some test with different values (resize your browser to see the result).

Typography

You can find a lot of possibilities to create a beautiful website. I explain all that in the demo :

Module class suffix :

Options for displaying your modules in the "left", "right", "top", "bottom" or "user" positions :



Extra Module class suffix for a slideshow :



Note : If you choose a background color , the color of module title is always white.

Note : You can enter several Module class suffix. Example "shadow green badge-top title-centered"



Extra Module class suffix for mobiles

For faster mobile-friendly development, use these utility classes for showing and hiding content by device. More details here

Bootstrap

The template is build with Bootstrap 3.1.1.





Tips and customization

Tip : don't forget the option "Menu assignement"

This option is available for all modules and templates. It's a very powerful option and I recommend you to use it !

With this option, you can published a module or a template only on selected page(s). And you can duplicate any module or template.

So if you want modify the settings of your template only on few pages, it's possible and very easy with this option.

Tips for the user modules

In the template manager, you can choose the width for user1 and user2. The width of user3 automatically adjusts.

So, if you publish only one user module : publish user3 (for a width of 100%).

If you publish two users module : publish user1 and user3, or user2 and user3.

How to add a new Google font in Template manager ?


In this example the code is : Playfair+Display+SC:400,700italic

How to add an icon before a menu item or before an article title ?

Click here to see the details of Font Awesome.
Font Awesome allows you to add vector icons from a library of over 360 to any part of your joomla template including Articles, Article titles, Menu items and Module titles.

Tips for your images

By default, a border is added around all your images in your articles. You can disable this option in the section "General" of Template manager.

If you want add this border only on specific images, disable this option and add the class "js-border" in the HTML code of your image.

If you want remove this border only on specific images, enable this option and add the class "no-style" in the HTML code of your image.



Customize the template

You can put all your custom code in the file "css/custom.css".

Photos credits

In this demo I use some photos with the licence Creative commons paternity. I resized the photos to obtain a size of 800 x 1000 pixels. These are the photographers :

Link

To continue to offer affordable prices, I decided to display a soft Copyright in the bottom right corner to increase awareness of the site JoomSpirit.

This does not affect your site, but if you want remove this link, you must edit the file "index.php" and delete this code line 575 :

<?php echo $js ; ?>