Waybiller Documentation

Magento theme installation

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:

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

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:

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

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.

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

Activate the new theme

Reindex data

1. Open Magento admin panel and navigate to System > Index Management menu.

   

2. In the fist column open the drop-down list and choose the "Select All" option.

   

3. In the top "Actions" selector choose "Update on save" option. It will allow automatically reindex the specified data after saving any settings in the admin panel.

   

4. Click "Submit" button.
5. Please be patient, this may take a while.

Static blocks configuration

To configure static blocks, you need to copy the code from the source files and paste it to the corresponding fields in the Magento admin panel. 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.

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 Pages Configuration 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.

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.

   

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.

Widgets Configuration

CMS Static Block widget type configuration

Banner 1 widget

Create the Banner 1 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 theat the template configuration table.
4. Open the sources\demo\blocks\banner-container-1.phtml file and copy the HTML code into the content area.
5. Save the settings.

Create the Banner 1 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.
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.

   

6. In the left sidebar click Widget Options tab and select the static block you are referring to (Banner 1). Don't forget to save changes.

   

How to change the Banner 1 widget text

To change the banner text 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 <span class="fl-left">XXX</span> <span class="fl-right"><i>XXX</i>XXX</span> Replace the XXX with the needed text.

Remember to save the settings.

How to change the Banner widget 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="{{store direct_url='XXX.html'}}" code. Replace the XXX with the needed page, category or product URL Key.

Remember to save the settings.

How to change the Banner widget image

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.

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-1_img-11.png'}}" alt="">).

Delete the code and press the Insert Image button. Upload the new banner image (click Browse) and press on the Insert File button.

Save the widget settings.

Featured Products widget

To set up the widget, navigate to the Content > Widgets section and press the Add widget button.

In the Storefront Properties section in the Type field, select Featured products. Press Continue.

Then, fill the other fields and specify the place, where you want to display the module in the Layout Updates section. Set Display on to Specified Page. Select CMS Home Page for the Page option. Choose the Main Content Area conteiner and Products Grid template.

To set up the widget, go to the Widget Options section on the left.

Set the widgets options as in the picture below.

Move to the Choose custom products option. Press the Select... button to choose the products to display within the widget.

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.

Create the testimonials block in footer

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.
4. Open the sources\demo\blocks\testimonials-block.phtml file and copy the HTML code into the content area.
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.

Slider settings

Content:

• 1. Main settings
• 2. First Slide settings
• 3. Second Slide settings
• 4. Add slider to the Home page

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

Image settings

Slides settings

Fade Animation settings

Auto Play settings

Controls settings

Responsive settings

Caption settings

Layers main settings

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.

Slider Items Settings

First Slide settings

Slide Information

Slide Images

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

Layer position settings

Layer animation settings

Layer-text-2

Layer text settings

Layer position settings

Layer animation settings

Layer-text-3

Layer text settings

Layer position settings

Layer animation settings

Second Slide settings

Slide Information

Slide Images

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

Layer position settings

Layer animation settings

Layer-text-2

Layer text settings

Layer position settings

Layer animation settings

Layer-text-3

Layer text settings

Layer position settings

Layer animation settings

Layer-text-4

Layer text settings

Layer position settings

Layer animation settings

Layer-text-5

Layer text settings

Layer position settings

Layer animation settings

Add slider to the Home page

To add slider to your Home page, navigate to Content > Widgets.

Open the Slider widget to edit (click the widget title).

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

Find the slider you've just created. Click on the slider title to add it to the widget.

Save the settings.

Parallax settings

Content:

• 1. General settings
• 2. Layer 1 settings
• 3. Layer 2 settings
• 4. Add parallax block to the Home page

To add and configure parallax block, navigate to TEMPLATE MONSTER > Parallax Block.

You'll see the "Add new item" button with the help of which you can add a new parallax block and a list of existing blocks.

While creating or editing a parallax block, two tabs become available. They are General Settings & Parallax Block Item.

General settings

Parallax Block Items

In this section, you can see the "Add item" button that is needed for adding a new layer, with the parallax or not. This button appears after a new parallax block creating only (once you click on the "Save block" or "Save and Continue edit" button).

While creating or editing a layer you might deal with the following settings:

Layer 1

General Settings

Item 2

General Settings

Add parallax block to the Home page

To display your parallax block on website you need to follow along with these several steps:

1. Go to Content > Widgets > Add Widget.

2. Select the Parallax block and your Design theme.

3. Click "Continue" button. Choose Store view in a Store front Properties tab, enter the Widget title and Order number.

4. Then you need to choose specific place to display the block.

5. Go to Widget Options tab and select your parallax block.