OnSale - Joomla Template Documentation
OnSale is a Joomla! E-commerce template designed for 2 most popular e-commerce extension VirtueMart and HikaShop. It will be joy to design your e-commerce website with OnSale template powered by Gantry 5 framework and 200+ design blocks with easy to use and drag & drop particles.
Note: HikaShop Wishlist, Compare and filters on left sidebar designed with HikaShop pro version which isn't included with this template.
- Installing Joomla Template: Read If you're installing the template on your existing Joomla website.
- Installing Joomla Quickstart Package: Read If you're creating new website with this template.
Atoms are Particles that do not appear visually on the front end, but do serve an important purpose. They can be assigned on a per-page basis, or as a default which automatically applies to all of the pages on the site.
Required Atoms:
- JavaScript Frameworks
- RcaTheme Elements
How to add and Configure Atoms
- Go to Gantry Admin
- Switch to Base Outline
- Click on Page Settings
- Scroll to bottom and you will see Atoms area.

Required Atoms Settings
-
JavaScript Frameworks
-
RcaTheme Elements
From the RcaTheme Elements Atom, you could enable/disable theme features such as: ToTop, Fixed Header, Cookie Consent, Extra Typography etc.
-
FontAwesome Icons
- Go to http://fontawesome.io/icons
-
Click on your desired icon and copy the code. For example -
<i class="fa fa-smile-o"></i>
for and paste on your Particle, Joomla article and module editor by switching Code editor (HTML).

-
Adding/Changing Logo
- Go to Gantry Admin
- Click on Layout tab
-
Scroll to the Header section and click (config icon) next to the Header Toolbar particle
- Now see Logo - Options and follow on-screen instructions
-
Search HikaShop
- Download RCA HikaShop Search pkg from your download area of RcaTheme.com if already didn't
- Login to your Joomla! Administrator
- Install the package you have downloaded using Joomla!'s default extension installer.
- Go to Extensions > Modules
- Click on New to create new module and select RCA HikaShop Search
-
Now follow on screen instructions and setup.
-
Search VirtueMart
Make sure you have installed mod_virtuemart_category_search_v.x.x.x.zip provided with the template.
- Go to Extensions > Modules
- Click on New button to create new module and select VirtueMart Category Search
-
Now follow screenshot and setup-
-
Login/Register and Usermenu
- Go to Gantry Admin
- Click on Layout tab
-
Scroll to the Header section and click (config icon) next to the Header Toolbar particle
- Now see User menu - Options and Login Module and follow on-screen instructions
-
HikaShop Cart Module
- Go to Extensions > Modules
- Click on New button and select HikaShop Cart Module
-
Now follow screenshots and setup-
-
VirtueMart Cart Module
Make sure you have installed mod_virtuemart_minicart_v.x.x.x.zip module provided with the template.
- Go to Extensions > Modules
- Click on New button and select VirtueMart Mini Shopping Cart
-
Now follow screenshots and setup-

-
Categories menu on home page
- Create necessary menu and sub-menu items using Joomla!"s default Menu Manager. For shop category and product menu items, create menu items by assigning them with your existing HikaShop or VirtueMart categories.
- Go to Extensions > Modules
- Click on New button and select Gantry 5 Particle
-
Click on Pick a Particle and select "Menu" from popup list. Then follow on-screen instructions and setup. See screenshot-
- Add position name: showcase-a
- Menu Assignment: Only on the pages selected; select your Home page only.
-
Categories menu on other pages
- Create another Gantry 5 Menu Particle module by following above steps.
- Menu Assignment: Only on the pages selected; select all your Menu items except Home page.
-
Slideshow & Banners
- Go to Extensions > Modules
- Click on New button and select Gantry 5 Particle
- Click on Pick a Particle and select "Banner OnSale" from popup list. Then follow on-screen instructions and setup.
- Add position name: showcase-b
- Menu Assignment: Only on the pages selected; select your Home page only.
-
How to add image to dropdown menu?
- First, see Gantry Menu documentation with video here http://docs.gantry.org/gantry5/configure/menu-editor
- Go to Gantry Admin
-
Click on Menu from top right corner
- Click on a top level menu item name you want to add dropdown image for
- Click on + sign to create new column if necessary
-
Now drag & drop Particle and select Logo / Image and select follow on-screen instructions. See screenshot-

- Go to Extensions > Modules
- Click on New button and select Gantry 5 Particle
- Click on Pick a Particle and select "Quick Access Links" from popup list. Then follow on-screen instructions and setup.
- Add position name: intro-a
- Menu Assignment: Only on the pages selected; select your Home page only.

- Go to Extensions > Modules
- Click on New button and select HikaShop Content Module
- Module Class Suffix: hikashop-listing-mini
-
Module Position: sidebar
-
HikaShop Options:

- Go to Extensions > Modules
- Click on New button and select VirtueMart Products
- Layout: listingmini
-
Module Position: sidebar

- Go to Extensions > Modules
- Click on New button and select Custom
- Now add your image, add hyperlink to the image if you need.
- Module Position: sidebar
- Module Class Suffix: no-padding img-fullwidth

- Go to Extensions > Modules
- Click on New button and select Gantry 5 Particle
- Click on Pick a Particle and select "Deals of The Day" from popup list. Then follow on-screen instructions and setup.
- Add position name: content-top-a
- Menu Assignment: Only on the pages selected; select your Home page only.

- Go to Extensions > Modules
- Click on New button and select HikaShop Content Module
- Module Class Suffix: title-bordered
-
Module Position: content-top-a
-
HikaShop Options:

- Go to Extensions > Modules
- Click on New button and select VirtueMart Products
- Layout: default
-
Module Position: content-top-a

- Go to Extensions > Modules
- Click on New button and select Gantry 5 Particle
- Click on Pick a Particle and select "Ajax Mailchimp 2" from popup list. Then follow on-screen instructions and setup.
- Add position name: info-2-a

-
Current Offers
- Go to Extensions > Modules
- Click on New button and select Gantry 5
- Click on Pick a Particle and select "Bottom Menu" from popup list. Then follow on-screen instructions and setup.
- Module Position: bottom-a
- Menu Assignment: On all pages
-
Information and My Account
- Follow above steps for Current Offers
- Module Positions: bottom-b and bottom-c
-
Get Support
- Go to Extensions > Modules
- Click on New button and select Gantry 5
- Click on Pick a Particle and select "Get Support" from popup list. Then follow on-screen instructions and setup.
- Module Position: bottom-d
- Menu Assignment: On all pages

-
Copyright Info
- Go to Extensions > Modules
- Click on New button and select Gantry 5
- Click on Pick a Particle and select "Copyright" from popup list. Then follow on-screen instructions and setup.
- Module Position: copyright-a
- Menu Assignment: On all pages
-
Payment Icons
- Go to Extensions > Modules
- Click on New button and select Gantry 5
- Click on Pick a Particle and select "Logo / Image" from popup list. Then select an image with payment icons and follow on-screen instructions for other options.
- Module Position: copyright-b
- Menu Assignment: On all pages





-
Creating HikaShop Filter
- Login to your Joomla! Administrator
- Go to Components > HikaShop > Configuration
-
Click on Display > Filters
- Click on New button to create a filter
-
Follow screenshot below and setup-
-
Creating Filter Module
- Go to Extensions > Modules
- Click on New button and select HikaShop Filter Module
-
Follow screenshot below and setup-
- Module Class Suffix: hikashop-sidebar-filter
- Module Position: sidebar

-
Creating HikaShop Filter
- Login to your Joomla! Administrator
- Go to Components > HikaShop > Configuration
-
Click on Display > Filters
- Click on New button to create a filter
-
Follow screenshot below and setup-
-
Creating Filter Module
- Go to Extensions > Modules
- Click on New button and select HikaShop Filter Module
-
Follow screenshot below and setup-
- Module Class Suffix: hikashop-sidebar-filter
- Module Position: sidebar

Note: If you have created products characteristics then you can create this types of filter.
-
Creating HikaShop Filter
- Login to your Joomla! Administrator
- Go to Components > HikaShop > Configuration
-
Click on Display > Filters
- Click on New button to create a filter
-
Follow screenshot below and setup-
-
Creating Filter Module
- Go to Extensions > Modules
- Click on New button and select HikaShop Filter Module
-
Follow screenshot below and setup-
- Module Class Suffix: hikashop-sidebar-filter
- Module Position: sidebar
- First, Read Setup Blog in Joomla and setup your blog.
-
Search module:
- Go to Extensions -> Modules
- Click on New button to create new module
- Select a Module Type: Search
- Show Title: Show
- Position: aside
- Menu Assignment: [blog menu item]
-
Login form:
- Go to Extensions -> Modules
- Click on New button to create new module
- Select a Module Type: Login
- Show Title: Show
- Position: aside
- Menu Assignment: [blog menu item]
-
Tags:
- Go to Extensions -> Modules
- Click on New button to create new module
- Select a Module Type: Tags - Popular
- Show Title: Show
- Position: aside
- Menu Assignment: [blog menu item]
-
Subscribe:
- Go to Extensions -> Modules
- Click on New button to create new module
- Select a Module Type: Gantry 5 Particle
- Pick a Particle: Ajax MailChimp; then follow on screen instructions in the particle.
- Show Title: Show
- Position: aside
- Menu Assignment: [blog menu item]
-
Creating Contact Form
- Go to Menus -> Main Menu -> Add New Menu Item
-
Select Menu Item Type* -> Contacts -> Single Contact
-
Click on Create button to create new contact form or select your existing form
-
Form Settings
-
Adding Contact Details
- Go to Extensions > Modules
- Click on New button to create new module
- Select a Module Type : Gantry 5 Particle
- Pick a Particle : Contact Details; and then follow on-screen instructions
- Show Title : Show
- Position : aside
- Menu Assignment : Only on the pages selected > Contact page
404 error page will get configurations from Base outline, however you could add more information or customize 404 page by following -
- Go to Gantry Admin
-
Switch to Error
- Click on Layout tab and customize as you need.
- Go to Gantry Admin
-
Switch to Offline
- Click on Layout tab and customize as you need.
All other particles are documented inside. If you need help, please post your questions on Support Forum
After done configuration and customization,
- Read What is responsible for my Joomla! website performance?
- activate Production mode, check above Development and Production Modes
- Recompile CSS from Styles tab
If you have any questions, got a bug or need help configuring the template, please post your questions on our Support Forum. If you need more customization, check out Custom Services and get your job done by professionals who developed this Template and Particles.