Documentation

The demo of this template is currently running with joomla 3.9.10 / php 7.2

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 "Module class suffix".
And before launching your website, I recommend you to verify the result in all screen resolutions. It's simple : resize the window of your browser and look the difference. To adjust the result, you have some important options in the section "Responsive" and "General" (to adjust the background image and the position of content box) in Template manager".

How to obtain the Home page of the demo ?

Template Settings

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

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


Module Positions

These are all the module positions available, except the position "debug" in the footer.

Note : the position "image-text-top" and "image-text-bottom" are special : you must use them only to display a text on a side and an image on the other side.

Note 2 : To display a background image you must use the options in Template manager (section "General") OR the position "image" if you prefer a slideshow.



Example for the "address" position : go to the module manager and create a new module with the option "custom html". Write your address or/and copyright and choose the position "address".

How to display your logo ?

You have 3 possibilities :

Important :In Template manager, section "Header" you can adjust the vertical and horizontal position of your logo. So it's easy to down your text or your image.

Note : your logo is automatically centered in small screen.

How to configure your menus ?

Main menu on the Left part (dropdown or accodion menu):

By default, the main menu is a dropdown menu and the Left part is fixed. You can change that in Template manager (section "Left part") if you want a fluid column and / or an Accordion menu.

Then, go to the Module manager to set your menu. Edit your main menu in Module manager and enter these settings :

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

Note for mobile devices : the type of all parent items must be "external url" (don't use the type "text-separator"). Choose the type "external url" and enter the character # in the url field :




Bottom menu

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

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

Note : you can use only 1 level of links with this menu.



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 : All these menus work without javascript code (pure CSS : no risk of conflict with another extension !).

Display a background image or a slideshow ?

A background image

It's the simplest and fastest. You must upload your background image in the folder "images" of your website. Then, go to the Template manager (section "General") and select your background image.

The third option is very important : you can choose when the content box will be under the background image. By default, it's under 980 pixels and in the next options, you can choose the height of the background image (when the content box is under the background image).

After these options, you can enable/disable the mask around the image and change the color, transparency and size of this mask. You can choose a square or a triangle for your mask.

A slideshow

It's possible to display a slideshow. Look this page to see an example.

You must download the responsive slideshow on my website.


Install the module and edit it :

What is the size of my images ?

I use a size of 1600 x 1000 pixels and I compressed each image with a ratio of 65% in JPEG optimizer.

Responsive options in Template manager

In this section you can disable the Responsive feature but I don't recommend you that.

Most important, you can choose when the Left and Right columns and the Users modules position will be displayed inline.

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 :



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

Note : You can enter several Module class suffix. Example "shadow color-green badge-top title-centered min-height-400px"



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

How to display a video like on the demo ?

I include a video module in this template. It's very simple and work with the video from Vimeo and Youtube.

Thank you very much to peter amber to share this beautiful video.



Note : the video is not cropped to match the size of each screen. So you can see a border around.
When you display a video, the content is always under the video (never in a corner).



Very easy to use :


With Youtube :

It's the same thing : you must copy the ID of your video in the url.





How can I change the height of the video ?

It's the same height as your background image with the option "content box always under the background image" in Template manager (section "General")

How to display a Google map like here ?

I wanted a module very easy to use. So I choose to display the standard Google map and you can create it in less than a minute !

How to publish your google map ?


How to obtain the URL of my Google map ?

In the "simple Google map" you must enter the URL of your map and only that.

Go to the Google maps

Choose your location and click on the "parameters" icon :



In the new window, copy the URL and paste it on your Joomla module :




note : you must create a google account to add a marker

Bootstrap

The template is build with Bootstrap 3.1.1.





Tips and customization

Tip : How to display an article title above the background image like here ?

To obtain that, I edit the menu item of this page and I add the page class " title-90" in the section "Page display" :



With this code the title will go up 90 pixels. It's enough with the size of my title but it's perhaps not a good distance for you. So I include a lot of possibilities ; you can add " title-60", " title-70", " title-80", ... until " title-150".

You can choose a specific font size, color and shadow for this type of title in Template manager (section "Content box").

Restrictions

This option work fine if none module is published between your article and the slideshow. Per example, you mustn't use it if you use any "users_image" module or "top" position.

That work with component page too (single contact, category blog, ...) but when you edit your menu item, you must display the "page heading" in the section "page display" and you must add an empty space before the Page class.

Note : This option is disable when the screen width is less than 600 pixels.

Tip : How to center all the text of an article and / or add a background color for your article area ?

To obtain that, You must edit the menu item of this page and add the page class of your choice (section "Page display") :


Of course, you can add a multiple Page class. Example : " text-centered color-brown title-90"

Tip : (no content box) I want display only the Left part and the slideshow like here

In this page, only the Left part and the slideshow are loaded.

This is the procedure :

Create several themes for your website : 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.

Search field

In the template manager, you can choose to hide / show the Search field in the footer (section "Left part").

How to obtain the page Category blog ? articles in 2 columns with the images

Firstly, you must create some articles with the same category.

In each article, I display an image with an hover effect and the text below.


I explain how to obtain that in this page. Example, this is the code of my "Article one" (you must disable the wysiwyg editor) :



Now you have created your articles, so you must create your new menu item in Menu manager. Choose the menu type "Category blog" and look my settings in the section "Blog layout" to obtain 2 columns :



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 CSS code in the file "css/custom.css".

Photos credits

In this demo I use some photos with the licence Creative commons zero from Unsplash. Thank you !

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 1020 :

<?php echo $js ; ?>

If after reading this manual you need help >>> Contact us