Vini 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.

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

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

• Step 1. Backup Magento files
• Step 2. Disable the cache
• Step 3. Upload the app folder
• Step 4. Unzip the app folder
• Step 5. Run the console

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

Template Configuration

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

Activate the New Theme

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.

You can set the Logo via Theme Options extension.

* See the tutorial on How to upload the Logo.

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?

Template Settings

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

Pages Configuration

Static Blocks Configuration