Start chat

Fashi Documentation

Magento Theme Installation

This theme is not compatible with Magento 1.9 engine. It will work with the Magento 2.2.2 engine only.

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.

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.

Logo configuration

Please follow these steps when setting up logo image included into the theme package (you can view it on the Live Demo page).

  1. Open the Magento admin panel and select Content > Configuration in the side menu.
  2. In the list of stores you need click edit at Global-Main Website. Also, you can click edit for a particular store view if you have them.
  3. Select the "Header" tab, and upload your logo.
  4. Click "Save Config" button.

Static Blocks Configuration

When you are done with the pages configuring, you need to configure the static blocks. The procedure is similar: you need to copy the code from the source files and paste it to the corresponding fields in the Magento admin panel. You need to use a similar table but for the static blocks.

Block ID may vary in your Magento installation. You can get correct block id from Content > Blocks section in Admin panel.

  1. In the top menu navigate to Content > Blocks.
  2. In the top right corner click the "Add New block" button to add a new static block.
  3. Specify the block name and identifier. You can get the block details from the table at the template configuration page (check the Template Settings part).
  4. Open the block source file and copy the HTML code into the content area.

NOTE: some templates do not contain any static blocks, so the table can be empty.

The source files with the static blocks code are stored in the "sources\demo\static_blocks\" folder of the template package.

For example, to display the banner section (see the Template Settings section) on the Home Page, you should first open the sources\demo\blocks\banner_box.phtml file. Copy the file source code.

Then add new CMS Static Block and paste the copied source code in the content area of the block.

Remember to save the block.

*See the tutorial on How to add CMS Static Block.

After that, you need to add new widget with the same settings you can find in the Template Settings table and select the static block you are referring to in the Widget Options tab.

How to display our blocks with static content?

  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the "Add Widget" button to add a new widget.
  3. Specify the widget type CMS Static Block and theme that you want to apply the widget to, then click Continue button.
  4. On the next page in the Widget Title field enter the name of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views which will display the widget. In the Layout Updates block click Add Layout Update button. In the Display On field you can select pages where widget will be displayed on. Depending on selected pages you will have opportunity to fill in the additional fields.
  5. In the left sidebar click Widget Options tab and select the static block you are referring to. Don't forget to save changes.

* Check the tutorial on How to add new Widget to the Page?

When you are done configuring store pages and blocks, your store is ready to go.

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

Banners Info

Create the banners_info block
  1. In the top menu navigate to Content > Blocks.
  2. In the top right corner click the Add New block button to add a new static block.
  3. Specify the block name and identifier. You can get the block details from the Template Settings table.
  4. Open the sources\demo\blocks\banners_info.phtml file and copy the HTML code into the CMS Static Block content area. See the tutorial on How to add CMS Static Block.
  5. Save the settings.
Create the banners_info widget
  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the Add Widget button to add a new widget.
  3. Set the widget type to CMS Static Block and select the theme that you want to apply the widget to, then click Continue button. See the tutorial on How to add new Widget.
  4. On the next page in the Widget Title field enter the name of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views where you want the widget displayed on. Set Sort Order to 5. Move to the Layout Updates section and click on the Add Layout Update button.
  5. In the Display On select Specified Page. Choose CMS Home Page for the Page option. Set Container option to Main Content Area. You can get the widget details from the Template Settings table.
  6. In the left sidebar click Widget Options tab and select the static block you are referring to (banners_info).
  7. Don't forget to save changes.
How to change the widget text?
  1. You also can change the block content.
  2. In order to do this, go to the Content > Blocks section.
  3. Find the Additional Information static block.
  4. Select Edit from the Action option dropdown.
  5. You will see CMS block settings interface.
  6. Now, you're able to edit the block content in the content field.
  7. Full HTML support is provided. (To activate HTML editor, press the Show / Hide Editor button. See the tutorial on How to enable the WYSIWYG editor.)
  8. You can change the text which is between the angle brackets ( >text< ).
  9. Remember to save the settings.

Banner Box

Create the banner_box block
  1. In the top menu navigate to Content > Blocks.
  2. In the top right corner click the Add New block button to add a new static block.
  3. Specify the block name and identifier. You can get the block details from the Template Settings table.
  4. Open the sources\demo\blocks\banner_box.phtml file and copy the HTML code into the CMS Static Block content area. See the tutorial on How to add CMS Static Block.
  5. Save the settings.
Create the banner_box widget
  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the Add Widget button to add a new widget.
  3. Set the widget type to CMS Static Block and select the theme that you want to apply the widget to, then click Continue button. See the tutorial on How to add new Widget.
  4. On the next page in the Widget Title field enter the name (banner_box) of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views where you want the widget displayed on. Set Sort Order to 2. Move to the Layout Updates section and click on the Add Layout Update button.
  5. In the Display On select Specified Page. Choose CMS Home Page for the Page option. Set Container option to Main Content Area. You can get the widget details from the Template Settings table.
  6. In the left sidebar click Widget Options tab and select the static block you are referring to (banner_ box).
  7. Don't forget to save changes.
How to change the Banner Box images?
  1. To change the banner link go to the Content > Blocks section.
  2. Find the static block you want to change (it's the banner_ box block in our case).
  3. Select Edit from the Action option dropdown.
  4. You'll see the banner content field. Select the code which is responsible for the image display (e.g. <img src="{{view url=''}}/images/media/banner-4.jpg"/>).
  5. Delete the code and press the Insert Image button. Upload the new banner image (click Browse) and press on the Insert File button. The new image should have the same dimensions as the one you want to replace.
  6. Save the widget settings.

Images:

  1. banner-1.jpg — 776 x 530 px
  2. banner-2.jpg — 328 x 265 px
  3. banner-3.jpg — 328 x 265 px
  4. banner-3.jpg — 655 x 265 px

You can find the images in the app\design\frontend\Zemez\themeXXX\web\images\media folder (XXX here is your theme number)

How to change banner_box 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 banner_box 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. (To activate HTML editor, press the Show / Hide Editor button. See the tutorial on How to enable the WYSIWYG editor.)
  5. Find the <a href="{{store url='XXX.html'}}"> code. Replace the XXX with the needed page or category URL Key.
  6. Remember to save the settings.

Banner Fullwidth

Create the banner_fullwidth block
  1. In the top menu navigate to Content > Blocks.
  2. In the top right corner click the Add New block button to add a new static block.
  3. Specify the block name and identifier. You can get the block details from the Template Settings table.
  4. Open the sources\demo\blocks\banner_fullwidth.phtml file and copy the HTML code into the CMS Static Block content area. See the tutorial on How to add CMS Static Block. Replace the XXX with the needed page or category URL Key.
  5. Save the settings.
Create the Banner Fullwidth widget
  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the Add Widget button to add a new widget.
  3. Set the widget type to CMS Static Block and select the theme that you want to apply the widget to, then click Continue button. See the tutorial on How to add new Widget.
  4. On the next page in the Widget Title field enter the name of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views where you want the widget displayed on. Set Sort Order to 4. Move to the Layout Updates section and click on the Add Layout Update button.
  5. In the Display On select Specified Page. Choose CMS Home Page for the Page option. Set Container option to Main Content Area. You can get the widget details from the Template Settings table.
  6. In the left sidebar click Widget Options tab and select the static block you are referring to (banner_fullwidth).
  7. Don't forget to save changes.
How to change the widget text?
  1. You also can change the block content.
  2. In order to do this, go to the Content > Blocks section.
  3. Find the Banner Fullwidth static block.
  4. Select Edit from the Action option dropdown.
  5. You will see CMS block settings interface.
  6. Now, you're able to edit the block content in the content field.
  7. Full HTML support is provided. (To activate HTML editor, press the Show / Hide Editor button. See the tutorial on How to enable the WYSIWYG editor.)
  8. You can change the text which is between the angle brackets ( >text< ).
  9. Remember to save the settings.

Shop by Brands

Note, you should first add some brands (with logo) to display and assign products to each brand.

Useful Tutorials:

  1. How to add a new Brand to your store?
  2. How to manage Shop By Brand module?
Create Shop by Brands Widget
  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the Add Widget button to add a new widget.
  3. Set the widget type to Shop by Brand and select the theme that you want to apply the widget to, then click Continue button. See the tutorial on How to add new Widget.
  4. On the next page in the Widget Title field enter the name of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views where you want the widget displayed on. Set Sort Order to 1. Move to the Layout Updates section and click on the Add Layout Update button.
  5. In the Display On select Specified Page. Choose CMS Home Page for the Page option. Set Container option to Main Content Area. You can find the widget details in the Template Settings table.
  6. Switch to the Widget Options tab and complete the widget settings as below:
    # Option Name Value
    1. Status Enable
    2. Brands Amount 8 (depends on the number of in-store brands)
    3. Carousel No
    5. Brands Logo Width 100
    6. Show Brand Title No
    7. Choose brands Select brands you want to show in the widget. To select multiple brands, hold down the Ctrl button.
  7. Don't forget to save changes.

Featured Products

Create Featured Products widget
  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the Add Widget button to add a new widget.
  3. Set the widget type to Featured Products and select the theme that you want to apply the widget to, then click Continue button. See the tutorial on How to add new Widget.
  4. On the next page in the Widget Title field enter the name of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views where you want the widget displayed on. Set Sort Order to 3. Move to the Layout Updates section and click on the Add Layout Update button.
  5. In the Display On select Specified Page. Choose CMS Home Page for the Page option. Set Container option to Main Content Area and choose Products Grid template for the widget. You can find the widget details in the Template Settings table.
  6. Switch to the Widget Options tab.
  7. Complete the widget settings as below:
    # Option Name Value
    General Tab:
    1. Status Enable
    2. Product Types Manual Products
    3. Products Title Featured Products. Move to the Choose custom products option and press the Select... button and choose the products you want to show in the widget, then tab Add Product. You should see the "Products selected" message.
    View Tab:
    1. Product Image Width 350
    2. Product Image Height 350
    3. Product Name length 30
    4. Products to Display 8
    5. Carousel No
    6. Number of products per row 4
    Labels Tab:
    1. Show Label No
    Banner Tab:
    1. Use Banner No
    Gallery Tab:
    1. Choose Hover Type Default
  8. Don't forget to save changes.
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.

Slider Settings

First you should create new slider.

Go to TemplateMonster > Sliders section.

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.

Then complete the settings as below:

General Setting

Main Settings

Enter the slider title (only for internal reference).

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

Image Settings

# Option Name Option Value
1. The aspect ratio 1.92
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 700

Auto Play Settings

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

Controls Settings

# Option Name Option Value
1. Arrows Enable
2. Fade Arrows Disable
3. Buttons Disable
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 7000

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 Slide button to add a new slide.

Add Slider Widget

  1. In the top menu navigate to Content > Widgets
  2. In the top right corner click the Add Widget button to add a new widget.
  3. Set the widget type to FilmSlider and select the theme that you want to apply the widget to (your new theme), then click Continue button.
  4. On the next page in the Widget Title field enter the name of the widget which will be displayed in the admin panel. In the Assign to Store Views field you need to select store views where you want the widget displayed on. Move to the Layout Updates section and click on the Add Layout Update button.
  5. In the Display On select Specified Page. Choose CMS Home Page for the Page option. Set Container option to After Page Header. You can get the widget details from the Template Settings table.
  6. In the left sidebar click Widget Options tab and select the slider you want to insert. Don't forget to save changes.

How to Set the MegaMenu

First you should create static block for the Mega Menu.

Add Static Block

  1. In the top menu navigate to Content > Blocks.
  2. In the top right corner click the Add New block button to add a new static block.
  3. Specify the block name and identifier. You can get the block details from the Template Settings table.
  4. Open the sources\demo\blocks\menu-banner.phtml file and copy the HTML code into the CMS Static Block content area. See the tutorial on How to add CMS Static Block. Replace the XXX with the needed page or category URL Key.
  5. Save the settings.

Image:

  1. menu-banner.jpg — 350 x 460 px (the image are stores under the app\design\frontend\Zemez\themeXXX\web\images\media folder)
Configure Mega Menu
  1. Go to Products > Categories. Select the any category you want to apply Mega Menu to.
  2. Expand the Megamenu tab.
  3. Enable Megamenu for this Category.
  4. You should add 1 row.
  5. Press the Add row button to add the row.
  6. Add 4 columns with the column width set to col-3 width.
  7. Click on the Add column(s) button > set the Column width class(2-12) to col-2(or col-8) > press the Add button .
  8. Now you need to add subcategories to first 3 columns.
  9. Move to the Add subcategory option and choose the subcategory among the list and press on the Add button. Note, each subcategory should have some more subcategories in it to keep the column-with-links view.
  10. On the next step you will see this category listed at the Selected items field.
  11. And finaly, add the static block to the 4th column.
  12. Move to the Select static block option and choose the MegaMenu Banner (the block you've created recently) static block among the list and press the Add button.
  13. Static block title will be listed in the Selected items field.

How to Change the Newsletter Text

Navigate to your Magento root folder on your server. Then, go to the app\design\frontend\Zemez\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.

* You can change the footer newsletter text with a help of "Translate Inline" tool.

Check the tutorials below:

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 (Fashi)

sources\demo\pages\home_page.phtml

sources\demo\pages\home_page.xml

1 column
2. Privacy Policy sources\demo\pages\privacy_policy.phtml NA 1 column
3. 404 Not Found sources\demo\pages\terms-conditions.phtml NA 1 column
Static blocks configuration
# Block Name Identifier Content
1. banners_info banners_info sources\demo\blocks\banners_info.phtml
2. banner_box banner_box sources\demo\blocks\banner_box.phtml
3. banner_fullwidth banner_fullwidth sources\demo\blocks\banner_fullwidth.phtml
4. AMP Footer Links amp_footer_links sources\demo\blocks\amp_footer_links.phtml
5 menu-banner menu-banner sources\demo\blocks\menu-banner.phtml
Widgets configuration
# Widget Name Widget Type Block Reference Template / (Static Blocks) Sort Order
1. Slider FilmSlider Main Content Area FilmSlider Block 1
2. Shop by Brands FilmSlider Main Content Area Custom brands + Logo 1
3. Banner_box CMS Static Block Main Content Area Banner Box Block 2
4. Featured Products CMS Static Block Main Content Area Featured products Block 3
5. Banner_fullwidth CMS Static Block Main Content Area Banner Fullwidth Block 4
6. Banners_info CMS Static Block Main Content Area Additional Information Block 5