Start chat

ZEMEZ © Privacy Policy

YangXin 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:

Content:

1. Backup Magento files

2. Disable the cache

3. Upload the app folder

4. Unzip the app folder

5. Run the console

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.

Content:

1. Pages Import

2. Static blocks Import

3. Widgets Import

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.

    CMS Static Block widget type configuration

    Banners widget
    1. To configure the Banners widget, navigate to Content > Widgets.
    2. Click the widget title to open the setting interface. (it's the Banners widget in our case)
    3. Navigate to Widgets Options tab. Press the Select Block button.
    4. Select the Banners static block for this widget. You can use the search field to simplify the process.
    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 Banner widget text
    1. To change the banner text go to the Content > Blocks section.
    2. Find the static block you want to change (it's the Banners block in our case).
    3. Select Edit from the Action option dropdown.
    4. Find the <span>XXX<br>XXX<br>XXX<br>XXX</span> code. Replace the XXX with the needed text.
    5. Remember to save the settings.
    E.g.You have the code:
    • <div class="bans-1_text-wrap">
    • <span class="bans-1_ban-1_md ban_txt-md">Fried Chicken<br>with capsicum</span>
    • <div class="bans-1_ban-1_price ban_txt_price">
    • <span>10</span>
    • <div class="span-wrap">
    • <span>%</span>
    • <span>OFF</span>
    • </div>
    • </div>
    • </div>
    • <a href="soups.html" class="bans_link bans_link_white">Shop Now</a>
    • </div>
    You can change the text which is between the angle brackets ( >text< ).

    How to change the banner's "SHOP NOW!" button 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 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.
    5. Find the <a href="XXX.html" code. Replace the XXX with the needed page, category or product URL Key.
    6. Remember to save the settings.
    How to change the Banners widget image

    Method 1

    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 block in our case).
    3. Select Edit from the Action option dropdown.
    4. You'll see the static block content field.
    5. Switch to HTML editor. In order to do this tap Show / Hide Editor.
    6. Select the code which is responsible for the image display:

      7. <img src="{{view url='images/ban-2.jpg'}}" alt="banner" class="bans-1_img bans_img">

    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'll get the code:

      <img src="{{media url="wysiwyg/new-image.jpg"}}" alt="" />

    9. Remember to specify the image class and atl text. You should get the code:

      10. <img src="{{media url="wysiwyg/new-image.jpg"}}" alt="banner" class="bans-1_img bans_img">

      *Use Reset button to return to the previous settings.

    10. Save the block settings.

    Method 2

    1. Navigate to your Magento root folder on your server.
    2. Then, go to the app/design/frontend/TemplateMonster/themeXXX/web/images folder.
    3. You should upload the new image, which has the same name, extension and size as the image you can see on the Theme Live-Demo to the images folder.

    The Banner, Product Banner widgets can be configured the same way.

    Featured Products widget type configuration

    Featured Products widget

    1. To configure the Featured Products(see the Template Settings table) widget, navigate to Content > Widgets.
    2. Click the widget title to open the setting interface. (the Featured Products in our case)
    3. Navigate to Widgets Options tab.
    4. Go to the Product types option > select Manual Products.
    5. Go to the Choose custom products option.
    6. Press the Select ... button. You need to select products you want to display within the widget.
    7. Navigate to the Widgets Options tab.
    8. Go to the Categories option. You need to select the custom product you want to display within the widget.
    9. Enter the title for the widget in the Manual Products title option field.
    10. Then click on the Labels tab. Specify the label text in the Manual Products label option field.
    11. Save the settings.

    The Lunch Specials widget can be configured the same way.

    How change the Additional information Font Icon
    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.
    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 Additional information block text

    1. Navigate to your Magento store admin panel. Then go to the Content > Blocks section.
    2. Find the Additional information 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.
    4. 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.

    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.608
    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 10000
    3. Auto Play Direction Normal
    4. Auto Play On Hover Pause

    Controls settings

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

    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 1920

    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 1
    2. Status Enable

    Slide Images

    # Option Name Option Value
    1. Image slider-1.jpg. You can find the image under the sourses\pub\media\wysiwyg 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 (Order online...)

    Layer text settings

    # Option Name Option Value
    1. Layer text/html <strong> Order online now our meal deal! </strong> <span> 2 main dishes plus rice of your choice at only $9,90! </span>
    2. Text color #ffffff
    3. Font family 'Montserrat', sans-serif

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 4.8%
    2. Vertical Position 24.6%
    3. CSS Class slider-1_slide-1_txt slider_txt

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Bottom Left
    2. Show Transition Left
    3. Show Offset 200
    4. Show Duration 500
    5. Show Delay 200
    6. Hide Transition Right
    7. Hide Duration 300
    8. Hide Offset 500
    Layer-text-2 (Learn More)

    Layer text settings

    # Option Name Option Value
    1. Layer text/html <a href="side-dishes.html" class="slider-link">Learn More</a>
    2. Font family 'Montserrat', sans-serif

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 5%
    2. Vertical Position 14%
    3. CSS Class slider-1_slide-1_link slider-link_wrap

    Layer animation settings

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

    Second Slide settings

    Slide Information

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

    Slide Images

    # Option Name Option Value
    1. Image slider-2.jpg. You can find the image under the sourses\pub\media\wysiwyg 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 (Authentic, DELICIOUS...)

    Layer text settings

    # Option Name Option Value
    1. Layer text/html <strong> Authentic, DELICIOUS Chinese food </strong> <span> We have two locations to serve you! </span>
    2. Text color #ffffff
    3. Font family 'Montserrat', sans-serif

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 4.8%
    2. Vertical Position 24.6%
    3. CSS Class slider-1_slide-1_txt slider_txt

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Bottom Left
    2. Show Transition Left
    3. Show Offset 200
    4. Show Duration 500
    5. Show Delay 200
    6. Hide Transition Right
    7. Hide Duration 300
    8. Hide Offset 500
    Layer-text-2 (Learn More)

    Layer text settings

    # Option Name Option Value
    1. Layer text/html <a href="side-dishes.html" class="slider-link">Learn More</a>
    2. Font family 'Montserrat', sans-serif

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 5%
    2. Vertical Position 14%
    3. CSS Class slider-1_slide-1_link slider-link_wrap

    Layer animation settings

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

    Third Slide settings

    Slide Information

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

    Slide Images

    # Option Name Option Value
    1. Image slider-3.jpg. You can find the image under the sourses\pub\media\wysiwyg 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 (10% Discount on...)

    Layer text settings

    # Option Name Option Value
    1. Layer text/html <strong> 10% Discount on lunch orders </strong> <span> between 12pm - 4pm (excluded sushi and drinks) </span>
    2. Text color #ffffff
    3. Font family 'Montserrat', sans-serif

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 4.8%
    2. Vertical Position 24.6%
    3. CSS Class slider-1_slide-1_txt slider_txt

    Layer animation settings

    # Option Name Option Value
    1. Layer Position Bottom Left
    2. Show Transition Left
    3. Show Offset 200
    4. Show Duration 500
    5. Show Delay 200
    6. Hide Transition Right
    7. Hide Duration 300
    8. Hide Offset 500
    Layer-text-2 (Learn More)

    Layer text settings

    # Option Name Option Value
    1. Layer text/html <a href="side-dishes.html" class="slider-link">Learn More</a>
    2. Font family 'Montserrat', sans-serif

    Layer position settings

    # Option Name Option Value
    1. Horizontal Position 5%
    2. Vertical Position 14%
    3. CSS Class slider-1_slide-1_link slider-link_wrap

    Layer animation settings

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

    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 sources\demo\pages\about_us.xml 1 column
    3. Customer Service sources\demo\pages\customer_service.phtml NA 1 column
    4. Privacy Policy sources\demo\pages\privacy_policy.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
    Static blocks configuration
    # Block Name Block Title Identifier Content
    1. Footer column content 1 Footer column content 1 footer_col_1 sources\demo\blocks\footer_col_1.phtml
    2. Footer column content 2 Footer column content 2 footer_col_2 sources\demo\blocks\footer_col_2.phtml
    3. Footer column content 3 Footer column content 3 footer_col_3 sources\demo\blocks\footer_col_3.phtml
    4. Footer column 1 title Footer column 1 title footer_col_1_title sources\demo\blocks\footer_col_1_title.phtml
    5. Mega menu banner Mega menu banner mm_ban sources\demo\blocks\mm_ban.phtml
    6. Banners Banners banners sources\demo\blocks\banners.phtml
    7. Banner Banner banner sources\demo\blocks\banner.phtml
    8. Additional information Additional information add_info sources\demo\blocks\add_info.phtml
    9. Payment Payment payment_1 sources\demo\blocks\payment_1.phtml
    10. Product Banner Product Banner product_banner sources\demo\blocks\product_banner.phtml
    11. Mega menu column 1 Mega menu column 1 mega_menu_col_1 sources\demo\blocks\mega_menu_col_1.phtml
    12. Mega menu column 2 Mega menu column 2 mega_menu_col_2 sources\demo\blocks\mega_menu_col_2.phtml
    13. Mega menu column 3 Mega menu column 3 mega_menu_col_3 sources\demo\blocks\mega_menu_col_3.phtml
    Widgets configuration
    # Widget Name Widget Type Block Reference Template / (Static Blocks) Sort Order
    1. Slider 1 Template Monster FilmSlider After Page Header N/A 0
    2. Banners CMS Static Block Main Content Area Banners 1
    3. Featured Products Featured products Main Content Area Products Grid 0
    4. Lunch Specials Featured products Main Content Area Products Grid 2
    5. Banner CMS Static Block Main Content Area Banner 1
    6. Product Banner CMS Static Block Before Page Footer Container Product Banner 0
    7. Latest post Blog Latest Posts Before Page Footer Container Post grid 1