Start chat

KETONDO Documentation

Magento theme installation

This theme is not compatible with Magento 1.9 engine. It will work with the Magento 2.1.7 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.

If you don't want to spend your time installing the theme, don't hesitate to order installation service using our live-chat.

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 contents, and all your website data will be LOST.

First of all, please make sure your Magento installation version meets the template requirements. 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.

Step 1. Backup Magento files
Backup Magento files and the store database.

Important: creating backup before installation of any themes or extensions in Magento is extremely important, especially if you are working on a live store.

On the Admin sidebar, tap System. Then under Tools, choose Backups.

In the upper-right corner, tap the button for the type of backup you want to create:

System Backup-
creates a complete backup of the database and the file system. During the process, you can choose to include the media folder in the backup.
Database and Media Backup- creates a backup of the database and the media folder.
Database Backup-
creates a backup of the database.

To put the store into maintenance mode during the backup, mark the checkbox. When the backup is complete, maintenance mode is turned off automatically.

For a system backup, mark the Exclude checkbox if you do NOT want to include the media folder. Then when prompted, confirm the action.(press OK)

The backaps files stored under the var > backups folder.

In case of Error 503 DELETE the maintenance.flag file from var folder.

Step 2. Disable the cache
Disable all cache systems which you have in your Magento.

Important: when developing your Magento store, in order to be able to see changes immediately, you should completely disable the cache. You can enable it after you finish configuring your store.

    On the Admin sidebar, tap System. Then under Tools, choose Cache Management.

    Choose Select All from the Mass Action dropdown.

    Then you need to select Disable from the Action dropdown and press the Submit button.

    Do not forget to enable the cache after the theme installation and configuration.

    Step 3. Upload the app folder

    Now you need to copy the zipped content of the theme folder (the app folder) to the root folder of your online shop.

    • theme
      contains Magento theme files and directories that should be uploaded to the root directory of your Magento installation .
      • app
    Find the theme > app folder. You need to archive (.zip) the app folder to upload it to the server. Use the WinZip 9+ (for Windows) or Stuffit Expander 10+ (for Mac) to compress the app folder.

    Log into cPanel > navigate to the Files section and click on the File Manager icon.

    Once you select your directory, click on the Go button.

    Open the root folder of your online store.

    Click on the Upload icon.

    Make sure you've set the correct permissions type for the app folder. The permissions should be CHMOD 755 or 777, depending on your server configuration.

    Click on the Browse button.

    Find the app.zip. Click Open.

    Once the process is completed press on the Go Back to link.

    Step 4. Unzip the app folder

    Select the uploaded zip file and click the Extract icon

    Make sure the right folder is indicated. Press the Extract File(s) button.

    Then press the Close button and Reload the File Manager page.

    You can delete the .zip folder after unzipping.

    Step 5. Run the console

    After unzipping run the console and navigate to the root directory of your store.

    Attention!!!

    Due to the peculiarities of the engine you will have to use any console environment with the command line. Module configuration will be mainly performed via the command line. If you perform changes on the hosting server, you can contact your hosting provider for help and use the hosting command line.
  1. Run the following commands in the command line, one by one:
    1. bin/magento setup:upgrade
    2. bin/magento index:reindex
    3. bin/magento cache:clean
  2. Then follow the instructions for setting up the theme.
We will show how configure your theme the same way as in our Live Demo template, without affecting your products data.

After the theme installation, no difference will appear on your site frontend.

Activate the new theme

Open Magento admin panel and navigate to the Content > Configuration menu.
In the list of stores click edit in the "Action" column against the Global-Main Website.

In the Default Theme section select the required theme in the Applied Theme option drop-down list and, then click Save Configuration button.

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

    Navigate to the Content > Pages section in the admin panel of you shop.

    Here you can find the list of all the store pages. The imported pages: Home page, About Us, Privacy and Cookie Policy, 404 Not Found, Enable Cookies should already be available.

    You need to make pages visible on your site. If you want pages be available on each store view, you need open each page settings. In order to do this, press the edit button.

    Navigate to the Page in Websites tab. Select All Store Views option.
    In case, you need to add a new page, click the "Add New Page" button in the top right corner.

    Remember to save the page.

    Widgets Configuration

    Due to the FilmSlider module complex structure, you can NOT import ones. To make widget appear on your website, you have to create a NEW FilmSlider * widgets.

    * See TM Extensions Settings > FilmSlider.

    CMS Static Block widget type configuration

    Banner 1 widget

    To configure the banner 1 widget, navigate to Content > Widgets.

    Click the widget title to open the setting interface.

    Navigate to Widgets Options tab. Press the Select Block button.

    Select the banners-1 static block (see the Template Settings table) for this widget. You can use the search field to simplify the process.

    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 banner link

    To change the banner link go to the Content > Blocks section.

    Find the static block you want to change (it's the banner 1 block in our case).

    Select Edit from the Action option dropdown.

    Find the <a href="XXX.html"> code. Replace the XXX with the needed page, category or URL Key.

    Remember to save the settings.

    How to change the banner 1 image

    Navigate to your Magento root folder on your server. Then, go to the app/design/frontend/TemplateMonster/themeXXX/web/images/media folder. (XXX — your theme number)

    You should upload the new banner image, which has the same name, extension and size as the image you can see on the Theme Live-Demo to the media folder. (e.g. banner-1_img-1.jpg)

    How to find out the banner image size and name

    To find the banner image size and name, open your store in the browser and right-click the banner image. Select Inspect Element in the context menu.

    A window with the html-code will appear. The code which is related to the image will be highlighted.

    Expand the <a href="your-page.html">...<a> section.

    There you will find the <img src="/.../pub/static/frontend/TemplateMonster/themeXXX/en_US/images/media/banner-1_img-1.jpg" alt="banner-img"> line. (XXX — your theme number)

    Hoover on the image path line and doubleclick it. Copy the image name and extension (e.g. banner-1_img-1.jpg).

    You also can see the picture dimensions when hoover on the <img scr link. A pop-up window with the image thumbnail and dimensions will appear (e.g. 870 x 421 px).

    Banner 1 images

    - banner-1_img-1.jpg (870 x 421 px)

    - banner-1_img-2.jpg (870 x 421 px)

    Banner 2 images

    banner-2_img-1.jpg (570 x 424 px)

    banner-2_img-2.jpg (570 x 424 px)

    banner-2_img-3.jpg (570 x 424 px)

    banner-2_img-4.jpg (570 x 424 px)

    banner-2_img-5.jpg (570 x 424 px)

    banner-2_img-6.jpg (570 x 424 px)

    Featured Products widget

    To configure the Featured Products (Product Grid) widget, navigate to Content > Widgets. Click the widget title to open the setting interface.

    Navigate to Widgets Options tab. Go to the Categories option. You need to select category you want to display within the widget.

    Save the settings.

    How to set the Main Menu

    Go to Products > Categories. Select the category.

    *Note the category should have 12 subcategories.

    Expand the Megamenu tab.

    Enable Megamenu for this Category.

    Enter with-border-grid into the Css class option field.

    You should add 2 rows. Press the Add row button to add the row.

    Then you need to add 6 columns to each row with Column width class set to 2.

    Click on the Add column(s) button > press the Add button .

    Now you need to add subcategory to each column.

    Move to the Add subcategory option. This option allows you to select and display the subcategories you need.

    In order to do this, choose the subcategory among the list and press on the Add button.

    On the next step you will see this category listed at the Selected items field.

    When complete, tap Save.

    How to set the thumbnail image for the subcategory

    Go to Products > Categories.

    Select the subcategory you want to display in the mainmenu dropdown.

    Navigate to the Megamenu tab.

    Upload the category Image image (click upload; image size — 220x220 px).

    Remember to save the settings.

    How to change the AboutUs text

    Navigate to your Magento store admin panel. Then go to the Content > Blocks section.

    Find the AboutUs block and open it to edit. 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 newsletter text

    Navigate to your Magento root folder on your server. Then, go to the app\design\frontend\TemplateMonster\themeXXX\Magento_Newsletter\templates folder. (XXX — your theme number)

    Open the subscribe.phtml file. Enter the text you want to display within the newsletter block (replacing the old one). Remember to save the file.

    *The text displayed within the newsletter block (e.g. Sign Up for Our Newsletter; Enter your email address) will always be after the echo __(' code part.

    How change the Offers widget Font Icon

    Navigate to your Magento store admin panel. Then go to the Content > Blocks section.

    Find the banners-3 block and open it to edit. Select Edit from the Action option dropdown.

    You will see CMS block settings interface.

    Find the <i class="fa fa-handshake-o" aria-hidden="true"></i> line and replace fa fa-handshake-o with a new icon class.)

    Remember to save the settings.

    You can find the font icon css class here.
    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.

    Check the tutorials below:

    Slider settings

    Content:

    To add new slider click Add New Slider button in the top right corner.
    On the slider configuration screen in General Options section you can see all available slider settings. Slider Items section allows you to add slides to your slider.

    General Settings

    Main settings

    # Option Name Option Value
    1. Status Enable
    2. Slide width 100%
    3. Slide height 500

    Image settings

    # Option Name Option Value
    1. The aspect ratio 2.36
    2. Image Scale Mode Cover
    3. Allow Scale Up Enable
    4. Auto Height Disable
    5. Center Image Enable
    6. Orientation Horizontal
    7. Force Size None

    Slides settings

    # Option Name Option Value
    1. Slide Animation Duration 700
    2. Height Animation Duration 700
    3. Visible Size auto
    4. Start Slide 0
    5. Shuffle Disable
    6. Loop Enable

    Fade Animation settings

    # Option Name Option Value
    1. Fade Disable
    2. Fade Out Previous Slide Enable
    3. Fade Duration 500

    Auto Play settings

    # Option Name Option Value
    1. Auto Play Enable
    2. Auto Play Delay 5000
    3. Auto Play Direction Normal
    4. Auto Play On Hover Pause

    Controls settings

    # Option Name Option Value
    1. Arrows Disable
    2. Fade Arrows Enable
    3. Buttons Enable
    4. Keyboard Enable
    5. Full Screen Disable
    6. Fade Full Screen Enable

    Responsive settings

    # Option Name Option Value
    1. Responsive Enable
    2. Touch Swipe Enable
    3. Touch Swipe Threshold 50
    4. Small Size 480
    5. Medium Size 758
    6. Large Size 1024

    Caption settings

    # Option Name Option Value
    1. Fade Caption Enable
    2. Caption Fade Duration 5000

    Layers main settings

    # Option Name Option Value
    1. Wait For Layers Disable
    2. Auto Scale Layers Enable
    3. Auto Scale Reference 1000

    You can add new slides only after saving the slider. Click Save and Continue Edit button in the top right corner. When the slider is saved, switch to Slider Items tab.

    Click Add Slider Item to add a new slide.

    Slider Items Settings
    First Slide settings

    Slide Information

    # Option Name Option Value
    1. Slide title Slide 01
    2. Status Enable

    Slide Images

    # Option Name Option Value
    1. Image slide-01.jpg. You can find the image under the sourses\pub\media\wysiwyg\slider folder.

    Layers list

    Layers list section allows you to add layers to your slide. You can add image layers and text layers. Use corresponding buttons to add layers.

    By clicking on Add layer image you'll see an image library where you can select from available images or upload images from your computer. By clicking Add layer text, you'll see new text layer added and layer settings became associated with your new particular layer.

    Layer-text-1

    Layer text settings

    # Option Name Option Value
    1. Layer text/html Home & Office Machines
    2. Layer Width 1770
    3. Text color #ffffff
    4. Font size 150
    5. Line height 150
    6. Font style Normal
    7. Font weight 700
    8. Font family 'PT Sans', sans-serif;

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 0
    2. Vertical Position 140
    3. CSS Class ta-center

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Buttom Left
    2. Show Transition Up
    3. Show Offset 200
    4. Show Duration 250
    5. Show Delay 200
    6. Hide Transition Down
    7. Hide Duration 200
    8. Hide Offset 200
    9. Hide Delay 200
    Second Slide settings

    Slide Information

    # Option Name Option Value
    1. Slide title Slide 02
    2. Status Enable

    Slide Images

    # Option Name Option Value
    1. Image slide-02.jpg. You can find the image under the sourses\pub\media\wysiwyg\slider folder.

    Layers list

    Layers list section allows you to add layers to your slide. You can add image layers and text layers. Use corresponding buttons to add layers.

    By clicking on Add layer image you'll see an image library where you can select from available images or upload images from your computer. By clicking Add layer text, you'll see new text layer added and layer settings became associated with your new particular layer.

    Layer-text-1

    Layer text settings

    # Option Name Option Value
    1. Layer text/html Office Stationery
    2. Layer Width 1770
    3. Text color #ffffff
    4. Font size 150
    5. Line height 150
    6. Font style Normal
    7. Font weight 700
    8. Font family 'PT Sans', sans-serif;

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 0
    2. Vertical Position 140
    3. CSS Class ta-center

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Center Left
    2. Show Transition Up
    3. Show Offset 200
    4. Show Duration 250
    5. Show Delay 200
    6. Hide Transition Down
    7. Hide Duration 200
    8. Hide Offset 200
    9. Hide Delay 200
    Third Slide settings

    Slide Information

    # Option Name Option Value
    1. Slide title Slide 03
    2. Status Enable

    Slide Images

    # Option Name Option Value
    1. Image slide-03.jpg. You can find the image under the sourses\pub\media\wysiwyg\slider folder.

    Layers list

    Layers list section allows you to add layers to your slide. You can add image layers and text layers. Use corresponding buttons to add layers.

    By clicking on Add layer image you'll see an image library where you can select from available images or upload images from your computer. By clicking Add layer text, you'll see new text layer added and layer settings became associated with your new particular layer.

    Layers list

    Layers list section allows you to add layers to your slide. You can add image layers and text layers. Use corresponding buttons to add layers.

    By clicking on Add layer image you'll see an image library where you can select from available images or upload images from your computer. By clicking Add layer text, you'll see new text layer added and layer settings became associated with your new particular layer.

    Layer-text-1

    Layer text settings

    # Option Name Option Value
    1. Layer text/html Office Chairs & Seatings
    2. Layer Width 1770
    3. Text color #000000
    4. Font size 150
    5. Line height 150
    6. Font style Normal
    7. Font weight 700
    8. Font family 'PT Sans', sans-serif;

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 0
    2. Vertical Position 140
    3. CSS Class ta-center

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Bottom Left
    2. Show Transition Up
    3. Show Offset 200
    4. Show Duration 250
    5. Show Delay 200
    6. Hide Transition Down
    7. Hide Duration 200
    8. Hide Offset 200
    9. Hide Delay 200
    Fourth Slide settings

    Slide Information

    # Option Name Option Value
    1. Slide title Slide 04
    2. Status Enable

    Slide Images

    # Option Name Option Value
    1. Image slide-04.jpg. You can find the image under the sourses\pub\media\wysiwyg\slider folder.

    Layers list

    Layers list section allows you to add layers to your slide. You can add image layers and text layers. Use corresponding buttons to add layers.

    By clicking on Add layer image you'll see an image library where you can select from available images or upload images from your computer. By clicking Add layer text, you'll see new text layer added and layer settings became associated with your new particular layer.

    Layer-text-1

    Layer text settings

    # Option Name Option Value
    1. Layer text/html Printing Supplies
    2. Layer Width 1770
    3. Text color #000000
    4. Font size 150
    5. Line height 150
    6. Font style Normal
    7. Font weight 700
    8. Font family 'PT Sans', sans-serif;

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 0
    2. Vertical Position 140
    3. CSS Class ta-center

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Bottom Left
    2. Show Transition Right
    3. Show Offset 200
    4. Show Duration 250
    5. Show Delay 200
    6. Hide Transition Down
    7. Hide Duration 200
    8. Hide Offset 200
    9. Hide Delay 200

    Template Settings

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

    Home page configuration
    # Page Name Page HTML [Content tab] Page XML [Design tab] Layout
    1. Home Page sources\demo\pages\home_page.phtml sources\demo\pages\home_page.xml 1 column
    2. About Us sources\demo\pages\about_us.phtml N/A 1 column
    3. Privacy Policy sources\demo\pages\privacy_policy.phtml N/A 1 column
    4. Customer Service sources\demo\pages\customer_service.phtml N/A 1 column
    Static blocks configuration
    # Block Name Block Identifer Content
    1. Footer column content 1 footer_col_1 sources\demo\blocks\footer_col_1.phtml
    2. Footer column content 2 footer_col_2 sources\demo\blocks\footer_col_2.phtml
    3. Footer column content 3 footer_col_3 sources\demo\blocks\footer_col_3.phtml
    4. AboutUs footer_col_0 sources\demo\blocks\footer_col_0.phtml
    5. banner 1 banner-1 sources\demo\blocks\banner-1.phtml
    6. banner 2 banner-2 sources\demo\blocks\banner-2.phtml
    7. Offers offers sources\demo\blocks\offers.phtml
    8. Payment payment sources\demo\blocks\payment.phtml
    9. add_header_info add_header_info sources\demo\blocks\ add_header_info.phtml
    Widgets configuration
    Widget Name Widget type Content/ Template
    banner 1 CMS Static Block banner 1 block
    Featured Products Featured Products Custom products/ Products Grid
    banners-3 CMS Static Block banner-3 block
    Slider FilmSlider custom Slider
    Offers CMS Static Block offers block