# Skin
The MazaEngine works base on skin layout system. The skin contains information related layout and style of the
website like colour, fonts, a structure and position of modules and widget and many more. This theme contains
multiple skins of a unique design.
There are two types of skin
Root skin |
Root skin is a skin which comes with the theme installation and it can not be add or delete |
Child skin |
Child skin is a child of root skin and it can be add or delete. You can inherit styles of root skin by
creating child skin with your own settings and layout structure. For example, you can overwrite color of
root skin in child skin |
The skin is divided into three part of the layout as a header, content and footer. This theme contains multiple
header and footer with a unique style. You can assign any specific header and footer to a skin
Assign skin
You can assign skin per store or page. For example, you have two stores as the name S1 and S2. So you can assign skin
A to S1 and skin B to S2. You can also assign skin per page. For example, skin A for category page and skin B for
product page and skin of other pages will be the skin of the store.
Note: Settings of theme are store per skin, so make sure you have
selected right skin before to change any setting. You can select a skin from a header bar in the admin panel of
MazaEngine
# Style
You can control the style of skin like colour, spacing, typography like that in this page. Most settings
are related to bootstrap 5
theming
Note: If you don’t understand any setting then simply change it and see
the result in a storefront. And don’t forget to export the original setting before to change any settings by click
on the export button at the upper right corner.
Note: Allowed size unit of value is shown as a placeholder of every input
field.
Layout
General
|
Layout style |
Type of page layout. Box or full layout |
Gutter width |
The gap(gutter) between bootstrap column. Default 30px |
Page loader |
Enable or disable page loader. If enabled then the spinner will be showing to users until the website
data not fully loaded |
Back To Top |
Enable or disable back to top button. If enabled then a button will display at bottom corner to allow user to quicky scoll page back to top |
Spinner |
Upload spinner image. GIF image recommended. Spinner is used as a loading icon for page loader, lazy
loading of image, popup loading |
Device breakpoints
The breakpoint is a fallback point for style and content to make a website responsive.
It is basically the general width of the device screen where content should start to fall to
adjust(fit) with the device screen. More info
|
XS |
Extra small screen. For mobile device |
SM |
Small screen. For tablet or landscape mode of the phone |
MD |
Medium screen. For landscape mode of the tablet |
LG |
Large screen. For small resolution laptop screen |
XL |
Extra-large screen. For desktop or laptop screen |
Container width
Maximum width of container per breakpoint. Container width can not be more than a
corresponding breakpoint width. Add 0 for full width. More
info
|
SM |
Container width in SM breakpoint |
MD |
Container width in MD breakpoint |
LG |
Container width in LG breakpoint |
XL |
Container width in XL breakpoint |
Color
Select a theming colour. It is a colour palette of 8 colours as a name of Primary, Secondary, Info, Success, Danger,
Warning, Light and Dark. We have already given some colour palette. You can also create own colour palette using a
custom colour palette. More info
Body
Color
Set background and text colour of body element.
|
Background
Set background image or pattern in the body element. You can set multiple layers of images.
|
Image position |
Specifies the position of the background images |
Image repeat |
Specifies how to repeat the background images |
Image attachment |
Specifies whether the background images are fixed or scrolls with the rest of the page |
Typography
Generally, the size of 1rem is equal to 16px in browsers by default, but in a mazaEngine, 1rem is equal to 10px.
You can select font-family for the website. Only two different font-family allowed, one for general text and second
is for a heading(title) text. You can also add google fonts
Get google font
Visit the google official website(fonts.google.com/), and
select font which you want to use to get more detail about it
Font name |
Name of the font. |
Font family |
Valid font-family of the font. |
Font URL |
Google font URL. |
Parent(generic) font |
Generic font-family for the font. It is fallback font-family. |
There are more settings available in this section to customize bootstrap4. Mostly not require to change it. And only
created for the advanced users who already know CSS and bootstrap. All settings are self-explainer
# Catalog
In this page, you can control the listing structure of catalog data like products, categories and
manufacturers.
General
Image Resize
|
Scale |
- Contain: Resize the image to make sure the image is fully visible
- Cover: Resize the image to cover the entire container, even if it has to stretch the image or cut a little bit off one of the edges
- Fit Width: Resize the image to make sure the image width fully visible, even if it has to cut height of image
- Fit Height: Resize the image to make sure the image height fully visible, even if it has to cut width of image
|
Quality |
Quality of image after resize. add value between 1 to 100 |
Order
|
Sold Order Status |
Select the Which order status should consider as a complete order. |
Deal
The deal is an extended feature of the product special price in opencart. It will allow you to set order limit to sell at a special price, so when product sell reaches their limit then the special price will be disabled.
|
Countdown |
Enable or disable countdown of special price based on expire date. |
Countdown showtime |
Show countdown only when your specified time is left at a special price to get expired. Add 0 to always show countdown. |
Sold |
Enable to show total orders claim by customers in limited special price product. |
Sold showtime |
Show an order claimed when specified quantity left in an order limit of special price. Add 0 to show always when an order limit is set |
Sold unit |
Unit of the deal claimed. in percentage or quantity of order |
Products listing
Grid elements
|
Sale badge status |
Enable or disable "Sale" label on the special price product grid |
Sale badge type |
Type of "Sale" label, Sale text or discount in percentage |
New badge status |
Enable or disable "New" label on latest products grid |
New badge timeout |
How many days "New" label should show on a product? Add value in days. If you add 7 days then "New"
label will not visible on a product which is older than 7days |
Countdown |
Enable or disable countdown of special price based on expire date |
Sold |
Enable to show total deal claim by users on limited order of special price product. |
Image
|
Image size |
Width and height of product image in the list. |
Responsive width |
Add image width per breakpoint. Height of image will auto calculated by width based on the original
ratio of an image. This setting allows you to show a small image for mobile and large image for desktop.
|
Lazy loading |
Load images only when it is visible in the device screen. More images will load when users scroll down
the page. |
Additional images |
Enable or disable additional images of the product. |
Additional image limit |
Limit of additional images if it is enabled |
Product page
Image
|
Image size |
Width and height of product image in px unit. |
Responsive width |
Add image width per breakpoint. This setting allows you to set a small size for mobile and large size for desktop |
Additional Image Slides |
Additional image slides per view in slider. default is 4. |
Brand image size |
Width and height of manufacture image |
Options
|
Image size |
Width and height of option image in px unit. |
Update price |
Update product price when a user selects or change options. For example, if the user selects product colour or size then product price update based on a selected option. |
Related products
|
Image size |
Width and height of related products image. |
Responsive with |
Image width per breakpoint. Height will auto-calculated based on image ratio. |
Category
Subcategory products |
Show or hide products of subcategories in the parent category. If it is enabled to show then products of subcategories will available in ancestors category. If disable then users have to visit subcategory to see products of it. |
Image
|
Category image |
Width and height of category image. |
Refine search |
Width and height of subcategories images. |
Compare
Enable or disable the product fields in comparison of products in compare page
Account
Enable or disable the account related links in account page or menu
Checkout
Enable or disable one page checkout of theme.
# Layout builder
Layout builder is an integration of opencart default layout and drag & drop builder. You can create a layout of
existing opencart page using drag & drop builder.
There is following types of layout, every type used for a specific page and contains different types of contents for drag & drop builder.
- Default
- Home
- Category
- Product
- Search
- Special
- Product quick view
- Manufacturer products
- Blog article
- Blog author
- Blog category
- Blog search
# Content builder
Create a small layout of any content using drag & drop builder. It will be used in modules, widgets or designs.
Use content builder as the following way
- To create a mega menu in the menu
- To create a slide in the slider module
- To create an accordion panel
- To create tab content in tabs
# Page builder
Create a new page in the website using drag & drop builder.
Note: URL route of the page is: index.php?route=extension/maza/page&page_id=[page id]
General
|
Page name |
Name of a page in admin |
Meta tag title |
HTML meta title of a page |
Meta Tag Description |
HTML meta description of a page |
Meta Tag Keywords |
HTML meta keywords of a page |
Data
|
Stores |
Select stores for page |
Status |
Enable or disable page |
SEO
Add keyword URL of the page
|
# Code
You can add custom code of HTML, CSS or javascript per skin, theme or global. This section is mostly
used to integrate external services
Add any valid code between <head></head>
tag of HTML. You can use this to integrate any external service like Google AdSense, analytics or social media service. More info
Add any valid HTML, CSS or javascript before closing </body> element of HTML. it is also used to add the javascript code of external service.
CSS
Add any valid CSS or SCSS in this section. You can customise the style of a website using own CSS. Bootstrap theming variables, mixin and function of SCSS is also valid to use. Mostly used to style and position text on banner or image.
JavaScript
Add valid Javascript or jQuery code.
Asset
Here you can add external CSS and javascript files to load it in the storefront.
# Filter
The filter is one of the most important things for a big inventory website, which helps customers to find desired
products from many numbers of products. We have a filter in an opencart but it is hard to manage as It works like
first create each filter and value after that assign it to category and products, it becomes a nightmare for large
numbers of a product. So we have developed custom filter in a mazaEngine which works automatically without any
manual assignment to products.
A custom filter works base on key and value pair, where you need to select keys, but values generated automatically
from selected key and get assigned to products
There are following types of a key in a custom filter
- Attributes
- Options
- Filter group (default opencart filter)
- Product name
- Product description
- Product tags
Suppose you want to create a colour filter then just select a colour attribute or product option as a key of the
filter. The filter will automatically generate all values of colours from attribute or options and assign them to
products. Use of Multiple key types together is very important in the case when some products contain colour as an
attribute and some not, some contain colour as an option and some has a colour name only in a product name or
description.
Note: Required to use a
Maza filter
module to show custom filter in the storefront
Add filter
Add filter group like colour, size, memory, etc
General
|
Name |
Name of the filter group |
Status |
Enable or disable to hide or show filter |
Sort order |
Order of the filter across filters |
Filter language |
Select a language which should be used to compare filter values to products data |
Show in category |
The filter will show in the selected category. If “Require category” option is disabled from a maza
filter module then a filter will show even category is not selected |
Sync value |
Disable to stop automatic generate values of the filter. If disabled then require to add filter value
manually |
Layout
|
Collapse by Default |
Enable to collapse filter group by default |
Input Type |
Select the input type of filter values |
Input Shape |
Select button to display checkbox or radio input as a button shape |
List Type |
Type of filter value list. Show filter values as a list of value image or text or both |
Image width |
Width of the filter value image |
Image height |
Height of the filter value image |
Key
Select filter keys to generate filter values and map with products. Values of filter
will map with products data of selected keys.
|
Attributes |
Select attributes as a key to a filter. If a filter is a "RAM" then select all attributes likes "RAM",
"system memory", "RAM capacity", "Memory" |
Options |
Select product options as a key to a filter |
Filter groups |
Select the filter group as a key to a filter. It is opencart default filter |
Product name |
If enabled then values of filter will search in product name. If a filter is "colour" with value "red"
then products will get assigned to it which name contains "red" keyword. For example, the product "women
red t-shirt" |
Product description |
If enabled then values of filter will search in the product description. |
Product tags |
If enabled then values of filter will search in product tags |
Add value
Values of filter will automatically be generated by click on the synchronise button from the upper-right corner. But
sometimes if you don't want to generate values then disable "sync value" option from filter setting and add value
manually as following
Name |
Name of a value |
Status |
Enable or disable value |
Sort order |
Order of value across other values |
Image |
Image of value. If "list type" is selected "text" in filter setting then an image will not show |
Value type |
Type of a value. Select how value should be compared with products |
Value |
A value which will compare with products data of selected keys like attributes values, options value,
product name, description and tags. Type of Comparison will be based on a value type |
# Catalog Data
In this page, you can add catalog data and display it to selected products, categories or manufactuers page in form of tabs, accordion, FAQ or PopUp.
General
Name |
Add name for admin panel |
Status |
Enable or disable data |
Sort order |
Sorting data to each others |
Title
Title |
Add title to the data which displays to the customer. For example tab name |
Icon |
Select icon for title. Supported image, SVG or font icon |
Width |
add width of image if image or SVG format selected |
Height |
add height of image if image or SVG format selected |
Font size |
Add font size if font icon selected |
Data
Add data which can be displayed in tabs, accordion, popup or FAQ. Select type of data like HTML, module, content builder, widget and add data into it
Link
Customer |
Display data to Guest, register or all customers |
Customer Group |
Display to all customer group or selected |
Timespan |
Display data between time or start from or end to selected time |
Store |
Select opencart store |
Page
Product
Assign data to product page
|
Type |
Select how to filter products |
Product |
Display data to selected products |
Category |
Display data to products from selected category |
Sub Category |
Enable to display data to products from sub category of selected category |
Manufacturer |
Display data to products from selected manufacturer |
Filter |
Display data to products from selected product filter |
Special Only |
Display data to special price products |
Price |
Display data to products between price range. Add 0 price to display data only to 0 price products |
Quantity |
Display data to products between quantity range. Add 0 quantity to display data only to out of stock products |
Category
Display data on category page
|
Category |
Display data to selected category |
Sub Category |
Enable to display data to all sub categories of selected category |
Manufacturer
Display data on manufacturer page
|
Manufacturer |
Select manufacturer to display data on it |
Design
# Add Metadata
Add HTML meta information to any page.
General
Status |
Enable or Disable current meta data of page |
Route |
Enter the route of the page where you want to add this metadata. For example if you want to display metadata in a special product page then add the route “product/special”. And you can find route of any page from their URL when SEO url disabled. |
Store |
Select opencart store |
Data
HTML Meta title, description and keyword for SEO.
OGP
The Open Graph protocol enables any web page to become a rich object in a social graph. For instance, this is used on Facebook to allow any web page to have the same functionality as any other object on Facebook.
# Newsletter
Newsletter marketing is the practice by which companies send informational and product-focused content via an emailed
letter to a subscriber list that comprises potential and existing customers. Online businesses utilize newsletters
to keep their brand top-of-mind for consumers, establishing authority in the space and notifying readers of products
that may interest them.
In this theme, Newsletter is divided by mail, subscriber and
setting section
Mail
Send mail to newsletter subscriber
From |
Select a store as a sender of the mail. |
To |
Select subscribers. |
Subject |
Subject of mail |
Message |
Message to send in the mail |
Subscriber
List of subscriber mail. It can be approved or not and confirmed or not.
Setting
General
|
Subscribe Confirmation |
Enable to send confirmation mail before to subscribe |
Unsubscribe Confirmation |
Enable to send confirmation mail before to unsubscribe |
Send Welcome Mail |
Enable to send welcome mail when a subscriber subscribes the newsletter |
Required Approval |
Require approval or not after subscribe |
Translate
Translate or overwrite the default message of newsletter actions. All following messages have a
default message and optional to overwrite
|
Subscribe Success |
The message of success when subscriber successfully subscribe to the newsletter |
Unsubscribe Success |
The message of unsubscribing when subscriber successfully unsubscribe to the newsletter |
Subscribe Confirmation Mail Success |
The message of success when confirmation mail to subscribe sent successfully |
Unsubscribe Confirmation Mail Success |
The message of success when confirmation mail to unsubscribe sent successfully |
Invalid Email Id |
Error Message of invalid mail id |
Email Id Not Found |
Error Message when given email id to unsubscribe not found |
Email Id Already Exist |
Error Message, when given email id to subscribe is already available |
Template
|
SUBSCRIBE CONFIRM MAIL |
The mail to send for confirmation of subscribe |
UNSUBSCRIBE CONFIRM MAIL |
The mail to send for confirmation of unsubscribe |
WELCOME MAIL |
The mail to send after successfully subscribe |
# Testimonial
Customer testimonials can be a powerful, conversion-boosting, profit-driving tool for eCommerce companies. Happy
customers can tell a story about your business and the products your business sells. That story impacts how
potential customers think about your company, and may lead to additional sales
We have developed testimonial in mazaEngine as the following
Add Testimonial
Testimonial can be added by customer themself on the storefront, but sometimes if you need to add or edit testimonial
then you can do it as a following
Author Name |
Author of testimonial |
Extra |
Extra detail about the author like occupation, company or profession |
Image |
Image of author |
Email |
Email id of the author |
Rating |
Rating by the author about your company |
Description |
Testimonial message |
Store |
Show testimonial on selected stores |
Date Added |
Date of testimonial created |
Sort Order |
Order of testimonial across others |
Status |
Enable or disable testimonial |
Setting
Submit testimonial
|
Status |
Enable to allow customers to submit testimonial by themselves on the storefront |
Required approval |
Enable to require the approval of testimonial to show on the storefront |
Thank you mail |
Enable to send thank you email after the customer submit a testimonial |
Mail template
Thank you mail after successful testimonial submit
|
Form
Control the form of a testimonial submit
Rating |
Enable or disable the rating field in the form |
Email |
Enable or disable email field in the form |
Image |
Enable or disable the image field in the form |
Extra |
Enable or disable extra field in the form |
Captcha |
Enable or disable captcha. Enable to prevent spam submissions |
Page
Testimonial page
Testimonial listing page of the storefront
|
Meta Title |
HTML meta title of a testimonial page |
Meta Description |
HTML meta description of a testimonial page |
Meta Keyword |
HTML meta keyword of a testimonial page |
Listing
|
Limit |
Limit of testimonials per page |
Thumb Size |
Image size of the testimonial author |
Listing
Change settings to control how testimonials should list on the storefront
General
|
Rating |
Enable to show given rating on a testimonial |
Timestamp |
Enable to show submitted time of a testimonial |
Image |
Enable to show author image on a testimonial |
Extra |
Enable to show an extra field's detail on a testimonial |
Quote icon
Add quote icon to highlight a testimonial
|
Layout
Testimonial per row
How many testimonials should show per row by breakpoints
|
# Form
Create a form for contact us, ask for price, product Inquiry or any other type to get customers input. Create unlimited form input field with any html input type.
Note: Create a form here with input fields and display it in any page using a form widget in layout builder
Add Form
General
Name |
Title of form. Which can be disable in the form widget. |
Submit Text |
Submit button text |
Success |
Add success message which will show to customer when they successfully submit form |
Data
General
|
Captcha |
Select captcha which will display in a form. |
Policy |
Select information page which will used as a policy information for this form, which is required for customer to accept before to submit form |
Record |
When customers submit a form, you get mail of submitted data. But you can also save submitted form data in the database for record. |
Field
Note: Fields will not available at the time of new form creation. So after creating fields, edit form again to select fields.
|
Email |
If email input field is available in form then select it here so it will used as a customer email to send mail |
Subject |
If subject input field available in form then select it here so it will used for mail subject |
Mail
Admin |
Enable to get email when customer submit form data. |
Customers |
Enable to send email to customer when they successfully submitted form |
Admin
|
Email |
Enter email id, when customer submit form, you will get email on this id. or Stay empty to use store email |
Customer
|
Subject |
Enter subject of mail which they receive after form submit |
Message |
Enter message body of mail which they receive after form submit |
Add Field
General
Label |
Add label text for input field |
Placeholder |
Add input placeholder text which will display into input area |
Help Note |
Add Help note about input for customer. So they can understand what valid data they should enter in. |
Error Message |
Enter an error message which will display to customers if they submit invalid data which does not pass in criteria which you added for this field.
For example: Minimum or maximum number or regex pattern does not match with input data or when customer skip required field
|
Data
Required |
Enable to required this field to fill by customer for successful form submit |
Sort Order |
Sort order of this field compare to others fields of this form |
Status |
Enable or disable input field. |
Link
Form |
Select form where this field belong to |
Customer |
Select when should field display in form
- All: Always display
- Guest: When a customer is not logged in
- Logged: When a customer logged into their account
|
Customer Group |
Select which customer group belong to this field. |
Input
Type |
Select html input type |
Name |
Select name of input. Which should be unique in this form and without any space. Name will be used for the internal process of form to refer to field value. You can add name same as a label but replace space with _(underscore). |
Format
|
Value |
Default value for this field |
Validation |
Add a regex pattern which will be used for data validation. Stay empty to accept all type of data |
Minimum |
Only used for number input. Add minimum number allow to add for this input. |
Maximum |
Only used for number input. Add maximum number allow to add for this input. |
Decimal |
Only used for number input. Number of decimal point for float number. |
Options
Add multiple options for input type like select, radio and checkbox
|
# System
Setting
Developer mode |
Enable while modifying the website, it will disable all internal caches |
Cache
|
Status |
Enable or Disable all caches |
Partial |
Enable or disable partial caches. Partial caches are enabled by admin on modules or widgets into layout
builder |
Page |
Enable or disable Full page cache. Full Page cache does not work when customer logged into the website
|
API
|
Google map key |
Google map API key. Get it now |
Asset
Combine CSS files |
Combine multiple CSS files into one to reduce server requests |
Combine JS files |
Combine multiple JavaScript files into one to reduce server requests |
JS load Position |
Position of javascript files into a webpage. "Footer" position recommended to eliminate
render-blocking.
- Header: Add all javascript files between
<head></head>
tag
- Footer: Add all javascript files just before closing
</body>
tag
- Default: Remain default javascript files position given by extension developers
|
CSS Autoprefix |
Enable to automatically prefix CSS rules to make compatible with all browsers. For example
-webkit-flex , -moz-flex |
CDN |
Enable CDN to load CSS and JavaScript library like jQuery and Bootstrap from Content Delivery Network!
|
Minify
|
HTML |
Enable to remove all whitespace from HTML to reduce the size |
CSS |
Enable to remove all whitespace and comments from CSS files and create minify version |
JavaScript |
Enable to remove all whitespace and comments from JavaScript files and create minify version |
Cron
Cron is a very essential task to schedule jobs and runs periodically to maintain website. It includes jobs like purge
caches, synchronises filters values, generates products and articles tags, and some internal task
Use cron command tool to generate UNIX command base on your website(opencart) admin username and password. And
schedule(once per day) that command into a server cron job. Setup cronjob into Cpanel, plesk.
Backup
Import/export settings of mazaEngine. Use it to backup settings or import demo layout of the theme from our demo
website