Start chat

Hookah Documentation

Magento theme installation

This theme is not compatible with Magento 1.9 engine. It will work with the Magento 2.2.3 engine only.
If you already have a Magento store and want to apply the theme, follow the instruction below.

Install Theme on Live Store

To install the theme you only need to upload all the theme files (the app folder) to your server and then enable the theme in the admin panel.

You can find the theme requirements on the Theme Live-Demo page.

But to avoid unexpected problems after installation, you should first prepare your Magento. Please strictly follow the steps described in this guide:

Attention! Please DO NOT import sample data if you have a live website as it will completely replace your database content, and all your website data will be LOST.

The detailed Magento update guide you will find on the Magento User Guide.

It is recommended to install the theme on a test server before you install it on a live store.

Template Configuration

We are going to review template configuration options based on the example. We will configure it the same way as our Live Demo template, without affecting products data.

Activate the New Theme

Check the tutorial on how to Activate the New Magento Theme.

Pages, static blocks and widgets import

In order to make your template look exactly like our Live Demo, you need to import the store pages, static blocks and widgets. Please follow the instructions below in order to import store pages, static blocks and widgets.

Pages Import

  • Navigate to the Stores > Settings > Configuration section.
  • Then choose the TEMPLATEMONSTER > Theme Options in the left side menu and you'll move to the module settings interface.
  • Click on the Store View: Default Config. Select a Main Website from the option dropdown.
  • Confirm the scope switching in the pop-up window. Press "OK" to confirm.
  • Go to the Sample Data Installer tab > CMS pages.
  • Select files you want to import. You need to select Cms Page.
  • Set the Override option to "Yes" if you want to replace your store pages with new ones in case of duplicate key.
  • Press the Import button.
  • You will see the confirmation message. The message will inform you about the total number of imported pages.

Static blocks Import

When you are done with the pages import, you need to import the static blocks. The procedure is similar to the previous.

  • Go to the Sample Data Installer tab > CMS Blocks.
  • Select files you want to import. You need to select Cms Block.
  • Set the Override option to "Yes" if you want to replace your blocks with new ones in case of duplicate key.
  • Press the Import button.
  • You will see the confirmation message. The message will inform you about the total number of imported blocks.
  • Widgets Import

    Now you need to import the widgets. The procedure is almost the same as the previous one.

  • Go to the Sample Data Installer tab > Widgets.
  • Select the layout (if you have any) you want to import widgets from. You need to select the Widgets Intanse.
  • Set the Override option to "Yes" if you want to replace your widgets with new ones in case of duplicate key.
  • Press the Import button.
  • You will see the confirmation message. The message will inform you about the total number of imported widgets.
  • Remember to save the settings.

    Pages Configuration

    In order to make your template look exactly like our Live Demo, you need to set up store pages in a specific way. We provide all the files with the pages source code. You need to add them into Magento admin panel as per the instructions below using the settings table. Settings table is located on the Template Settings page on the template preview page.

    The main template page will be affected the most. It usually contains the following elements: banners, slider, etc.

    We recommend that you disable the WYSIWYG editor. To do this, from the admin top menu select Stores > Configuration. Open the "Content Management" section uncheck and in the WYSIWYG Options window set "Enable WYSIWYG Editor" option to "Disabled Completely".

    In case you have already made the changes to your pages code and would like to add our code without affecting your changes, it is recommended to contact professional technicians or prepare a backup before making changes.

    1. From the top menu select Content > Pages. Here you can find all the store pages. Home page, About Us and Customer Service should already be available, so you don't need to add them. You only need to update the pages HTML and XML content. Open any of them in order to get the access to the content.
    2. Open the page and select the Content tab. It contains the HTML code of the page. You can take the page HTML code from the appropriate source file. You can see the list of source files included in the "Template Settings" section on your templates preview page. Copy the code from the source file and paste it to the content area.
    3. When you are done with the HTML code, switch to "Design" tab. It contains the page XML code. XML code allows you to add Magento static blocks and widgets to the page. The XML code should be copied the same way as the HTML from the source file. Copy the XML code to the "Layout Update XML" area.
    4. Don't forget to select the valid "Layout" option.
    5. In case you need to add a new page, click the "Add New Page" button in the top right corner.

    Useful Tutorials:

    1. How to add content to Contact Us page?
    2. How to add new Page?
    3. How to add new Widget on the Page?
    4. How to add the CMS Page link to Main Menu?

     

    Widgets Configuration

    CMS Static Block Widget Type Configuration

    Banners 1 Widget
    1. To configure the Banners 1 widget, navigate to Content > Widgets. Click the widget title to open the setting interface.
    2. Assign the widget to specific Store View(s) or All Store Views.
    3. Navigate to Widgets Options tab. Press the Select Block button.
    4. Select the Banners 1 static block for this widget.
    5. Save the settings.

    You also can change the block content. In order to do this, go to the Content > Blocks section. Select Edit from the Action option dropdown. You will see CMS block settings interface. Now, you're able to edit the block content in the content field. Full HTML support is provided. Remember to save the settings.

    How to change the Banners 1 link?
    1. To change the banner link go to the Content > Blocks section.
    2. Find the static block you want to change (it's the Banners 1 block in our case).
    3. Select Edit from the Action option dropdown.
    4. You will see CMS block settings interface. Now, you're able to edit the block content in the content field. Full HTML support is provided. ( Press the Show / Hide Editor button to activate the HTML Editor. Check the tutorial: How to Enable/Disable the WYSIWYG Editor )
    5. Find the <a href="XXX.html"> code. Replace the XXX with the needed page or category URL Key.
    6. Remember to save the settings.
    How to change the Banners 1 image?
    1. To change the banner link go to the Content > Blocks section.
    2. Find the static block you want to change (it's the Banners 1 block in our case; see the Template Settings table).
    3. Select Edit from the Action option dropdown.
    4. You'll see the static block content field.
    5. Select the code which is responsible for the image display:
    6. <img src="{{view url=''}}/images/media/banner-1.png"/>
    7. Delete the code and press the Insert Image button.
    8. Upload the new banner image (click Browse) and press on the Insert File button.
    9. You should get the code:
    10. <img src="{{media url="wysiwyg/new-image.png"}}" alt="" />
    11. Save the block settings.

    The Banners 2, Banners 3 and Banners 4 widgets can be configured the same way.

    1. Banners 2 - select Banners 2 CMS Static block.
    2. Banners 3 - select Banners 3 CMS Static block.
    3. Banners 4 - select Banners 4 CMS Static block.
    Featured Products Widget

    1. To configure the Featured Products widget, navigate to Content > Widgets.
    2. Click the widget title to open the setting interface.
    3. Navigate to Widgets Options tab.
    4. You can change the tab title (All Products title, Top Rated Products title and Most Viewed Products title options)
      1. You also can show the selected items in the widget. Perform the next steps:

      2. Select Manual Product type and go to the Choose Custom Products option.
      3. Press Select button.
      4. Pick the products (put a checkmarl) you want to display in the widget and click Add Product.
    5. Save the settings.
    After each block, page or widget configuration, you should clear cache and reindex the data. You need to do this in order new pages, widgets and blocks appear on your website.

    The Best Sellers widget can be configured the same way.

    How change the Info Banners block Font Icon?
    1. Navigate to your Magento store admin panel. Then go to the Content > Blocks section.
    2. Find the Info Banners block and open it to edit. Select Edit from the Action option dropdown.
    3. You will see CMS block settings interface.
    4. Find the <i class="XXX"></i> line and replace XXX with a new icon class.)
    5. Remember to save the settings.
    You can find the font icon css class here.

    How to change the Store Info block text?

    1. Navigate to your Magento store admin panel. Then go to the Content > Blocks section.
    2. Find the Store Info block and open it to edit. Select Edit from the Action option dropdown.
    3. You will see CMS block settings interface. Now, you're able to edit the block content in the content field. Full HTML support is provided. (the text you can see on the frontend is between the <span>text</span> tag)
    4. Remember to save the settings.
    After each block, page or widget configuration, you should clear cache and reindex the data. You need to do this in order new pages, widgets and blocks appear on your website.

    How to configure the Mega Menu?

    Mega Menu for Desktop Version

    1. Go to Catalog > Categories menu.
    2. Open the category you want to add the dropdown to, then scroll down to the Megamenu tab.
    3. Enable Magamenu for this Category.
    4. Press the Add row button.
    5. Now you need to add col-12 column (press Add column(s) button).
    6. Enter the mmenu_desktop CSS class in the Enter Specific Class option textfield.
    7. You need to add the Catalog Image Grid widget to the column.
    8. To add the widget click the Add button.
    9. Choose the Catalog Image Grid widget and complete the settings as in the table below:
    10. # Option Name Value
      1. Status Enable
      2. AMP No
      3. Category select the store category with 6 subcategories in it.
      4. Title Catalog Image Grid (for internal reference only)
      5. Template Catalog Image Grid
      6. Use Image Thumbnail Image
      7. Category Images Enable
      8. Subcategory Images Disable
      9. Columns Count 3
      10. Count of Categories to Show 6
      11. Show "View More" Button Disable
    11. Then click on the Insert Widget button.
    12. Save the settings.

    Mega Menu for Mobile Version

    1. You need to add 2 rows and 6 columns with the column width set to col-4.
    2. Enter the mmenu_mobile in the Enter Specific Class option textfield of each column.
    3. Then add subcategory to each column.
    4. Remember to save the changes.

    Check the tutorials below:

    Template Settings

    Configuration of display static blocks/widgets on different layouts shown in the table below.

    Pages Configuration
    # Page Name Page HTML (Content tab) Page XML (Design tab) Layout
    1. Hookah sources\demo\pages\home.phtml NA 2 columns with left bar
    2. About Us sources\demo\pages\about-us.phtml NA 1 column
    3. Customer Service sources\demo\pages\customer-service.phtml NA 1 column
    4. Privacy Policy sources\demo\pages\privacy-policy-cookie-restriction-mode.phtml NA 1 column
    5. Shipping & Delivery sources\demo\pages\shipping-delivery.phtml NA 1 column
    6. FAQ sources\demo\pages\faq.phtml NA 1 column
    7. Support sources\demo\pages\support.phtml NA 1 column
    8. Guarantee sources\demo\pages\guarantee.phtml NA 1 column
    9. Secure Payment sources\demo\pages\secure-payment.phtml NA 1 column
    10. Terms & Conditions sources\demo\pages\terms-conditions.phtml NA 1 column
    11. 404 Not Found sources\demo\pages\no-route.phtml NA 1 column
    12. Template Settings sources\demo\pages\template-settings.phtml NA 1 column
    13. Enable Cookies sources\demo\pages\enable-cookies.phtml NA 1 column
    Static Blocks Configuration
    # Block Name Identifier Content
    1. Footer column content 2 footer_col_2 sources\demo\blocks\footer_col_2.phtml
    2. Footer column content 3 footer_col_3 sources\demo\blocks\footer_col_3.phtml
    3. Footer column content 4 footer_col_4 sources\demo\blocks\footer_col_4.phtml
    4. Footer column content 1 footer_col_1 sources\demo\blocks\footer_col_1.phtml
    5. Store Info store_info sources\demo\blocks\store_info.phtml
    6. Banners 1 banners_1 sources\demo\blocks\banners_1.phtml
    7. Banners 2 banners_2 sources\demo\blocks\banners_2.phtml
    8. Banners 3 banners_3 sources\demo\blocks\banners_3.phtml
    9. Banners 4 banners_4 sources\demo\blocks\banners_4.phtml
    10. Info Banners info_banners sources\demo\blocks\info_banners.phtml
    Widgets Configuration
    # Widget Name Widget Type Block Reference Template / (Static Blocks) Sort Order
    1. Featured Products Featured products Main Content Area Products Grid / Custom Products 4
    2. Latest News Blog Latest Posts Main Content Area Post Grid / Custom Blog Posts 2
    3. Banners 1 CMS Static Block Main Content Area Banner Box CMS Static Block 1
    4. Banners 2 CMS Static Block Main Content Area Banner Box CMS Static Block 2
    5. Banners 3 CMS Static Block Main Content Area Banner Box CMS Static Block 3
    6. Banners 4 CMS Static Block Sidebar Main Banner Box CMS Static Block 3
    7. Best Sellers Featured products Sidebar Main Products Grid / Custom Products 0