Documentation
The demo of this template is currently running with joomla 3.9.10 / php 7.2
In the package, you have :
- This manual
- The template
- The responsive slideshow of this demo
- The Google map module of this demo (contact page)
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 options in Template manager".
How to obtain the Home page of the demo ?
- I install the slideshow module and publish it in the module position "image" (more details in the section "slideshow" )
- I created and published 2 main menus on the top (position "menu_left" and "menu_right" - see next paragraph "How to configure your menus")
- I make no change in Template manager
- There isn't any article in this page because the Type item by default for the Home page is "Article featured" and I haven't any featured article.
- For the text "Welcome" under the slideshow, I create a new module with the type Custom HTML. I choose the module position "top" and add the Module class suffix "text-centered" (more details in the section Module class suffix).
- For the four square (images and text) in a grey part. I create a new module with the type Custom HTML. I choose the module position "top" and paste the code to obtain this presentation. This code is explained here.
To obtain the grey background around the images, I added the Module class suffix "color-lightgray" in the module.
- For the images on a side and the text on the other side : I create a new module with the type Custom HTML. I choose the module position "text-image-top" (see the section Module positions) and paste the code to obtain this presentation. This code is explained here.
- For the video, I install a video extension (see section "Video" in the end of the manual) and I choose the module position "bottom". I added the Module class suffix "video-centered color-black" to centered the video and obtain a black background around.
- For the Social icons, I enter the complete url in Template manager (section "Social icons").
- I published the module "Latest news" and "Most read" in the module position "user7" and "user8" with the Module class suffix "vertical-menu text-centered"
- I create a new module with the type Custom HTML. I choose the position "user9" and the Module class suffix "text-centered". I write the text "Contact us" with the typography "Typography --> General --> Addresses"
- I create a new module with the type Custom HTML. I choose the position "address" and write the footer text.
- Finally, I create a new module with the type "menu" and choose the position "bottom_menu" to published the menu on the right side of the footer
Template Settings
You can access to the template manager with the top menu : "Extensions --> Template Manager --> joomspirit_126 "
With "joomspirit_126" template, you can set a lot of parameters. All the details here.
Module Positions
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 and slogan ?
You have 3 possibilities :
- By default, it's the website name in the section "Header" of Template manager. You can change the font, the size and the color
- Or in the same section, you can choose/upload an image for your logo. It's the first option of the section "Header --> Logo"
- For more freedom, you can create a new module with the type Custom HTML . Choose the position "logo" and put your image or text with the wysiwyg editor. With this last option, you can per example, display a logo for desktop and another image for small screen. More details in the Responsive section here.
Important :In Template manager, section "Header" you can choose the height of the Header in pixels and the vertical position of your logo. So it's easy to up of down your text or your image.
Note : your logo is automatically aligned (left, centered or right) to according with your main menu.
How to configure your menus ?
The dropdown menus (main menus):
With this template, you can displayed a drop down menu on the left side, on the right side or on both side.
On the demo, I create and published 2 menus for the Home page. The first on the left side and the second on the right side.
For the others pages, I create a third menu with a copy of all my menu items. I published this new menu on the right side. Of course, you must use the "Menu assignment" option to publish a menu (or any module) only on specifics pages.
Drop down menu on the top left side :
You can see this menu in action on the left side of the logo
To obtain that, you must select your main menu in module manager and enter these settings :
- position : "menu_left"
- Always show sub-menu items : "yes"
- none 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 :
Drop down menu on the top right side :
You can see this menu in action on the right side of the logo.
It's exactly the same settings with the module position "menu_right" :
- position : "menu_right"
- Always show sub-menu items : "yes"
- none Module class suffix
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 !).
How to display the slideshow of the demo ?
You can download this responsive slideshow on my website.
Install the module and edit it :
- choose the module position "image".
- I kept almost default options. Except these ones :
- In "Height of your slideshow", I choose "50% of the viewport" for Desktop and Tablets, and Height fixed = 440px for Phones
How to obtain or remove the arrow on the top and on the bottom of the slideshow ?
It's a specific option for this template so you must go to the Template manager, section "Slideshow" to change that.
How to obtain the static image in the others pages ?
I use always the same module. I duplicate it in Module manager and choose some specific pages with the option Menu assignment.
In "Height of your slideshow", I choose "40% of the viewport" for Desktop and Tablets. I choose "height fixed = 440px" for Phones.
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 :
- Click here to see the General typography : titles, alignment, drop cap, inset, background color, image, ...
- Click here to display an image with some text on the side and the background color of your choice. It's a powerful feature and fully responsive.
- Click here to see the Effects for your images.
- Click here to see the Column layouts.
- Click here to see the Multi columns with CSS3. Per example, I use that to display this list in 2 columns. Look the code of my screenshot :
- Click here to see the ordered and unordered lists.
- Click here to see the tables.
- Click here to see the 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.
- Click here to see the testimonials.
Module class suffix :
Options for displaying your modules in the "left", "right", "top", "bottom" or "user" positions :
- Without module class suffix : No styling for your list and the links.
- With the module class suffix " horizontal-menu" or "vertical-menu" : to display an additionnal menu.
- With the module class suffix " no-margin" : you remove the margin inside your module. It's useful if you want displayed an image in a Custom HTML module.
- With the module class suffix " border" : you add a border around your module.
- With the module class suffix " radius" : you add a rounded corner.
- With the module class suffix " shadow" : you add a shadow under the module (don't work with Black theme)
- With the module class suffix "color-XX" : you add a background color for your module. 148 colors available. Example " color-maroon" or " color-green" . All colors are shown here.
- With the Module class suffix "title-centered" : the module title is centered with a line on each side (you can't put "title-band" in the same module).
- With the Module class suffix "text-centered" : the text is centered.
- With the Module class suffix "title-band" : display a dark background under the module title (you can't put "title-centered" in the same module)
- With the module class suffix "badge-new", "badge-free", "badge-hot", "badge-top", "badge-news", "badge-gift" : to display a badge in the upper right corner of your module.
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"
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
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 ?
- Install the module "mod_google_map.zip" (you can find it in the package). Edit this module and choose the position "google_map", and don't forget to set the Menu assignement :
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
The video extension is not include in the package because there are a lot of free extensions available in Joomla extension website.
I used the free extension Videobox for my demo and I recommend you this one : very simple, responsive and easy to customize. You can download this plugin here.
- Install the plugin. In Plugin manager, publish the plugin (System --> Videobox) and the part for your Video provider (Videobox --> Vimeo per example).
In the plugin, I choose "player width = 980" and "player height = 600"
- After, I created a new module with th etype "Custom HTML". I choose the module position "bottom" and write the code for my video in the wysiwyg editor. And in Advanced options, I added the Module class suffix " centered-video color-black". With that , the video player is centered and the background is black.
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.
Bootstrap
The template is build with Bootstrap 3.1.1.
Tips and customization
Tip : How to display an article title above the slideshow 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") :
- "text-centered" if you want center all the text of your article.
- "color-XX" if you want add a background color for your article area.
Of course, you can add a multiple Page class. Example : " text-centered color-brown title-90"
Tip : (no content) I want display only the menu and the slideshow like here
In this page, only the Header and the slideshow are loaded.
This is the procedure :
- Of course, you must publish the menu and your logo
- First you must create a link to this page. You create a new article and keep the content empty. Then, you create a new menu item with the type "article --> single article" and select your empty article.
- In Module manager, duplicate the slideshow module end edit the copy. Choose only your new menu item in the section "Menu assignment". In the section "Height of the slideshow", choose "100% of the viewport" for all resolution
- Now you have your new menu item and your new page but you must hide the content box. In Module manager, you create a new module with the type Custom HTML. Choose the position "no_content" and in menu assignment, choose "only your new menu item". It's very important because when this module position is published, the content box isn't loaded.
- Its's all !!
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.
Search field
In the template manager, you can choose to display the Search field in the header (section "General").
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 ?
- Go to the Google font page. Choose your font and click on the button "quick use"
- Paste the code below and copy it 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 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 747 and 1047 :
<?php echo $js ; ?>
If after reading this manual you need help >>> Contact us