The following installation guide will provide you with instructions to install and setup the Diverse Shop Virtuemart template for the latest version of Joomla 4.x and Virtuemart for Joomla 4.x

Template Usage

Before using or installing this template please read the https://www.virtuemarttemplates.net/terms-of-service.html which you have agreed to before downloading the template at the https://www.virtuemarttemplates.net website

Template Support

Please note we only provide support for using and setting up the Joomla template you have downloaded at the website.

If you need support for the template please using one of the following options

1. We recommend you install the template quick start package which will give you an exact copy of the template you can see running at the http://demo.virtemarttemplates.net/diverseshop site and it will save you a lot of time setting up the template. The template quick start package is also very useful to understand how we have setup Joomla & virtuemart for the template.
2. Log into the http://www.virtuemarttemplates.net visit the knowledge base which includes lots of useful information about how to use and setup the template.
3. Log into the http://www.virtuemarttemplates.net website and open a support ticket and our support team will be happy to help you with any questions you may have about using or setting up the template

If you need support for Joomla or Virtuemart please visit one of the following websites

1. Joomla documentation website http://docs.joomla.org
2. Joomla forum http://forum.joomla.org
3. Joomla tutorials http://www.joomlatutorials.com
4. Virtuemart documentation website http://docs.virtuemart.net
5. Virtuemart tutorials http://docs.virtuemart.net/tutorials.html
6. Virtuemart forum http://forum.virtuemart.net

Joomla & Virtuemart Installation

Before installing this template you need to do the following.

Note: If you use the template quick start package the quick start package will install both Joomla and Virtuemart for you plus the Joomla template.

1. Download and install the latest version of Joomla 4.x from the http://www.joomla.org website at your website
2. Download and install the latest version of Virtuemart for Joomla 4.x from https://dev.virtuemart.net/projects/virtuemart/files

Template Package Contents

This template package includes the following.

1. Template zip file for latest version of Joomla 4.x and Virtuemart which can be installed automatically via your Joomla administrator area.
2. Adobe Photoshop file.
3. Template Install Instructions
4. Template Quick Start Installer for Joomla 4.x plus Virtuemart and the template setup for you
5. Template images directory which includes the images we have used in the template

Installing The Joomla Template

To install the Joomla template complete the following

1. Log into the Joomla administrator area of your website
2. Select the System menu and Install Extensions
3. Select the Browse button and choose the template zip file located in the Joomla 4.x directory included in the zip file you have downloaded from the website to your computer
4. Select the Upload & Install button

How Do I Set The Template As The Default Joomla Template

1. From your Joomla administrator area select the System menu and Site Template Style
2. Select the check box next to the Joomla template you have installed
3. Select the button Default

How Do I Setup The Virtuemart Template

To setup the virtuemart template complete the following

1. Log into your Joomla administrator
2. Select the components menu and Virtuemart
3. Select Virtuemart configuration tab and the configuration menu
4. Select the Templates tab
5. Setup the virtuemart template as show in the screen shot below

Template Module Positions

The template supports the following module positions

1. Login form button and register button located at the top of the template use the loginform module position
2. Virtuemart shopping cart module uses the cart module position
3. The small menu which appears at the top of the template uses the quick-menu module position
4. Top menu uses the position-1 module position
5. Joomla or the Virtuemart Search uses the position-0 module position
6. The slideshow which appears at the top of the template uses the builtin-slideshow module
7. Pop up left and right boxes uses header-left and header-right module positions.
8. Breadcrumbs uses the position-2 module position
9. Top-1, Top-2, Top-3, Top-4, Top-5, Top-6, Top-7 ,Top-8, Top-9, Top-10, Top-11, Top-12 module positions located at the top of the template use custom module positions where you can add your own text or images inside the module positions
10. Top-left-1, Top-left-2, bottom-left-1 and bottom-left-2 modules appear on the left hand side of the template
11. Position-7 module position is used to display web site navigation menu or the Virtuemart module navigation menu in the left hand column of the template
12. Top-long module position which appears in the centre of the template can used for the news flash module or for a custom module
13. Top-A, Top-B, Top-C, Top-D module positions located at the top / centre of the template use custom module positions
14. Right module position can be used to publish other modules of your choice to the right module position
15. top-right-1, top-right-2, bottom-right-1, bottom-right-2 modules appear in the right hand side of the template
16. Bottom-A, Bottom-B, Bottom-C, Bottom-D module positions located at the bottom of the template use custom module positions
17. Bottom-long module position appears at the bottom of the template
18. Bottom-1, Bottom-2, Bottom-3, Bottom-4, Bottom-5, Bottom-6 module positions located at the bottom of the design use custom module positions plus you can publish the latest news or popular news to the module positions to the modules
19. Footer-right module is used to display your website copyright text using a custom module position
20. Footer-left module is also used to display a menu module

How Do I Access The Template Settings

To access the template settings please complete the following.

1. Log into your Joomla administrator area
2. Select the System menu and Site Template Style
3. Open the template you have installed by clicking on the template link from the list of templates
4. You will now see the template settings as show in the screen shot below
5. For more information about how to use each setting included in the template control panel PLEASE HOVER OVER THE TEXT NEXT TO EACH SETTING
6. You can also find out more information how to use the template settings by logging into the http://www.virtuemarttemplates.net site and visiting the knowledgebase

How Do I Create The Custom Banner Modules

The custom banner modules shown in the screen shot below use custom HTML module type.

In the template demo the modules uses top-1 and top-2 modules positions

You need to create new custom module for each banner module following the instructions noted below.

You can find the images show below in the the template package you have downloaded from VirtueMartTemplates.net. However you may also want to use your own image. If so, make sure an images has a proper size so, it's covers whole module position. In our demo we used 570x190px for both images.

To create a custom module position complete the following steps

1. From the Joomla administrator select the Module menu.
2. Select the New button
3. Select the Custom HTML option
4. Now setup the module as show in the screen shots below.
5. When you have setup the custom module select the Save & Close button to save and publish the module to your Joomla site.
6. If you want the module position to appear on ALL pages you need to assign the module positions to ALL the menu items

How Do I Set Up Front Page Tabs

Tabs Module Position automatically puts your modules into the tabs. To set tabs on your front page publish your modules to tabs-1 module position. Module title will be used as a tab label.

How Do I Add The Read More Button To The Custom Module

To add the read more button which appears in the custom module position complete the following

1. Open up the custom module position you have created
2. Scroll down to the WYSIWYG editor at the bottom of the module position
3. Select the tools menu and source code menu in the WYSIWYG editor to open the HTML window
4. Under the text you have entered into the custom module position copy and paste this text into the HTML window
5. <p><a class="button" href="#">Read More</a></p>
6. Change the # to the web site address for the article you want to point the read more button to.
7. Save the changes
8. Read more button will now appear in the custom module position you have created

Top Menu Module Settings

To change the top menu module menu style please complete the following.

1. From the Joomla Administrator area select the modules menu
2. Now select the top menu module which needs to use the position-1 module position.
3. In the Menu Tag ID field enter nav
4. In the Menu Class Suffix field enter -nav
5. To enable the drop down menu for the top menu position set the "Always show sub-menu items" to YES
6. Click on the save button.

How Do I Set Up Ribbon On Top Menu Item

Nice eye-catching ribbon can be easy added to your menu item.

1. Open Menus -> Your Top Menu and select menu item you want to add a ribbon to
2. Dind Note field and type a lable for your ribbon
3. Click Save & Close.

How Do I Set Up The Built-in Mega Menu

To set up the built-in mega menu please follow these steps:

1. First of all prepare a new menu which will be used for mega menu. Make sure you add only a first level menu items (without sub-items) to your new menu. To add new menu please go to Menus -> Manage -> Add New Menu. For the demo purposes we called our menu 'Mega Menu'.
2. Now you need to turn on the mega menu and select a menu which will be used for mega menu purposes. To do this please go to Extensions -> Templates and click the template name to open the template settings. Now select Drop Down Menu Settings tab and set up mega menu settings as following:

3. Your mega menu is now ready to use. Now you can add a sub-items and any module you want to use. To add a sub-items menu please go to Menus -> Manage -> Add New Menu and create new menu - called for example Smart Phones Items.
   Now, to add you sub-items menu to mega menu please go to Extensions -> Modules and add new Menu module. Provide following settings:

Where can I find MENU ITEM ALIAS

Menu Item alias has been created automatically when you added menu items to your Mega Menu menu in Menus -> Manage.

You can add up to 12 modules into one module position. There is available 3 modules position which can be used with menu items as following:

menu-position-1-MENU_ITEM_ALIAS
menu-position-2-MENU_ITEM_ALIAS
menu-position-3-MENU_ITEM_ALIAS

So, to could use modules positions under Watches menu item as on our demo simply add watches alias to could publish modules:

menu-position-1-watches
menu-position-2-watches
menu-position-3-watches

IMPORTANT! - please note the modules positions are not available on the list of predefined modules position in module settings. You need to type module position name in Position field as following:

4. Set up sub-items handler width

Each menu item sub-items handler can use specific width. To set up the width please simply do following:

1. Go to Menus -> Mega Menu created before
2. Open menu item settings, open Link Type tab and type a width in 'Link CSS Style'

5. Add more modules to mega menu

You can add any type of module to the mega menu. For the demo purposes we added some custom HTML modules. Please see the settings for Custom HTML module published under 'Cameras' menu item

How can I hide/show modules on different devices

The template provides a classes which can be used in module settings in Module Class Suffix field to hide/show module on mobile devices, laptops or desktops. To could manage it please simply use following classes in Module Class Suffix field:

visible-phone
hidden-phone

visible-tablet
hidden-tablet

visible-desktop
hidden-desktop

IMPORTANT! - Make sure you type a space before the class name in Module Class Suffix.

How Do I Setup The Slide Show

The template includes a built-in slideshow where you can display images in the slideshow you have uploaded to the web site.

To setup the slideshow you need to complete the following three steps

1. Create images which will appear in the slideshow
2. Create a custom module position for each slide show image
3. Open the template control panel to change the slide show settings

Create Images For the Slideshow

The first step is to create new images which will appear in the slide show.

1. Create a new .JPG image
2. If you want to add four images to the slide show then you will need to create four new images
3. Save the images to your computer

Create A Custom Module Position For Each New Slideshow Image

The Second step is to create a new custom module position for each image which will appear in the slideshow.

1. From the Joomla administrator area select the Module menu.
2. Select the New button
3. Select the Custom HTML option
4. In the module title enter the name for the new slide. The title will NOT be displayed in the slideshow
5. Assign and publish the module to the builtin-slideshow module position
6. In the WYSIWYG editor enter the heading and text which will appear as a caption over the slideshow image
7. Create a read more button to link to an article in your Joomla site (see instructions below)
8. In the options tab choose the SELECT button to upload and select the slide image you have created for the slideshow
9. Save the changes to publish the image to the builtin-slideshow module position

NOTE!
To could move the slide caption to the right hand side go to Advanced tab in your slide module and in Module Class Suffix type ' move-right'. Make sure you put an empty space before move-right suffix.
The captions positions settings can be found in the template settings area in BUILT-IN SLIDESHOW SETTINGS tab.

How Do I Add More Images To The Slide Show

You can add as many images to the slideshow as like but for each image you add to the slideshow you must create a new custom module position by following the instructions noted above for each new slide you add to the slideshow.

The slideshow image ordering can be changed by changing the module order for the custom modules you have created and published to the builtin-slideshow module position.

Slideshow Settings

The 3rd step is enable the slideshow in the template control settings.

To enable the slideshow in the template control panel complete the following.

1. Log into your Joomla administrator area
2. Select the System menu and Site Template Style
3. Open the template you have installed by clicking on the template link from the list of templates
4. Select the built-in slideshow settings tab
5. Next to the Turn Slideshow ON/OFF slide the button to ON
6. Save the changes by clicking on the Save & Close button

You can also change the slideshow show effects and many more options included in the built-in slowshow settings tab.

For more information about how to use the slideshow settings PLEASE HOVER OVER THE TEXT NEXT TO EACH SLIDESHOW SETTING

How Do I Setup The Login & Registration Buttons

To setup the login and registration buttons which appear at the top of the template complete the following

1. Log into your Joomla! administrator area
2. Select the Module menu
3. Open the Joomla login module
4. Assign the login module to the loginform module
5. Save the changes to the module position

How Do I Setup The Our Partner & Brands

To setup the Virtuemart Manufacturers module (our partner and brands) located at the bottom of the template see the screen shot below.

Please note you need to upload the manufacturers images via the Vistuemart administrator area first before setting up the module.

How Do I Setup The Contact Us Module

To setup the module complete the following steps

1. From the Joomla administrator select the Module menu.
2. Select the New button
3. Select the Custom HTML option
4. Now setup the module as show in the screen shots below.

How Do I Setup The Footer Menu

To setup the footer menu you need to log into your Joomla website administrator area and select the menus option and then add new menu

When you have created the new menu for the footer menu please use the settings included in the screen shot show below.

How Do I Add The Footer Copyright Text To The Template

To add and copyright footer text included at the bottom of the template you need to create a custom module position as assign the module to the footer module

1. From the Joomla administrator select the Module menu.
2. Select the New button
3. Select the Custom HTML option
4. Now setup the module as per the screen shot.

How Do I Set Up Products/Manufacturers Slider Module

To add a product/manufacturer module to your online store please follow these steps:

1. Go to Extensions -> Template Manager
2. Select the template name and open Product Slider Settings or Manufacturers Slider Settings
3. Set up sliders script to fit it to your needs

4. Now go to Extensions -> Module Manager and click New button on top menu to create new VirtueMart Products Module or VirtueMart Manufacturers Module
5. Provide the modules settings as following:

How Do I Set Up Products/Manufacturers Slider Module Centered

The template allows you to use 2 styles for sliding modules. One where the module title is on right hand side and slideshow navigation on right and the 2nd where all is nice centered

To make the modules centered follow these steps

1. Open your product, manufacturer module and select Advanced tab
2. In Module Class Suffix field add ' centered' suffix (make sure it is the last on the list if you have more suffixes)

How Do I Set Up Pop Up Boxes

Pop Up Side boxes using header-left or header-right modules positions. Labels of pop up boxes open buttons are using a title of first modules published to header-left or header-right modules positions.

To set up pop up boxes please follow these steps:

1. Go to Extensions -> Template Manager
2. Select the template name and open Side Pop Up Box Settings and set up pop up script to fit it to your needs:

3. Now go to Extensions -> Module Manager and click New button on top menu to create new custom HTML modules
4. Provide the module settings as following:

How Do I Set Up The Testimonials Box

The Testimonials Box works very similar to the Built-in Slideshow. Each item is in fact a custom HTML module which you can easy create and add to the testimonial slider in Extensions -> Module Manager. Custom HTML module must to be published to position-3 module position. Before you start to add a testimonials items make sure you have configured a testimonials box in the template settings area on TESTIMONIALS SLIDER SETTINGS tab.

How Do I Add An Items To The Testimonials Box

To add an item to your testimonial tab please follow these instructions:

1. On Joomla Top Menu select Extensions -> Module Manager
2. Select New button on top toolbar and provide a settings for testimonials item as following: