Start chat

Amalgam Documentation

Magento Theme Installation

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

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:

Attention! Please DO NOT import sample data if you have a live website as it will completely replace your database content, and all your website data will be LOST.

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.

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

Check the tutorial on how to Activate the New Magento 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\top_banner_1.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 or in the Template Settings section.

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
# Page Name Page HTML (Content tab) Page XML (Design tab) Layout
1. 404 Not Found sources\demo\pages\no-route.phtml NA 1 column
2. Home Page sources\demo\pages\home.phtml sources\demo\pages\home.xml 1 column
3. Enable Cookies sources\demo\pages\enable-cookies.phtml NA 1 column
4. Privacy Policy sources\demo\pages\privacy-policy-cookie-restriction-mode.phtml NA 1 column
5. Customer Service sources\demo\pages\customer_service.phtml NA 1 column
6. About Us sources\demo\pages\about_us.phtml NA 1 column
7. Template Settings sources\demo\pages\template-settings.phtml NA 1 column
8. Shipping & Delivery sources\demo\pages\shipping-delivery.phtml NA 1 column
9. FAQ sources\demo\pages\faq.phtml NA 1 column
10. Support sources\demo\pages\support.phtml NA 1 column
11. Guarantee sources\demo\pages\guarantee.phtml NA 1 column
12. Secure Payment sources\demo\pages\secure-payment.phtml NA 1 column
13. Terms & Conditions sources\demo\pages\terms-conditions.phtml NA 1 column
14. Home Page (layout 2) sources\demo\pages\home-2.phtml sources\demo\pages\home-2.xml 2 columns with right bar
15. Home Page (layout 3) sources\demo\pages\home-3.phtml sources\demo\pages\home-3.xml 1 column
Static Blocks Configuration
# Block Name Block Title Identifier Content
1. Header Top Block Header Top Block header_top_block sources\demo\blocks\header_top_block.phtml
2. Header Info Header Info header_info_block sources\demo\blocks\header_info_block.phtml
3. Menu Banner Menu Banner menu_banner sources\demo\blocks\menu_banner.phtml
4. Top Banner 1 Top Banner 1 top_banner_1 sources\demo\blocks\top_banner_1.phtml
5. Top Banner 2 Top Banner 2 top_banner_2 sources\demo\blocks\top_banner_2.phtml
6. Top Banner 3 Top Banner 3 top_banner_3 sources\demo\blocks\top_banner_3.phtml
7. Home Banners 1 Home Banners 1 home_banners_1 sources\demo\blocks\home_banners_1.phtml
8. Home Banners 2 Home Banners 2 home_banners_2 sources\demo\blocks\home_banners_2.phtml
9. Home Banners 3 Home Banners 3 home_banners_3 sources\demo\blocks\home_banners_3.phtml
10. Home Banners 4 Home Banners 4 home_banners_4 sources\demo\blocks\home_banners_4.phtml
11. Banner 1 Banner 1 banner_1 sources\demo\blocks\banner_1.phtml
12. Banner 2 Banner 2 banner_2 sources\demo\blocks\banner_2.phtml
13. Banner 3 Banner 3 banner_3 sources\demo\blocks\banner_3.phtml
14. Sidebar Banners Sidebar Banners sidebar_banners sources\demo\blocks\sidebar_banners.phtml
15. Categories List Categories List categories_list sources\demo\blocks\categories_list.phtml
16. Footer Column 1 Title Footer Column 1 Title footer_col_1_title sources\demo\blocks\footer_col_1_title.phtml
17. Footer Column Content 1 Footer Column Content 1 footer_col_1 sources\demo\blocks\footer_col_1.phtml
18. Footer Column Content 2 Footer Column Content 2 footer_col_2 sources\demo\blocks\footer_col_2.phtml
19. Footer Column Content 3 Footer Column Content 3 footer_col_3 sources\demo\blocks\footer_col_3.phtml
20. Footer Column Content 4 Footer Column Content 4 footer_col_4 sources\demo\blocks\footer_col_4.phtml
21. Contact Us Info Contact Us Info contact_us_info sources\demo\blocks\contact_us_info.phtml
Widgets Configuration
# Widget Name Widget Type Block Reference Template / (Static Blocks) Sort Order
1. Top Banner 1 Layout 1 CMS Static Block Main Content Area Top Banner 1 CMS Static Block 0
2. Top Banner 2 Layout 2 CMS Static Block After Page Header Top Banner 2 CMS Static Block 0
3. Top Banner 3 Layout 3 CMS Static Block Page Header Additional Top Banner 3 CMS Static Block 0
4. Products List 1 Layout 1 Catalog Products List Main Content Area Products Grid 1
5. Home Banners 1 Layout 1 CMS Static Block Main Content Area Home Banners 1 CMS Static Block 2
6. New Products Layout 1 Catalog New Products List Main Content Area New Products Grid 3
7. Home Banners 2 Layout 1 CMS Static Block Main Content Area Home Banners 2 CMS Static Block 4
8. Products List 2 Layout 1 Catalog Products List Main Content Area Products Grid 5
9. Home Banners 3 Layout 1 CMS Static Block Main Content Area Home Banners 3 CMS Static Block 6
10. Bottom Products 1 Layout 1 Catalog Products List Main Content Bottom Products Grid 0
11. Bottom Products 2 Layout 1 Catalog Products List Main Content Bottom Products Grid 1
12. Bottom Products 3 Layout 1 Catalog Products List Main Content Bottom Products Grid 2
13. Products List 3 Layout 2 Layout 3 Catalog Products List Main Content Area Products Grid 0
14. Products List 4 Layout 2 Catalog Products List Main Content Area Products Grid 1
15. Home Banner 1 Layout 2 CMS Static Block Main Content Area Banner 1 CMS Static Block 2
16. Products List 5 Layout 2 Layout 3 Catalog Products List Main Content Area Products Grid 3
17. Home Banner 2 Layout 2 CMS Static Block Main Content Area Banner 2 CMS Static Block 4
18. Products List 6 Layout 2 Layout 3 Catalog Products List Main Content Area Products Grid 6
19. Sidebar Banners Layout 2 CMS Static Block Sidebar Main Sidebar Banners CMS Static Block 0
20. Home Banner 3 Layout 3 CMS Static Block Main Content Area Banner 3 CMS Static Block 1
21. Categories List Layout 3 CMS Static Block Main Content Area Categories List CMS Static Block 2
22. Home Banners 4 Layout 3 CMS Static Block Main Content Area Home Banners 4 CMS Static Block 5
Header Layout 1
Header Layout 2
Header Layout 3
Footer Layout 1
Footer Layout 2
Footer Layout 2