Start chat

Zemez © Privacy Policy

Carlis

Wheels and tires shop

Custom modules and extensions

Attention Some modules may not be included into your template package. This section describes configuration of all modules that are used in our templates. Each template pack is provided with a set of modules which is included into the design of this specific template.

JX Advanced Filter

Introduction

JX Advanced Filter module gives an opportunity to implement a quick search of the needed product based on key features. It allows creating filters with the unlimited number of search criteria, which are available in the store by default or are created when adding the products.

Filter criteria can be the following: levels of categories (by nesting), manufacturers, suppliers, attributes, features, and more. Also, the module has the following features: creating connected filters, in which needed criteria become available only after selecting the parent parameter (nesting level is unlimited); selecting the filter criteria grid for the top page filter. You can select the filter field type from the available, specify the parent filter, add its name, label, and description. All is easily set up and edited in the user-friendly admin panel. For the better speed, the module uses the products indexation algorithm by the set criteria. It can be easily and quickly inserted into a PrestaShop store of any kind.

Installing and deleting the module

The module is installed and deleted like any other PrestaShop module.

After deleting or reinstalling the module, all the module settings and filters will be discarded.

Filter setup/editing

After installing the module, you can set it up on the module configuration page. By default, you'll see the tabs with available filter types. To start creating a filter, select a tab (1) and press the 'Create filter' button (2).

In the appeared filter window, fill in all the needed fields.

  • Name - the name of the filter. It'll be displayed on the frontend as the filter block title;
  • Description - the filter description. It'll be displayed on the frontend next to the filter block title;
  • Show counter - allows displaying the number of products that will be available after selecting the current parameter. The number will be displayed next to the search criterion (in brackets);
  • Show selected filters - allows displaying the list of the selected search criteria with the ability to unselect any of them;
  • Show filter layout type - selecting filter grid (available only for the Top Filter);

Please note that there are no required fields. If you leave all the fields empty, then a one-column filter with no description and title will be created.

Editing the filter

To change the description and filter settings, press the 'Cogwheel' button in the filter menu.

In the editing mode, the form looks and works as in the setup mode.

The filter grid selection is available only for 'Top filter'.

When changing the filter grid, all the elements will be automatically transferred to the first column, keeping the nesting and display order (based on the principle: all elements of the previous column with the display order kept inside).

Deleting the filter

To change the filter description or filter settings, press the 'Cross' in the filter menu

and confirm filter deletion.

After deleting a filter, all the data will be permanently lost.
Filter indexation

Indexation - the process of creating unique tables with the data necessary for the filter, which is created for the filter-specific criteria. They allow to drastically speed up the filter work on the frontend.

The corresponding button in the filter menu is highlighted in red. If the button is not highlighted, the filter doesn't need indexation.

The re-indexation process can take some time, depending on the number of products in the store and selected filter criteria.

If the filter requires re-indexation, it won't be displayed on the frontend.

Creating/editing filter elements (criteria)

To add an element to the filter, select it in the panel of available elements (on the left) and drag it to the available area of the filter grid (it will light up after being selected. In the example, the grid has 2 columns).

In the highlighted area select the column and position of the new element and drop the element.

In the appeared element creation window, supply all the necessary data:

  • Name - the name of the filter element on the frontend. It won't be displayed, if you leave the field empty.
  • Label - the label of the filter element on the frontend. It won't be displayed, if you leave the field empty.
  • Description - the filter element description on the frontend. It won't be displayed, if you leave the field empty.
  • Parent filter - the filter parent element, after selecting which this element will be available. The element will be always available if the field is left empty.
  • Filter field type - the way the element will be displayed on the frontend. The following types are available:
    • radio
    • select
    • checkbox
    • range-select (only for the 'price' field type)
    • range-input (only for the 'price' field type)

You can change all the data and the parent element in the filter editing mode.

After editing the element, the filter should be re-indexed, which is shown by the button in the filter menu. Do not go for reindexing the filter after editing every element, you can do this after applying changes to all the needed elements - by doing so you'll save your time.

If there is a tree of connected filters, you can add the new element as a related to this tree.

Editing the filter element

To edit a filter element, press the 'Cogwheel' button (1) in the filter upper right corner.

Sorting (display order of the filter elements)

By default, the new elements are displayed after the element in the order you've added them. If the filter is added to the tree, it'll be displayed after the existing elements in the tree.

To move the elements inside the filter, select the needed element and drag it to the needed position. You can drag elements in one column, as well as to another grid columns. You can also change the sorting inside the tree, or move the whole tree at once.

After moving the element from one column to another, the display order will change automatically in all columns.

Deleting the filter element

You can delete a filter element in two ways:

  • drag the element back to the column of available elements;

  • or press the 'Cross' in the upper right corner of the needed element.

Regardless of the chosen method, you'll see a window of deleting confirmation.

After deleting a filter with nested elements, all the nested elements will be deleted.

After deleting an element, the filter needs to be re-indexed, what is indicated by the button in the filter menu. Do not go for reindexing the filter after editing every element, you can do this after applying changes to all the needed elements - by doing so you'll save your time.

"Smart" reindexation

The module provides the automatic (smart) reindexation after making changes to the products or after some other crucial changes (manufacturer, attribute, etc.). The table fields will be reindexed if these changes affected the filter functioning.

If, after making changes, the filter did not take them automatically, enter the filter settings page and reindex it manually.

The filter won't be reindexed automatically after adding currency, that's why it should be reindexed manually.

FAQ

  • I've created a filter, but I don't see it on the frontend.
  • I've added the filter name and description, but they are not displayed on the frontend.
  • I've added elements to the filter, but it stopped displaying on the frontend.
  • I want the element to be available only after another element is selected.
  • I want to swap elements.
  • I want to delete a parent element, but want to keep all the nested elements. How to achieve this?
  • I want to change the filter grid, but I don't want to create the filter again. What can I do?
  • How to create a completely new filter, if there is already a filter for this position?
  • The filter stopped displaying on the frontend.
  • Why not all the elements are active on the frontend?
The filter won't be displayed, if there are no elements in it, or if it wasn't reindexed.
Make sure that there are elements in the filter and that it has been reindexed.
Perhaps, you've added data not for all languages. Don't forget that the module is multilingual and fill in the data for each language separately.
Make sure that you reindexed the filter after making changes.
Select the element, after selecting which the desired element should become available, and set it as the parent element.
Just drag the element to the place, where you want to locate it, it'll automatically take the new position and this won't affect the filter functionality.
In the menu for editing the first nested element, discard the connection with the parent element that you want to delete, and then delete the parent element. In this case, all the nested elements won't be deleted.
Enter the editing menu and select a new grid for the filter, then, save changes. All the filter elements will display in the first column of the new grid, then, you can move them to the needed positions.
To create a new filter, delete the exiting one.
Make sure that the filter doesn't need indexation.
Check, whether the element is not a child to the element that is currently not active. Make sure there are products that meet the criteria specified.

JX Category Products 2.0.0

This module displays category products in displayHome and displayHomeTabContent hooks. The module allows displaying single products, products from a category or all products. Moreover, the module comes with a carousel that works, when the module occupies the displayHome position.

JX Category Products Main Panel

The main panel. Here you can set up the module.

Adding a block

This block allows selecting products in displayHome position.

  • Access the module main panel and press the 'plus' (1) button in the blocks list.

  • In the appeared form, you'll find the following options:

    • Status - this option allows enabling/disabling the block.

    • Select category - the category, products of which will be displayed.

    • Use name in font - this option allows changing the displayed category name. If enabled, displays the following form:

      • Name - the custom tab name, displayed on the website.

    • Select products to display - if disabled, displays the 'Number of products to display' field, which sets the number of products to display. If disabled, displays the 'Add products' button that allows selecting products to display in the tab.

    • Use carousel - this option allows enabling/disabling the carousel for block products. After enabling the option, you'll see the following settings:

      • Visible items - the number of visible items.

      • Items scroll - the number of items changed with one carousel scroll.

      • Slide Width - the carousel list item width.

      • Slide Margin - the carousel list item margin.

      • Auto scroll - auto scroll of carousel items.

      • Carousel speed - speed of changing items.

      • Pause - pause between scrolls (if "Auto scroll" is enabled).

      • Random - the carousel starts with a random item.

      • Carousel loop - the loop: when all the carousel items have been displayed, carousel starts from the beginning.

      • Hide control on end - hide control buttons (Next/Prev).

      • Pager - display pagination.

      • Control - display controls (Next/Prev).

      • Auto control - display controls (Play/Pause).

      • Auto hover - carousel pauses, if the user hovers a list item.

  • After configuring all the needed options, press the 'Save' (2) button.

Blocks Sorting

You can sort the blocks of the module with the help of drag'n'drop. This allows to change blocks positions quickly.

Selecting Products

If you create an item and enable 'Select products to display' option, you can choose the products that you want to display. To do this:

  • Press the 'Add products' (1) button:

  • In the appeared pop-up, select the needed products (2) and press the 'Add' (3) button:

  • Now, you can place the added products wherever you want with the help of drag'n'drop (4):

  • When all the needed products are added and arranged in the desired order, press the 'Save' button.

Deleting Blocks

To delete items, press the drop-down menu next to the needed block (1) and press delete (2). The item will be deleted.

JX Compare Product

This module allows you to compare products.

Product comparison as a feature allows comparing two, three or more products at a time.

Installation and Deleting

The module can be installed and deleted like any other PrestaShop module.

Module Settings

The main panel. Here you can set up the following options of the module:

  • Count product - the amount of products to be compared.

  • Display in footer - the ability to display the feature in footer area.

  • Display in header info - the ability to display the feature in header area of the page.

JX Deal of the Day

This module allows you to display the list of products with the discount countdown timer. You can also add a timer to products in the home page tabs, on the category pages and single product pages.

Installation and Deleting

The module is installed and removed the same way as any other PrestaShop module.

Module Settings

After module installation you can add a product discount with the display period and a discount countdown timer.

Adding/removing/editing blocks

  • In order to add a new product, press 'Add new' button

    • Select a product - select a product to apply the discount and display a timer.
    • Status - item status.
    • Start Date - start date of the product discount period.
    • End Date - end date of the product discount period.
    • Label - product label.
    • Discount price - discount price (absolute or percentage value).

  • After saving the item it appears in the list of items of this type.

  • In order to edit this item, press 'Edit' button.

  • In order to remove this item, press 'Delete' button.

  • If a special price valid for a certain period was set to the product previously, this product can be added to the module items list.

Product display configuration

  • In order to change product display mode, press 'Configuration' button.

  • Then a form with product display configuration will appear.

    • Products to display - number of products to display in the home page block.
    • Random products - random products display.

JX Google Map

This module allows adding Google Map with store locations and store short descriptions to the Homepage. The map will display the addresses of all the stores connected with your online store.

Installation and removal

The module is installed and removed as any other PrestaShop module.

Module settings

After installing the module, you can add stores to the map. After pressing the 'Add new store' button (1), you'll be redirected to the 'Store contacts' tab, where you can edit your stores.

To add a new store, press the 'Add new' button.

  • Select a store - select the store that you want to add to the map.
  • Status - the element status.
  • Marker - adding a custom marker.
  • Custom text - adding custom text.
Google Map display settings

  • Google Api Key - enter your Google Map API Key.
  • Map Style - select the map display style.
  • Map Type - select the map display type.
  • Zoom Level - specify the initial level of the map zoom (from 1 to 17).
  • Zoom on scroll - enable/disable map zoom on scroll.
  • Map controls - enable/disable map controls.
  • Street view - enable/disable street view.
  • Animation marker - enable/disable animation marker.
  • Popup - enable/disable popup windows with store information.

JX Header Account 2.0.0

This module displays login and registration forms on the website. It can take the following positions: website header, left and right column. The module allows to log in and register using such social networks as Facebook, Google+ and VK, which is convenient for website users. Registration or logging in proceeds without reloading the page.

JX Header Account Main Panel

The main panel. Here you can set up the module.

Settings

There are the following settings in the module:

  • Display type - this setting allows to select the way to display the registration form. It can take the following values:

    • Drop down - the form will display as a drop-down below the button opening it.
    • Popup - the form will appear in a pop-up.
    • Left side - the form will appear from the left as a sidebar.
    • Right side - the form will appear from the right as a sidebar.

  • Display style after login - this setting allows to change the form view after login/registration. You can use the following values:

    • Two columns - the list is divided into two columns.
    • One Column - the list of links is displayed as one column.
  • Default avatar - this field appears only if the 'Display avatar' option is enabled. Here you can select the default user avatar.
  • Display avatar - this setting allows enabling or disable user avatar. If the user logs in to the account on the website with the help of one of the social networks, the avatar will be taken from the account in this social network, otherwise, the avatar, loaded by the website admin, will be displayed.
  • Use redirect - if this setting is enabled, user registration and password recovery will take place on the default PrestaShop registration/password recovery page.

  • Use Facebook Login - this setting allows enabling user registration and login with the help of the Facebook social network. When you enable this option, you will see the following settings:

    • App ID - your account App ID from the Facebook developer account.
    • App Secret - your app secret from the Facebook developer account.

  • Use Google Login - this setting allows enabling user login and registration with the help of the Google+ social network. If you enable this option, you will see the following settings:

    • App ID - your App id from the Google developer account.
    • App Secret - your App secret from the Google developer account.
    • Redirect URLs - your online-store url + index.php?fc=module&module=jxheaderaccount&controller=googlelogin

  • Use VK Login - this setting allows enabling user registration and login with the help of VK social network. If you enable this option, you will see the following settings:

    • App ID - your App id from your VK developer account.
    • App Secret - App secret from your VK developer account.
    • Redirect URLs - your online-store url + index.php?fc=module&module=jxheaderaccount&controller=vk
Registering apps in social networks:

JX Homepage Category Gallery

The module displays a category gallery on your store Homepage.

It should look something like this:

Here are the main parts of the Category Gallery item, which are marked on the screenshot:

  • 1 - HTML content
  • 2 - category name
  • 3 - category description
  • 4 - button

Customization details you can find below in 'Module configuration' section.

Module Installation

The module can be installed and deleted like any other PrestaShop module.

Module configuration

  • After you have installed JX Homepage Category Gallery module, you can configure it clicking the corresponding button (1).

  • On the Configuration page you'll see the list of items in this module. You can edit the existing ones (1) or add new item (2).

Adding/Editing item options
Please note: category name, description and image are loaded from the category properties and there's no need to add them manually. To edit these options, go to Admin panel -> Catalog -> Categories -> choose category -> Edit.

When you add a new item to the module (or edit the one from the list of items), you have some options to choose from. The detailed description of options you can see below the screenshot. After all options are set, click the 'Save' button (1).

  • Select category - here you choose from the drop-down list the category which should be displayed on your page.
  • Specific class - the specific class can be added to the module item.
  • Display name - option to show or hide the category name.
  • Category name length - maximum number of symbols to be displayed in the category name. If the name is longer - the '..' symbol will be added after the number of symbols that has been set.
  • Display description - option to show or hide the category description.
  • Description length - maximum number of symbols to be displayed in the description. If the description is longer - the '..' symbol will be added after the number of symbols that has been set.
  • Sort order - the order of item in the category gallery.
  • Display button - the option to show or hide the button 'Shop now' (button text can be different depending on the template).
  • Status - the option to show or hide the category
  • HTML content - the field where some HTML content can be added.

JX HTML Content

This module allows displaying any content (image, HTML, links, etc.) in the following positions: displayNav, home, top, topColumn, left and right (displayLeftColumn/displayRightColumn), footer. It is used to expand design opportunities and add advertisement/information blocks to your store. It is a multilanguage module and can also work on the multi-store website.

Installation and Deleting

The module can be installed and deleted like any other PrestaShop module.

Module configuration

After the module has been successfully installed, open the configuration page.

To add the content, you should follow the steps below:
  • Click 'Add new' button.
  • The list of available languages. You can view the available elements for all languages by switching the language tabs.
  • The list of elements added for specific position and language.
Adding the element. Click Add item button and fill in the required settings (none of the fields are mandatory).

All elements of one language added to the same position will be displayed as a list at the backend and frontend.

  • Language
    select the required language from the drop-down list.
  • Title
    title of the element.
  • Use title in front
    display the title of the element at the frontend (the title will show up in front of the element).
  • Hook
    position where the element is added.
  • Specific class
    custom class defines item styling (CSS class).
  • Image
    upload the image from your computer.
  • Image width
    image width shown at the frontend.
  • Image height
    image height shown at the frontend.
  • URL
    add the link (the whole block will be wrapped in the link).
  • Target blank
    open link in new tab.
  • HTML
    HTML code (except the link if you have added it in the URL field) or text.
  • Save
    click to save the element.
Editing and removing the element

When you add the element, it shows up in the corresponding list.

  • The language where the elements were added.
  • Position where the elements were added.
  • Edit button with the drop-down list.
  • Delete button.
Editing
Click Edit button to modify the element.

In the appeared screen change all the required fields.

  • Enable
    display the element at the frontend.
  • Image title
    title of the element.
  • Use title in front
    show up title at the frontend.
  • Hook to which the image should be attached
    position of the element.
  • Specific class
    custom CSS class.
  • Load your image
    image of the element.
  • Image width
    image width at the frontend.
  • Image height
    image height at the frontend.
  • Target link
    assign link to the element.
  • Open link in a new tab/page
    Open link in new tab.
  • Optional HTML code
    edit HTML code.
  • Save
    save changes.
Changing order of elements in the list
To change the order of elements, you should just drag the element to the position you need.

JX Manufacturers Block

This module shows up manufacturers available in your store. The list of manufacturers may consist of image and title. The list can also show up as a carousel.

Installing and Deleting

The module is installed and deleted like any other PrestaShop module.

Module configuration

After installation you can change its settings on the module configuration page.

  • Order by
    type of sorting items of the block.
  • Display name
    show the manufacturer's name.
  • Display image
    show the image of the manufacturer.
  • Number of elements to display
    type the number of elements displayed in the module.
  • Image Type
    select the image type (you can select the image from the images related to the manufacturer).
  • Use carousel
    show up the list as a carousel.
  • * Visible items
    number of visible manufacturers.
  • * Items scroll
    number of manufacturers shown in one carousel scroll.
  • * Slide Width
    the width of the element in the carousel.
  • * Slide Margin
    the margin of the element in the carousel.
  • * Auto scroll
    automatic scrolling.
  • * Carousel speed
    speed of the carousel.
  • * Pause
    pause between scrolls (if "Auto scroll" is enabled).
  • * Carousel loop
    carousel returns to the beginning when all elements have been scrolled.
  • * Hide control on end
    hide next/previous buttons.
  • * Pager
    show pagination.
  • * Control
    show next/previous buttons.

* - settings are available only if carousel is enabled.

After all options have been set, press 'Save' button (1).

The module supports multi-stores.

JX Media Parallax 2.0.0

This module is designed to let you add a parallax effect to the DOM items of the page. It allows you to create multi-layered parallax. It also provides a possibility to add a custom background video (you can upload it from your computer to server) or add a YouTube video.

JX Media Parallax Main Panel

Main module panel that allows you to add, edit or remove parallax items.

Creating a new parallax item

In order to create a new parallax item, press 'plus' (1) icon, in the top right corner of the main panel.

Then you will see the following form.

Form options for adding parallax items

  • Selector - CSS selector of the item with parallax effect applied. For example, '#header .nav'
  • Item status - item status (parallax will not be displayed if it's disabled)
  • Speed - digit value from 0 to 2, which defines main parallax block speed
  • Offset - main layer indent on the Y axis
  • Inverse - parallax direction
  • Fade - this option allows to configure main block fade-out on page scroll
  • Forced full width - forced full width of the parallax block

Press 'Save' after filling in all the required fields.

Parallax layers list

In order to see the list of parallax layers, you should press 'View' (1) near the main parallax item.

Then you'll see a table, in which the layers are displayed after they are added.

Adding new layer

In order to create a new parallax layer, press 'plus' (1) icon in the top right corner of the layers panel.

Then you will see the following form.

Press 'Save' after filling in all the required fields.

Parallax layers types and their fields

  • Image-background - image used as a parallax background

    • Item status - item status (parallax will not be displayed if it's disabled)
    • Layout speed - digit value from 0 to 2, which defines main parallax block speed
    • Offset - main layer indent on the Y axis
    • Inverse - parallax direction
    • Fade - this option allows configuring main block fade-out on page scroll
    • Image - link to an image, to which parallax effect will be applied
    • Sort order - layout position, relative to the rest of items

  • Video-background - video used as a parallax background

    • Item status - item status (parallax will not be displayed if it's disabled)
    • Layout speed - digit value from 0 to 2, which defines main parallax block speed
    • Offset - main layer indent on the Y axis
    • Inverse - parallax direction
    • Fade - this option allows configuring main block fade-out on page scroll
    • Image - link to an additional image
    • Video parallax mp4 - video in mp4 format
    • Video parallax webm - video in webm format
    • Sort order - layout position, relative to the rest of items

  • Text - text layer which position can be defined with CSS

    • Item status - item status (parallax will not be displayed if it's disabled)
    • Layout speed - digit value from 0 to 2, which defines main parallax block speed
    • Offset - main layer indent on the Y axis
    • Inverse - parallax direction
    • Fade - this option allows configuring main block fade-out on page scroll
    • Content - layer content
    • Specific class - custom CSS class for this layer
    • Sort order - layout position, relative to the rest of items

  • Youtube-background - YouTube video used as a parallax background

    • Item status - item status (parallax will not be displayed if it's disabled)
    • Layout speed - digit value from 0 to 2, which defines main parallax block speed
    • Offset - main layer indent on the Y axis
    • Inverse - parallax direction
    • Fade - this option allows configuring main block fade-out on page scroll
    • Video id - YouTube video ID
    • Sort order - layout position, relative to the rest of items

  • Image - image layer which position can be defined with CSS

    • Item status - item status (parallax will not be displayed if it's disabled)
    • Layout speed - digit value from 0 to 2, which defines main parallax block speed
    • Offset - main layer indent on the Y axis
    • Inverse - parallax direction
    • Fade - this option allows configuring main block fade-out on page scroll
    • Image - link to an image, to which parallax effect will be applied
    • Specific class - custom CSS class for this layer
    • Sort order - layout position, relative to the rest of items

Uploading video and images to server

In order to upload video or an image to server via File Manager, first you need to press 'file' (1) icon next to the needed field.

In the following window, in the 'actions' line, choose 'upload' (2).

Then you'll see one more pop-up window, to upload image or video file here.

Warnings and recommendations

  • Mobile devices (smartphones, tablets) have a parallax effect disabled by default, the uppermost block image layer is used as a background instead
  • The forced full width of the parallax block affects page loading speed more critically than a regular full width block loading
  • The smaller the size of the uploaded video, the better.

JX Mega Layout 1.1.0

This module is designed to allow creating custom layouts (presets) for hooks and displaying them at site instead of the default positions. This module advantage is allowing you to create different hook markups and modify them up to your needs.

Functional characteristics and features of the module

  • Requirements:

    • PrestaShop 1.6+

    • PHP 5.4+

  • Features:

    • Module includes 5 hooks: 'Header', 'Top Column', 'Home', 'Footer' and 'Product Footer'.

    • In case module is not present in the hook, it can't be added to the preset.

    • Module can be displayed in the preset only once, the same as in a hook.

    • Module position in 'Modules and Services -> Positions' section does not affect the preset.

    • The module does not allow you to configure different modules. You cannot set different modules configuration for various presets.

Module provides you with an option for changing module position and setting up the grid for 3 hooks: displayTopColumn, displayHome, displayFooter. Changing the modules position in 'Modules and Services -> Positions' section will not affect the modules position in the preset. In case the module was not added to the hook, it can't be added to the preset either.

Integrating module to the theme

Integrating module to the THIRD-PARTY theme your presets won't be displayed at the frontend without this step.

NOTE: for third-party sources only if JX Mega Layout module is not included by default. The codes below have already been integrated into ZEMEZ template.

  • Header. In order to add custom preset to the Header hook, you need to perform the following steps:

    • Open the /templates/_partials/header.tpl file for editing.
    • Locate the following code: 
         {block name='header_banner'}
    <div class="header-banner">
            {hook h='displayBanner'}
          </div>
  {/block}

  {block name='header_nav'}
    <nav class="header-nav">
      <div class="container">
        <div class="row">
          <div class="hidden-sm-down">
          <div class="col-md-5 col-xs-12">
            {hook h='displayNav1'}
          </div>
          <div class="col-md-7 right-nav">
            {hook h='displayNav2'}
          </div>
        </div>
        <div class="hidden-md-up text-sm-center mobile">
        <div class="float-xs-left" id="menu-icon">
        <i class="material-icons d-inline"></i>
                    </div>
        <div class="float-xs-right" id="_mobile_cart"></div>
                    <div class="float-xs-right" id="_mobile_user_info"></div>
                    <div class="top-logo" id="_mobile_logo"></div>
                    <div class="clearfix"></div>
                    </div>
        </div>
      </div>
    </nav>
  {/block}

{block name='header_top'}
    <div class="header-top">
      <div class="container">
        <div class="row">
          <div class="col-md-2 hidden-sm-down" id="_desktop_logo">
            <a href="{$urls.base_url}">
              <img class="logo img-responsive" src="{$shop.logo}" alt="{$shop.name}">
            </a>
          </div>
          <div class="col-md-10 col-sm-12 position-static">
            {hook h='displayTop'}
            <div class="clearfix"> </div>
                    </div>
        </div>
        <div id="mobile_top_menu_wrapper" class="row hidden-md-up" style="display:none;">
        <div class="js-top-menu mobile" id="_mobile_top_menu"> </div>
                   <div class="js-top-menu-bottom">
                    <div id="_mobile_currency_selector"></div>
                    <div id="_mobile_language_selector"></div>
                    <div id="_mobile_contact_link"></div>
       </div>
     </div>
     </div>
    </div>
    {hook h='displayNavFullWidth'}
  {/block}
    • And replace it with: 
       {assign var='displayMegaHeader' value={hook h='jxMegaLayoutHeader'}}
 {if $displayMegaHeader}
  {$displayMegaHeader nofilter}
  {else}
  {block name='header_banner'}
     <div class="header-banner">
      {hook h='displayBanner'}
    </div>
  {/block}

  {block name='header_nav'}
     <nav class="header-nav">
       <div class="container">
         <div class="row">
           <div class="hidden-sm-down">
            <div class="col-md-5 col-xs-12">
           {hook h='displayNav1'}
           </div>
           <div class="col-md-7 right-nav">
            {hook h='displayNav2'}
             </div>
       </div>
                    <div class="hidden-md-up text-sm-center mobile">
         <div class="float-xs-left" id="menu-icon">
         <i class="material-icons d-inline"> </i>
         </div>
         <div class="float-xs-right" id="_mobile_cart"></div>
                    <div class="float-xs-right" id="_mobile_user_info"></div>
                    <div class="top-logo" id="_mobile_logo"></div>
                    <div class="clearfix"></div>
        </div>
       </div>
     </div>
     </nav>
  {/block}

  {block name='header_top'}
    <div class="header-top">
      <div class="container">
        <div class="row">
          <div class="col-md-2 hidden-sm-down" id="_desktop_logo">
            <a href="{$urls.base_url}">
              <img class="logo img-responsive" src="{$shop.logo}" alt="{$shop.name}">
            </a>
         </div>
                    <div class="col-md-10 col-sm-12 position-static">
            {hook h='displayTop'}
            <div class="clearfix"></div>
          </div>
        </div>
          <div id="mobile_top_menu_wrapper" class="row hidden-md-up" style="display:none;">
        <div class="js-top-menu mobile" id="_mobile_top_menu"></div>
         <div class="js-top-menu-bottom">
         <div id="_mobile_currency_selector"></div>
         <div id="_mobile_language_selector"></div>
          <div id="_mobile_contact_link"></div>
      </div>
    </div>
    </div>
    </div>
    {hook h='displayNavFullWidth'}
  {/block}
  {/if}

  • Top column. In order to add custom preset to the topColumn hook, you need to perform the following steps:

    • Open the /templates/_partials/header.tpl file for editing.
    • Locate the following code 
      {hook h="displayNavFullWidth"}
    • And replace it with: 
          {hook h="displayNavFullWidth"}
    {assign var='displayMegaTopColumn' value={hook h='jxMegaLayoutTopColumn'}}
        {if $displayMegaTopColumn}
            {$displayMegaTopColumn nofilter}
             {/if}

  • Home. In order to add custom preset to the Home hook, you need to perform the following steps:

    • Open the /templates/layouts/layout-both-columns.tpl file for editing.
    • Locate the following code: 
      <section id="wrapper">
   {hook h="displayWrapperTop"}
         <div class="container">
    {block name="breadcrumb"}
    {include file='_partials/breadcrumb.tpl'}
    {/block}

    {block name="left_column"}
      <div id="left-column" class="col-xs-12 col-sm-4 col-md-3">
      {if $page.page_name == 'product'}
      {hook h='displayLeftColumnProduct'}
  {else}
     {hook h="displayLeftColumn"}
     {/if}
      </div>
    {/block}

     {block name="content_wrapper"}
       <div id="content-wrapper" class="left-column right-column col-sm-4 col-md-6">
       {hook h="displayContentWrapperTop"}
      {block name="content"}
        <p> Hello world! This is HTML5 Boilerplate.</p>
      {/block}
   {hook h="displayContentWrapperBottom"}
     </div>
   {/block}

    {block name="right_column"}
       <div id="right-column" class="col-xs-12 col-sm-4 col-md-3">
       {if $page.page_name == 'product'}
       {hook h='displayRightColumnProduct'}
   {else}
       {hook h="displayRightColumn"}
       {/if}
      </div>
    {/block}
     </div>
   {hook h="display wrapperBottom"}
</section>
    • And replace it with: 
          <section id="wrapper">
      {assign var='displayMegaHome' value={hook h='jxMegaLayoutHome'}}
       {if $page.page_name == 'index' && $displayMegaHome}
       {$displayMegaHome nofilter}
      {else}

       {hook h="displayWrapperTop"}
       <div class="container">
       {block name="breadcrumb"}
        {include file='_partials/breadcrumb.tpl'}
       {/block}

       {block name="left_column"}
        <div id="left-column" class="col-xs-12 col-sm-4 col-md-3">
        {if $page.page_name == 'product'}
         {hook h='displayLeftColumnProduct'}
       {else}
         {hook h="displayLeftColumn"}
       {/if}
       </div>
       {/block}

       {block name="content_wrapper"}
         <div id="content-wrapper" class="left-column right-column col-sm-4 col-md-6">
         {hook h="displayContentWrapperTop"}
         {block name="content"}
           <p>Hello world! This is HTML5 Boilerplate.</p>
       {/block}
         {hook h="displayContentWrapperBottom"}
        </div>
       {/block}

       {block name="right_column"}
         <div id="right-column" class="col-xs-12 col-sm-4 col-md-3">
         {if $page.page_name == 'product'}
           {hook h='displayRightColumnProduct'}
         {else}
           {hook h="displayRightColumn"}
         {/if}
        </div>
        {/block}
      </div>
        {hook h="displayWrapperBottom"}
      {/if}
  </section>

  • Footer. In order to add custom preset to the Footer hook, you need to perform the following steps:

    • Open the /templates/layouts/layout-both-columns.tpl file for editing.
    • Locate the following code: 
         {block name="footer"}
{include file="_partials/footer.tpl"}
{/block}
    • And replace it with: 
        {assign var='displayMegaFooter' value={hook h='jxMegaLayoutFooter'}}
{if $displayMegaFooter}
{$displayMegaFooter nofilter}
{else}
<div class="container">
{block name="footer"}
{include file="_partials/footer.tpl"}
{/block}
</div>
{/if}

  • Product footer. In order to add custom preset to the Product footer hook, you need to perform the following steps:

    • Open the /templates/catalog/product.tpl file for editing.
    • Locate the following code: 
      {block name='product_footer'}
      {hook h='displayFooterProduct' product=$product category=$category}
    {/block}
    • And replace it with: 
       {block name='product_footer'}
   {assign var='displayMegaProductFooter' value={hook h='jxMegaLayoutProductFooter' product=$product category=$category}}
   {if $displayMegaProductFooter}
    {$displayMegaProductFooter nofilter}
  {else}
    {hook h='displayFooterProduct' product=$product category=$category}
   {/if}
  {/block}

Hooks

The module has 5 hooks available by default:

  • 'Header' is a hook that combines 2 standard hooks: displayNav and displayTop. This hook corresponds to the website header.
  • 'Top Column' corresponds to the original displayTopColumn hook. This hook comes right after the Header hook.
  • 'Home' corresponds to the original displayHome hook. This hook is present only on the main page.
  • 'Footer' corresponds to the original displayFooter hook.
  • 'Product Footer' corresponds to the original displayFooterProduct hook, which is displayed in product page footer.

JX Mega Layout Main Panel

Main Layouts

The main JX Mega Layout module configuration panel that allows you to add a preset to the required hook and configure the preset.

Adding the preset

  • Press '+ Add Preset' (1) in the needed tab.

  • Next, fill in the 'Enter layout name' field in the popup typing the new preset (2) title there and press 'Save' (3).

  • Preset was successfully created, it's listed among the available presets (4) now. Newly created preset is selected for editing (5).

Preset activation

  • First of all, select the needed preset from the list (1).

  • Press the 'Use as default' (2) switcher.

  • The preset was activated. If you need to display this preset only on some pages, open the drop-down (3) and select the pages you need. To apply changes, click outside the list area. A preset that is displayed on all pages will be marked with a filled star in the presets list, and the one that is displayed only on some pages will be marked with a partially filled star.

Removing the preset

There is no option to restore the preset after removing.

  • In order to remove the preset, choose the required preset among the list (1).

  • Next, press a cart (2) near the preset title.

  • Preset was successfully removed.

Renaming the preset

  • In order to rename the preset, choose the required preset among the list (1).

  • Next, press a pencil icon (2) next to the preset title.

  • Specify the new preset title (3) in a popup and press 'Rename layout' (4).

  • Preset was successfully renamed.

Wrapper

Wrapper has no class by default, it's not a mandatory item.

Adding the wrapper

  • In order to create a wrapper, press '+ Add wrapper' (1).

  • Wrapper was added (2).

Adding the custom CSS class to the wrapper

Adding the custom class will let you create a specific styling for your wrapper by using CSS rules.

  • In order to add wrapper class, press the button (1).

  • You'll see a pop-up window, fill in the 'Enter wrapper classes' (2) field there and press a 'Confirm' (3) button.

  • Custom class was added successfully.

Deleting the wrapper

Deleting the preset item will also cause all of its child items and their styles removing.

  • In order to remove the wrapper, press the cart button (1).

  • Wrapper was removed successfully.

Styling the wrapper

  • In order to add custom styles to the wrapper, press the 'pencil' (1) icon in the wrapper block.

  • In the following pop-up window fill in all the needed fields (you may refer to the documentation 'Styling' section), and press 'Save' (2) button.

  • If all the fields are filled in correctly, styles will be saved.

Row

Row item from the Bootstrap grid. It's a required item.

Adding the row

  • In order to insert a new row, press '+ Add row' (1) into the wrapper block, or '+ Add row' (2) in the main preset block, or '+ Add row' (3) in the column drop-down list.

  • The row was added successfully.

Adding custom CSS class to the row

Custom class adding allows you to create custom row styling using CSS rules.

  • In order to add the class to the row, you should press the 'ellipsis' button (1).

  • Choose the 'Edit row' (2) in a drop-down list.

  • Fill in the 'Enter row classes' (3) field in the pop-up window and press 'Confirm' (4) button.

  • Custom class was added successfully.

Deleting the row

Removal of preset item will also cause removal of its child items and their styles.

  • In order to remove the row, open the menu (the 'ellipsis' icon) in the row block.

  • Choose 'Delete' (2) option in the drop-down.

  • The row was successfully removed.

Adding styles to the row

  • In order to add row styles, open the menu (the 'ellipsis' icon) (1) in a row block.

  • Press 'Stylize' (2) in the drop-down.

  • You will see the pop-up window, fill in all the needed fields there (you may refer to the documentation 'Styling' section) and press 'Save' (3) button.

  • If all the fields are filled in correctly, styles will be saved.

Column

It is an item with configurable block width for different dimensions, based on Bootstrap grid.

Adding the column

  • In order to insert a column into a needed 'row', open the menu (the 'ellipsis' icon) (1)

  • Choose the '+ Add Col' (2) among the list.

  • Fill in the fields (col-xs*, col-sm*, col-md*, col-lg - bootstrap classes) in the pop-up window and press 'Confirm' (3) button.

  • The column was added successfully.

Removing the column

Preset item removing will also cause its child items and their styles deleting.

  • In order to remove the column, open the menu (the 'ellipsis' icon) in a column block (1)

  • Press 'Delete' (2) in the list.

  • The column and all of its child items were removed.

Editing the column

  • In order to edit the column, open the menu (the 'ellipsis' icon) (1) in the column block.

  • Press 'Edit column' (2) in the list.

  • Fill in the fields (col-xs*, col-sm*, col-md*, col-lg - bootstrap classes) in the pop-up window and press 'Confirm'.

  • The column was successfully edited.

Adding styles to the column

  • In order to add column styles, open the menu (the 'ellipsis' icon) (1) in a column block.

  • Press 'Stylize' (2) in the list of options.

  • You will see the pop-up window, fill in all the needed fields there (you may refer to the documentation 'Styling' section) and press 'Save' (3) button.

  • If all the fields are filled in correctly, styles will be saved.

Module

Module assigned to this hook.

Adding the module

Be careful when adding modules to the preset, some modules are desirable to use if they do not change the visible layout, e.g., 'Data mining for statistics' module.

  • In order to add the module to the preset in a column block, open the menu (the 'ellipsis' icon) (1).

  • Press the '+ Add Module' (2) in the list of options available.

  • If needed, you can enter the custom class (3) in the pop-up window and select the module (4), next press 'Confirm' (5).

  • The module was successfully added.

  • In this version of JX Mega Layout you can add 'Homepage tabs' module in Home hook.

    It can also be customized like all other modules in Mega Layout.

Deleting the module

Removal of preset item will also cause removal of its child items and their styles.

  • In order to remove the module, open the menu (the 'ellipsis' icon) (1) in the module block.

  • Press 'Delete' (2) in the list of options available.

  • The module is removed.

Adding custom class to the module

Custom class adding allows to create module styling using CSS rules.

  • In order to specify custom class for the module, open the menu in the module block (the 'ellipsis' icon) (1).

  • Press 'Edit Settings' (2) then.

  • Specify custom class (3) in the pop-up window and press 'Confirm' (4) button.

  • Custom class was added.

Logo, Copyright

Logo and Copyright blocks are edited the same way as modules, except for the fact that Logo can be placed only in Header or Footer position, and the Copyright block can be placed only in Footer position.

Product Page

Product Info tab
By means of this tab you can switch the layouts of product page. It will appear in the admin panel after making some simple actions described below.
Creating layout
Layouts are created and edited manually.

  • Create folder 'product_pages' in your theme folder.

  • In theme folder find the file 'product.tpl', copy it to the created folder 'product_pages' and rename to 'default.tpl'. To create several layouts - duplicate this file, rename it (e.g. 'layout_1.tpl', 'layout_2.tpl') and change the structure according to your needs.
  • Create file 'config.json' in this folder. Copy the following code into it: 
    {
  "default": {
    "name": "Default",
    "preview": "default.jpg",
    "default": 1
  }
}
    • "default" - name of .tpl file containing the product page structure.
    • "name": "Default" - title of product page layout in module settings.
    • "preview": "default.jpg" - preview picture of product page layout in module settings; image should be located in 'product_pages' folder.

    • "default": 1 - set to '1' if the layout should be set as default


      One of the layouts should contain '1' value to be set as default.

    This code should be duplicated for each created layout, and contain corresponding values. For example:

    {
  "default": {
    "name": "Default",
    "preview": "default.jpg",
    "default": 0
  },
  "layout_1": {
    "name": "Layout 1",
    "preview": "layout_1.jpg",
    "default": 0
  },
  "layout_2": {
    "name": "Layout 2",
    "preview": "layout_2.jpg",
    "default": 1
  }
}
  • Open the 'product.tpl' file in the theme folder. Delete everything and paste the following code: 
    {include file="$tpl_dir./errors.tpl"}
{if $errors|@count == 0}
  {if isset($megalayoutProductInfoPage) && $megalayoutProductInfoPage}
    {assign var='path' value="./product_pages/`$megalayoutProductInfoPage`"}
    {include file=$path}
  {else}
    {include file='./product_pages/default.tpl'}
  {/if}
{/if}
  • To add/edit styles of any product page layout, go to your_theme_folder/css/ and add new folder 'product_pages'. In this folder create file with the layout name and .css extension (e.g. 'default.css', 'layout_1.css', 'layout_2.css'). These files should contain styles of the corresponding product page layout.
  • To add scripts to any product page layout, go to your_theme_folder/js/ and add new folder 'product_pages'. In this folder create file with the layout name and .js extension (e.g. 'default.js', 'layout_1.js', 'layout_2.js'). These files should contain scripts of the corresponding product page layout.
Switching layouts

Select 'Product Page' from the drop-down list (1) and click the 'Product Info' tab (2).

In this tab you can switch the layouts of product page. The layout image with the gray border is set as default.

Presets export

Export tool allows you to export presets for the further import into different shops.

  • Navigate to the 'Tools' (1) tab in the main configurations panel.

  • Choose 'Export' (2) in the form.

  • You'll see the list of the existing presets in site hooks.

  • In order to preview the preset, press 'Layout preview' (3) button next to the preset you need, in order to export, please press 'Export layout' (4) button.

  • Then you'll be able to download this preset as a zip archive.

Preset import

Import tool accepts only the presets *.zip files that were previously generated with the same module Export tool.

  • In order to import your preset, you should open the Tools (1) tab and choose 'Import' (2).

  • Next, press the Add file (3) button and select the zip file of your exported preset. In case this archive is the exported preset, you will see this preset preview.

  • If this preset meets your needs, press 'Import' (4). The preset will be imported and added to the list of available presets.

Reset

'Reset' reverts all the presets to initial state (to the way they came with the template), and discards all the created presets.

Attention! After reverting presets to default state, all the custom presets will be discarded!

  • To reset presets, navigate to the 'Tools' (1) tab. In the appeared block open the 'Options' (2) tab.

  • Press the 'Reset' button.

  • That's it! All presets are reset to initial state.

Styles and Scripts Optimization

Styles and scripts optimization adds exclusions for modules in Header section, based on their use in presets. This allows speeding up the page loading speed. Optimization works in test mode.

Enabling optimization:

  • To enable optimization, open the 'Tools' (1) tab and select the 'Options' (2) tab.

  • In the appeared window, you can enable optimization (3).

If optimization is enabled when editing and enabling presets, optimization gets discarded, but you'll see a window offering to run optimization. There is no need to optimize scripts and styles every time you change presets. It's better to optimize them when you're done editing.

Styling

  • Background styles. Fields description:

    • background-image (background image) - the image URL or 'none' value. The image is picked from the ~/images/cms/ folder.
    • background-color (background color) - the value can be set in any color format (rgb, hex, etc.). You can choose the color using the Color Picker tool.
    • background-repeat (background repeat) - all the available options are listed in the radio buttons.
    • background-position (background position) - all the available options are listed in the drop-down.
    • background-size (background size) - all the available options are listed in the drop-down.
    • background-origin (background image positioning region) - all the available options are listed in the drop-down.

  • Border styles.

    • border-top-style, border-right-style, border-left-style, border-bottom-style (border styles) - all the available options are listed in the drop-down.
    • border-top-width, border-right-width, border-left-width, border-bottom-width (borders width) - should be set in pixels.
    • border-top-сolor, border-right-color, border-left-color, border-bottom-color (borders color) - the value can be set in any color format (rgb, hex, etc.). You can choose the color using the Color Picker tool.
    • border-top-right-radius, border-top-left-radius, border-bottom-right-radius, border-bottom-left-radius (border radius) - should be set in pixels.

  • Other styles.

    • box-shadow (box shadow) - example:0px 0px 0px 0px rgba(0,0,0,0.75).
Items styles removing

  • In order to remove items styles, open the items styling section and press 'Clear styles' (1)

Warnings

If the following message appears in the module item block, you should enable the mentioned module.

If the following message appears in the module item block, you should install the mentioned module.

In case you remove or deactivate the 'JX Mega Layout' module, all the active presets will be disabled and you will see the positions (hooks) in their original appearance.

JX Mega Menu

The module is designed to create complex menus. The module provides the ability to display one item (without sub-menu), a menu item with a sub-menu and a menu item with sub-menu by means of a multi-row and multi-column block. The module can be used in different positions, but it will display the same content. Available positions: top (displayTop), left (displayLeftColumn), right (displayRightColumn), footer (displayFooter). You can add categories (with subcategories), CMS categories (with subcategories), manufacturers (one or a list), suppliers (one or a list), stores (if multi-store is used), links to any product, information block about the product, custom links (not limited in quantity), custom HTML blocks (not limited in number) and banners. See below for more details.

The module includes 6 main tabs that allow customizing the menu.

JX Mega Menu Items

JX Mega Menu items are the basic items which appear in the menu.

In order to create a new item, open the JX Mega Menu module and click Add item button from the top menu or click "+" button in the top right of the table.

In the form that appears, fill in the required fields.
  • Enter item name
    the tab title which is mandatory to be filled in for the default language, if the additional languages fields are not filled in, the tab takes its name from the default language.
  • Active
    active/inactive tab.
  • Link
    a link that is assigned to this tab. You can enter a custom link, or choose from existing options (categories, CMS categories). If you leave the field blank, the link of this tab is inactive.
  • Sort order
    the order of tabs to be displayed.
  • Specific Class
    the class which is added to emphasize the item (CSS class).
  • Enter item badge
    is filled in depending on multi-languages.
  • It is Mega Menu
    given tab sub-menu is a Mega Menu. *
  • Use simple menu
    given tab sub-menu is a simple menu. **

* It is Mega Menu. If this option is selected, there will be a form to create a complex menu (Mega Menu).

** Use simple menu. If this option is selected, there will be a form to create a simple menu. This is a menu that displays the selected content in a single column. If the menu has embedded content, the new column is added.

Complex menu consists of rows and columns in rows.

The Row is a part of the Mega Menu structure. It includes the menu columns. The existing row can be removed by clicking the appropriate button. The row will be removed with the content it includes. The rows quantity is not limited.

The Column is a part of the Mega Menu structure, which is placed inside the rows. (The Class) The width of the column cannot be less than 2 and more than 12. In order to make the menu display properly, the total column width cannot exceed 12. The width (class) is a Bootstrap column type, corresponds to the same values.

In order to create the menu, click the 'Add row' button.

In the form appeared, click 'Add column' button.

In the pop up window you need to specify the column class (from 2 to 12). The column itself appears next where you need to set the required settings.

Here you can change the column class, CSS class and the content from the list provided. You can add/remove content by double clicking the item, or by highlighting the items and clicking the corresponding button.

Block can be removed by clicking 'Remove block' button in the footer of the block.

By removing the row, the included columns are also removed.

In order to move the content available in the selected menu, double-click or highlight the desired content and press the corresponding button.

Inactive menu information is saved while switching between menu types and you can always change the type of menu.

JX Mega Menu HTML

In this section we will explain how to create a custom HTML block in the Mega Menu.

The module has a table listing all the available blocks. You can also add a new block by clicking the '+' button in the top right of the table.

In the form that appears, fill in the required fields.
  • Enter HTML item name
    HTML block name, is mandatory to be filled in for the default language.
  • Specific class
    block's CSS class.
  • HTML content
    HTML content.

Added block will appear in the list of blocks, as well as in the list of available content while creating menu blocks.

JX Mega Menu Links

In this section we will show how to create custom links in the Mega Menu.

The module has a table listing all the available links. You can also add a new link by clicking the '+' button in the top right of the table.

In the form that appears, fill in the required fields.
  • Enter Link name
    link name, is mandatory to be filled in for the default language.
  • Enter Link URL
    link URL, is mandatory to be filled in for the default language.
  • Specific class
    block's CSS class.
  • Open in new window
    open link in a new window.

Added link will appear in the list of links, as well as in the list of available content while creating menu blocks.

JX Mega Menu Banners

In this section we will explain how to create banners in the Mega Menu.

The module has a table listing all the available banners. You can also add a new banner by clicking the '+' button in the top right of the table.

In the form that appears, fill in the required fields.
  • Select a file
    select a file, is mandatory to be filled in for the default language.
  • Enter Banner name
    banner title, is mandatory to be filled in for the default language.
  • Enter Banner URL
    link URL, is mandatory to be filled in for the default language.
  • Specific class
    block's CSS class.
  • Public Title
    public banner title.
  • Description
    set the description of the banner.
  • Open in new window
    open link in a new window.

Added banner will appear in the list of banners, as well as in the list of available content while creating menu blocks.

JX Mega Menu Video

In this section we will explain how to add a video in the Mega Menu.

The module has a table listing all the available videos. You can also add a new video by clicking the '+' button in the top right of the table.

In the form that appears, fill in the required fields.
  • Enter Video Name
    video title (the field is required).
  • Enter Video URL - add video link in the formats described below:
    • If this is a YouTube video, click on Embed and copy the code between the quotes for https://www.youtube.com/embed/video_id
    • If this is a Vimeo video, click on Share icon and in the Embed section copy the source code between the quotes for http://player.vimeo.com/video/video_id

Added video will appear in the list of videos, as well as in the list of available content while creating menu blocks.

JX Mega Menu Map

In this section we will explain how to add a map in the Mega Menu.

The module has a table listing all the available maps. You can also add a new map by clicking the '+' button in the top right of the table.

In the form that appears, fill in the required fields.
  • Enter Map item name
    the title of the map.
  • Enter Map latitude
    set a latitude value.
  • Enter Map longitude
    set a longitude value.
  • Marker
    adding a custom marker.
  • Enter Map scale
    the scale of the map (used 8 by default).
  • Map description
    set the description of the map.

Added map will appear in the list of maps, as well as in the list of available content while creating menu blocks.

JX Mosaic Products

This module allows you to display categories with products, banners, video (YouTube, Vimeo and custom video), HTML content, various sliders with different number of slides and dimensions in any row on the site home page.

Installation and Deleting

The module is installed and deleted like any other PrestaShop module.

Module settings

After module has been installed, you can add the required blocks with category products, previously added banners, video and HTML content.

Adding/removing/editing Blocks

In order to add a new category, press the "Add new" button.

  • Select category - choose a category to add products, banners, video and HTML content to.
  • Use custom name - custom category status.
  • Custom name - category title.
  • Status - item status.

    • In order to add the new row, press the "Add row" button. Then choose one of the eight layouts presented in the following window.

In order to add the layout, click on one of the eight options to pick it, and it will be added to the form.

In order to add items, click on one of the layout cells. You'll see five buttons listing the available items of certain type.

After pressing one of the buttons you will see the form to pick the item of chosen type.

After clicking on one of the items, it will be added to the layout cell. You can fill in the layout with different blocks this way.

After saving the category with chosen layouts, it will show up in the form of the added categories.

In order to remove the item, press the 'Delete' button.

Banner adding/removing/editing

In order to add a new banner, click the 'Add new banner' button. Next, fill in the required fields in the form that appears.

  • Select a file - choose a file, this field is required (at least for the default language).
  • Title - banner title, this field is required (at least for the default language).
  • Url - link path, this field is required (at least for the default language).
  • Description - banner description (at least for the default language).
  • Specific class - block's CSS class.
Adding/removing/editing Video

In order to add a new video, click the 'Add new video' button. Next, fill in the required fields in the form that appears.

  • Enter Video name - video title, this field is required (at least for the default language).
  • Video Link/Path - link to the video (YouTube, vimeo or custom video), this field is required (at least for the default language).
  • Allow autoplay - defines if video starts automatically right after the player has been loaded.
  • Allow controls - defines if player controls are displayed.
  • Loop - defines if the video playback is in the infinite loop.

In order to add custom video, press the 'file' button. Next, you'll be able to add a video via file manager.

Adding/removing/editing HTML content

In order to add new HTML content, press the 'Add new HTML' button. Next, fill in the required fields in the form that appears.

  • Enter HTML item name - HTML content title, this field is required (at least for the default language).
  • Specific class - block's CSS class.
  • HTML content - the content.
Adding/removing/editing Slider

In order to add a new slider, press the 'Add new slider' button. Next, fill in the required fields in the form that appears.

  • Enter Slider item name - slider title, this field is required (at least for the default language).
  • Control - show/hide slider navigation.
  • Pager - show/hide slider pagination.
  • Auto scroll - turns on/off slider autoplay.
  • Specific class - block's CSS class.
  • Carousel speed - slides transition duration (in ms), this field is required.
  • Pause - the period between slides switching (in ms), this field is required.
Adding/removing/editing Slides

In order to add a new slide, click the 'View' button in the slider form and then press the 'Add new' button in a window that appears. Then fill in the required fields.

  • Type - choose the slide type, this field is required.
  • Banner/Video/Html list - choose the element of the previously selected type, this field is required.
  • Sort order - slide position.
  • Item status - status of the element.

JX Product List Gallery 2.0.0

This module displays all the available product images in form of a gallery on product listing pages. Depending on what settings you choose, the module can display images in form of a rollover or slideshow.

Module Installation and Deleting

This module can be installed and deleted like any other PrestaShop module.

Module settings

After the module is installed, navigate to \themes\classic\templates\catalog\_partials\miniatures\product.tpl. Open this file and find the following code:

    {block name='product_thumbnail'}
        {if $product.cover}
            <a href="{$product.url}" class="thumbnail product-thumbnail">
                <img src="{$product.cover.bySize.home_default.url}" alt="{if !empty($product.cover.legend)}{$product.cover.legend}{else}{$product.name|truncate:30:'...'}{/if}" data-full-size-image-url="{$product.cover.large.url}">
            </a>
        {else}
            <a href="{$product.url}" class="thumbnail product-thumbnail">
                <img src="{$urls.no_picture_image.bySize.home_default.url}">
            </a>
        {/if}
    {/block}

and replace it with:

    {block name='product_thumbnail'}
        {if $product.cover}
            <a href="{$product.url}" class="thumbnail product-thumbnail">
                {capture name='displayProductListGallery'}{hook h='displayProductListGallery' product=$product}{/capture}
                {if $smarty.capture.displayProductListGallery && count($product.images) > 1}
                    {hook h='displayProductListGallery' product=$product}
                {else}
                    <img src="{$product.cover.bySize.home_default.url}" alt="{if !empty($product.cover.legend)}{$product.cover.legend}{else}{$product.name|truncate:30:'...'}{/if}" data-full-size-image-url="{$product.cover.large.url}">
                {/if}
            </a>
        {else}
            <a href="{$product.url}" class="thumbnail product-thumbnail">
                <img src="{$urls.no_picture_image.bySize.home_default.url}">
            </a>
        {/if}
    {/block}

After installing and connecting the module, you can set it up on the module configuration page.

The module has the following main settings:
  • Live mode - ability to use the module in live mode.
  • Type - select display type: rollover, gallery or slideshow.

If you choose rollover, you can choose the animation effect:

Animation type:
  • Opacity slide - opacity changes;
  • Horizontal slide - horizontal;
  • Vertical slide - vertical.

If you choose gallery, you will find the following settings available:

  • Display items - the number of items displayed;
  • Visible items in row - the number of items in a row;
  • Use carousel - enable/disable the carousel for this block.

If you choose slideshow, you will find the following settings available:

  • Display items - the number of items displayed;
  • Use pager - pager display in slide show;
  • Use controls - controls display in slide show.

JX Product Zoomer

This module is an alternative solution for the standard product image zoom on the single product page. It's fully compatible with the standard additional products thumbnail carousel and product attributes changes. It allows you to choose among the three available options (window/lens/inner) for image zoom with the advanced plugin settings. The module is based on the Elevatezoom Plus plugin.

Installation and removing

The module is installed and deleted like any other PrestaShop module.

Module configuration

After the module has been installed you can configure it on the module configuration page.

By default, the configuration page shows a simplified set of options.

  • Live mode - module is on/off.
  • Fancybox - whether to show the enlarged image in the Fancybox on click.
  • Change image on hover - switch the main image on thumbnail hover (by default is set to switch on click).
  • Responsive - allows to the use adaptive functionality for plugin display on the mobile devices.
  • Zoom Type - choose the type of the enlarged image display mode
    • window - the enlarged image shows up next to the main image in one of the available (16) positions
    • lens - the image is zoomed in the lens container, on top of it
    • inner - the image is zoomed inside of main image container, fully covering it.
    The mobile devices (< 768) have "lens" mode activated instantly.
  • Extended settings - enables advanced settings for the experienced users. You can see the link to the official documentation for more details next to it.
Extended module configuration
  • Scroll Zoom - zoom ratio change on the mousewheel scroll (available for all types).
  • Cursor - cursor type on the magnified image hover. The following options are available: default, cursor, crosshair (available for all types).
  • Zoom settings - available for all types, if the 'Scroll Zoom' is enabled.
    • Zoom Level - the zoom level on the initial hover.
    • Min Zoom Level - a minimum zoom level.
    • Max Zoom Level - a maximum zoom level.
    • Scroll Zoom Increment - magnifying scroll increment.
  • Easing - the magnified image appearance effect (available for all types).
    • Zoom Easing - effect on/off.
    • Easing Amount - effect delay value.
  • Image Crossfade - main image blur outside the hover area (the lens) - available for window, lens.
  • Magnified image window settings - available for window.
    • Zoom Window Width - window width in px.
    • Zoom Window Height - window height in px.
    • Zoom Window Offset X - window offset on the X axis.
    • Zoom Window Offset Y - window offset on the Y axis.
    • Zoom Window Position - window position choice relatively to the main image (the positions available are presented on the image below this field).
    • Zoom Window Bg Color - window background image (for transparent images only).
    • Zoom Window Fade In - the effect of slowing the window appearance.
    • Zoom Window Fade Out - the effect of slowing the window disappearance.
    • Border Size - window border width in px.
    • Border Color - window border color.
  • Zoom Lens - zoom lens (available for window, lens).
    • Zoom Lens - on/off.
    • Lens Shape - lens type. It can take the following values: circular/rounded or squared/rectangular.
    • Lens Color - lens inner background color.
    • Lens Opacity - lens inner background opacity.
    • Lens Size - lens size in px.
    • Lens Fade In - the speed of lens appearance effect.
    • Lens Fade Out - the speed of lens disappearance effect.
    • Lens Border - lens border width.
    • Lens Border Color - lens border color.
    • Contain Lens Zoom - the restriction of the lens overflow outwards the main image container.
  • Tint - the shade effect on the area outside the lens (available for window).
    • Tint - effect on/off.
    • Tint Color - the lens outer area background.
    • Tint Opacity - the lens outer area opacity.
    • Tint Fade In - the appearance effect speed.
    • Tint Fade Out - the disappearance effect speed.
If you switch the zoom type, advanced options set is changed accordingly to show only the available parameters for the type selected.
Be careful when editing the extended settings. If the settings are set incorrectly, the effect can be ugly.

JX Search 1.1.0

This module is an extended search version that allows you to select a specific category for searching within its content. You can also change the category after defining the query. It also provides a possibility to set the additional product information display (description/price/manufacturer, etc.), and define the search results container layout, e.g., you can divide the results into a few sections with the controls (pagination, next/previous/show all). All the module settings are available in the main admin panel.

Installation and Deleting

The module is installed and deleted like any other PrestaShop module.

Module configuration

After module has been installed you can set it up on the module configuration page.

  • Enable Ajax Search - enables live search in a drop-down.
  • Minimum query length - number of symbols to start the result display.
  • Search in children category - enable/disable searching in children categories.
  • Number of shown results - number of products that shows up in the results section (number of products per page for the "pager" or "navigation" mode).
  • Display "Show All" button - displays the 'Show all' button below the results section, then click on it displays all found results.
  • Display pager - divides results into pages (depends on the 'Number of shown results' field value) and displays links to them.
  • Display navigation - shows the Previous/Next buttons.
  • Position of navigation - hook(s), to show the navigation (top/both/bottom options are available).
  • Highlight query result - highlights the text that matches search query.
  • Display image in Ajax search - shows product images in the results section.
  • Display description in Ajax search - shows product description in the results section.
  • Display prices in Ajax search - shows product price in the results section.
  • Display reference in Ajax search - shows product reference in the results section.
  • Display manufacturer in Ajax search - shows product manufacturer in the results section.
  • Display suppliers in Ajax search - shows product suppliers in the results section.
  • Blog search - enable/disable search by blog posts.

Some parameters might differ depending on the combination used.

JX Wishlist

JX Wishlist module is created to give the ability to the visitors of online store to add products to wishlists and share these wishlists on Facebook.

Module Installation

То install the module navigate to Admin panel -> Modules -> Modules and Services, find the JX Wishlist module and press 'Install' button (1).

Module Configuration

After the module has been installed, the 'Settings' page will appear.
Add the Facebook App Id to the required field (1) and press 'Save' button (2).
The instruction how to get the Facebook App Id can be found here: Creating an App ID.

Using JX Wishlist Module

Adding product to wishlist

Shop visitors should be logged in to be able to add the items to the wishlists.

  • After the module is installed, the button 'Add to wishlist' appears on each product page. It should look like on the screenshot below (1).

  • After clicking this button a shop visitor will see a notification: 'The product was successfully added to your wishlist.' It can be closed or skipped to wishlists view by clicking 'My wishlists' button (2).

Browsing Wishlists

  • On 'My Wishlists' page a client can add the new wishlist (1) or view the list of created ones (2).

  • Clicking 'View wishlist' button (1) will open the wishlist page, the 'View products' button (2) gives the ability to see the products list of this wishlist on current page.
    The title of wishlist can be edited (3) or deleted (4).
    To share the wishlist the visitor should press the 'Share' button (5).

  • While looking through the items in wishlist after clicking 'View products' button, each item can be removed from the list (1).

Sharing Wishlists

To share the wishlist the visitor should press the 'Share' button. There will be a few easy steps to follow before posting the wishlist. During each step, there's an ability to go back and change the sharing options.

  • First step is to choose the layout for wishlist that will be posted.

  • Then the products should be added. Each cell with a '+' is a button to add the product image.

    Choosing the images of each product:

  • When all images are added, the visitor should press the 'Share' button (1).

  • In a small window which is then appeared, there will be some standard posting options to choose and the ability to add some text to the post. After clicking 'Post to Facebook' button, the post will be published.

Statistics

Using this module you can also get the statistics collected while the products are added to wishlists. Thus, you will know which products are currently popular. This information can be very useful for suggesting a discount, for example.
You can view the statistics navigating to Admin panel -> Stats -> Stats -> JX Wishlist.

  • You can select the period for viewing the statistics from the specified time (1).
  • In the first column, there's a number of products that were added (2).
  • The second column is created for your convenience. You can use it to see how many of added products were sold (3).