Histore Magento Theme Documentation for Magento 2 CE

Getting Started

Welcome to Histore Magento 2 Theme!

Firstly, a huge thanks for purchasing this theme, your support is truly appreciated!

This document covers the installation and use of this theme, reveals some answers to common problems and issues. We encourage you to read throughout this document if you are experiencing any difficulties. If you have any questions that are beyond the scope of document, please feel free to contact us via our Support Tickets System

Compatible with Magento

Histore Magento Theme is fully compatible with Magento Community Edition version 2.1.x, 2.2.x, 2.3.x.

Magento Information

To install this theme you must have a working version of Magento already installed. If you need help installing Magento, follow below sites and tutorials from magento.com, hope everything that you need are there.

System Requirements - Required system credentials for your magento installation.
Installation Guide - Installation guide that describes how to install magento2.
Online Magento 2 guide - Online magento documentation that describes about magento2 in detail.
Magento Forum - Magento forum site.
stackoverflow.com - You can also get some useful articles from stackoverflow.

Installation

Prepare Installation

There are two ways to install a Magento Theme:

Quickstart Installation: Suitable if you have your first installation and want to get a whole new fresh site as our Demo.
Manual Installation (including Theme Installation): Suitable if your store is full with content that you don't want to overwrite.

Quickstart Installation

Magentech provides SM Quickstart package for each theme which aims to ease the installation for users. If you plan to start your site from the beginning, it will help you save much time of installing and configuring.

Please follow steps below:

Step 1: Download the quickstart package named as sm_histore_quickstart_pl_m2.3.5_v1.7.0
Step 2: Extract and Upload the whole Quickstart package to your server. In Quickstart folder you will see the extracted folder that include all sample data
Step 3: Create a Database for your Magento site

Important!
You need to remember the database name to use in the next steps
Step 4: Import database sample_data.sql under the folder sm_histore_quickstart_pl_m2.3.5_v1.7.0\data_quickstart
Note: You can import database by run this command mysql -u root -p database_name < sample_data.sql

Important!
Sometimes your site is broken, after run this command, it's because of you ran this command with the incorrect user. If your site was broken, it's very important to set the file's permissions and ownership correctly, after run this command line. You can refer this command chown -R <owner>:<group> <magento root directory path>.
Typical examples:
chown -R apache:apache /var/www/html/magento2/histore
chown -R www-data:www-data /home/domain/public_html
And also please refer this, http://devdocs.magento.com/guides/v2.0/install-gde/prereq/integrator_install.html
Step 5: Run installation process by opening browser and navigate to your URL.
Step 6: Choose Start Readiness Check. After Start Readiness Check is completed, select Next .
When you click on "Start Readiness Check",the error could occur like the below image

You need to open your php.ini file and remove semicolon (;) in front of the following lines:
With window:

;extension=php_intl.dll

;extension=php_xsl.dll
With linux:
;extension=php_intl.os

;extension=php_xsl.os
After modification, need to save the file(php.ini) as well as need to restart the Apache Server and check out the result.
Step 7: Enter server and database in step 2 and then click on Next.
Step 8: Put your website link and continue to click on Next.
Step 9: Customize your store: you can choose Time Zone, Currency and Languages.
Step 10: You need to Create Admin Account. Enter your information and move to the next step.
Step 11: In this step, you should click on the button: Install Now.

It will take some minutes to complete this installation process. If your window is the same as below, CONGRAT! You install this quickstart package successfully

After clicking on the button, the Admin Login screen will be opened and you can use admin credentials to login on this screen. It will open Admin panel after successful authentication.

Manual Installation

Important!

- We recommend you to duplicate your live store on a development store and try installation on it in advance.

- Backup magento files and the store database.

It's very important to backup all of themes and extensions in Magento before installation, especially when you are working on a live server. We strongly recommend you to do not omit this step.

Step 1: Please unzip 'sm_histore_theme_m2.1.x-2.3.x_v1.7.0' file and upload folders app & pub from the theme package to the root of your magento site folder on your server.
Step 2: Disable all cache related section that you have in your magento.
Step 3: Active SM Extensions, open command line in folder root of magento and run commands via ssh using putty or others, php bin/magento setup:upgrade

Important!
Sometimes your site is broken, after run this command, it's because of you ran this command with the incorrect user. If your site was broken, it's very important to set the file's permissions and ownership correctly, after run this command line. You can refer this command chown -R <owner>:<group> <magento root directory path>.
Typical examples:
chown -R apache:apache /var/www/html/magento2/histore
chown -R www-data:www-data /home/domain/public_html
And also please refer this, http://devdocs.magento.com/guides/v2.0/install-gde/prereq/integrator_install.html
Step 4: Select "SM Histore" theme in Content > Design > Configuration > Edit Default Store > Select "SM Histore" theme.
Step 5: Click "Save Configuarion" button to save your changes.

We have created One Click Installation for users to quickly set up your theme the same way our demo is set up.

In order to do demo installation, you should import Static Blocks, CMS Pages and Demo in Stores>> Settings>> Configuration >> MAGENTECH.COM >> SM Histore >> Theme Installation.

1. Press the buttons named 'Static CMS Blocks' and 'Pages' to import all default blocks and pages.

2. Click "Demo X" button to install demo version that you prefer to install.

3. Please remember that: If you have imported these Static Blocks, Pages successfully, you would have all blocks and pages provided with this theme and you do not need to create any static blocks or pages manually as the following instruction of this document.

4. Flush Cache: After successfully import your demo, save Theme Settings and Design Settings and clear the cache by using this command as php bin/magento cache:flush in Command Prompt. Or you could go to System >> Tools >> Cache Management, click 'Flush Cache Storage' button to flush all the cache.

Layout Position

Position Home page

Home Style 1

Home Style 2

Home Style 3

Homepage Configuration

Set Default Page

To configure the default home page for your store, please go to Stores>> Settings >>Configuration>>General>>Web>>Default Pages tab, select the desired page in the CMS Home Page field and save configuration.

You need to change to the website / store view that you want to change (the dropdown menu in the upper left corner). You will probably have to create a new CMS page if you want to have something different from your default home page.

Edit Homepage

From the top menu, please select Content >> Elements >> Pages. Here you can find all the store pages that you have imported, so you don't need to add them. You only need to update the pages HTML and XML content as you wish.

Step 1. Open any of them in order to get the access to the content.

Step 2. Edit the content as you desire

Step 3. Press Save Page button to save your configuration

How to show "Block-Slideshow1" in homepage?

To create the "block-slideshow1", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "block-slideshow1".
Please try to use below example code in your cms contents.

<div class="slidershow-home owl-carousel">
<div class="item"><img src="{{media url="wysiwyg/imageslider/home-v11.jpg"}}" alt="" /></div>
<div class="item"><img src="{{media url="wysiwyg/imageslider/home-v12.jpg"}}" alt="" /></div>
<div class="item"><img src="{{media url="wysiwyg/imageslider/home-v13.jpg"}}" alt="" /></div>
</div>
<script type="text/javascript" xml="space">// <![CDATA[
// 
// 
// 
// 
require(['jquery','owlcarousel'], function ($) {
  $(".slidershow-home.owl-carousel").owlCarousel({
    
    items: 1,
    dots:true
    
  });
}); 
require(['jquery','owlcarousel'], function ($) {

			dotcount = 1;
			jQuery('.slidershow-home .owl-dot span').each(function() {
			  jQuery( this ).addClass( 'dotnumber' + dotcount);
			  jQuery( this ).attr('data-info', dotcount);
			  dotcount=dotcount+1;
			});
			slidecount = 1;
			jQuery('.slidershow-home .owl-item').not('.cloned').each(function() {
			  jQuery( this ).addClass( 'slidenumber' + slidecount);
			  slidecount=slidecount+1;
			});
			
			jQuery('.slidershow-home .owl-dot span').each(function() {
			
          grab = jQuery(this).data('info');

          slidegrab = jQuery('.slidenumber'+ grab +' img').attr('src');         
          jQuery(this).css("background-image", "url("+slidegrab+")");  

      });
			
});
// 
// 
// 
// ]]></script>

To show the "block-slideshow1", please go to Content >> Elements >> Pages.

Please try to use below example code in your XML contents.

<referenceContainer name="page.top">
<block class="Magento\Cms\Block\Block" name="block-slideshow1" before="-">
	<arguments>
		<argument name="block_id" xsi:type="string">block-slideshow1</argument>
	</arguments>
</block>
</referenceContainer>

How to show "Id-1-Block-1" in homepage?

To create the "Id-1-Block-1", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "id-1-block-1".
Please try to use below example code in your cms contents.

<div class="policy-shop">
<div class="row">
<div class="col-sm-4">
<div class="wrapper">
<div class="icon"><i class="fa fa-truck"> </i></div>
<div class="content">
<h2>Fast & Free Shipping</h2>
<p>Fast & Free Shipping on orders over $99.00</p>
</div>
</div>
</div>
<div class="col-sm-4">
<div class="wrapper">
<div class="icon"><i class="fa fa-usd"> </i></div>
<div class="content">
<h2>Money Guarantee</h2>
<p>Lorem ipsum 30 days money back guarantee</p>
</div>
</div>
</div>
<div class="col-sm-4">
<div class="wrapper">
<div class="icon"><i class="fa fa-support"> </i></div>
<div class="content">
<h2>Online Support</h2>
<p>We Support Online 24/7 for Customer</p>
</div>
</div>
</div>
</div>
</div>
<p>{{block class="Sm\Categories\Block\Categories" name="categories" as="categories" template="Sm_Categories::default.phtml" /}} {{block class="Sm\FilterProducts\Block\FilterProducts" name="filterproducts" template="Sm_FilterProducts::default-id1.phtml"}}</p>
<script type="text/javascript" xml="space">// <![CDATA[
// 
require([
				'jquery',
				'owlcarousel'
			], function ($) {
				var slider_1 = $(".sm-filter-products .owl-carousel");
				slider_1.owlCarousel({				
					nav: true,
					dots:false,
					margin: 30,
					
					responsive: {
						0: {
							items:1
						},
						
						480: {
							items:2
						},
						
						768: {
							items:3
						},
						
						991: {
							items:4
						},	
						
						1200: {
							items:5
						},
					}
				});	  
			});
// ]]></script>
<div class="row banner-center mr60">
<div class="col-sm-6 mr30"><a class="banner" href="#"><img src="{{media url="wysiwyg/banner/1.jpg"}}" alt="Static Image" /></a></div>
<div class="col-sm-6"><a class="banner mr30" href="#"><img src="{{media url="wysiwyg/banner/2.jpg"}}" alt="Static Image" /></a> <a class="banner" href="#"><img src="{{media url="wysiwyg/banner/3.jpg"}}" alt="Static Image" /></a></div>
</div>
<p>{{block class="Sm\ListingTabs\Block\ListingTabs" name="listingtabs.default" as="listingtabs_default" template="Sm_ListingTabs::default.phtml"}}</p>

To show the "Id-1-Block-1", please go to Content >> Elements >> Pages.

Please try to use below example code in your cms contents.

{{block class="Magento\\Cms\\Block\\Block" block_id="id-1-block-1"}}

How to show "Id-1-Block-2" in homepage?

To create the "id-1-block-2", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "id-1-block-2".
Please try to use below example code in your cms contents.

<div class="block brand-wrapper">
<div class="title-home">Featured Brands</div>
<div class="owl-carousel slider-brands">
<div class="item"><a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br1.jpg"}}" alt="Brand" /></a> <a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br7.jpg"}}" alt="Brand" /></a></div>
<div class="item"><a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br2.jpg"}}" alt="Brand" /></a> <a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br8.jpg"}}" alt="Brand" /></a></div>
<div class="item"><a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br3.jpg"}}" alt="Brand" /></a> <a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br9.jpg"}}" alt="Brand" /></a></div>
<div class="item"><a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br4.jpg"}}" alt="Brand" /></a> <a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br10.jpg"}}" alt="Brand" /></a></div>
<div class="item"><a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br5.jpg"}}" alt="Brand" /></a> <a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br11.jpg"}}" alt="Brand" /></a></div>
<div class="item"><a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br6.jpg"}}" alt="Brand" /></a> <a class="mr30" title="Brand" href="#"><img src="{{media url="wysiwyg/brand/br12.jpg"}}" alt="Brand" /></a></div>
</div>
</div>
<script type="text/javascript" xml="space">// <![CDATA[
// 
// 
// 
// 
			require([
				'jquery',
				'owlcarousel'
			], function ($) {
				var brands_slider = $(".slider-brands");
				brands_slider.owlCarousel({
					nav: false,
					dots:false,
					margin: 30,
					
					responsive: {
						0: {
							items:2
						},
						480: {
							items:3
						},
						768: {
							items:4
						},
						991: {
							items:5
						},						
						1200: {
							items:6
						}
					}
				});	  
			});	
					
		
// 
// 
// 
// 
// ]]></script>
<p>{{block class="Sm\InstagramGallery\Block\InstagramGallery" name="instagramgallery" template="Sm_InstagramGallery::default.phtml"}}{{block class="Magento\Customer\Block\Newsletter" name="newletter" template="Magento_Newsletter::subscribe-home1.phtml"}}</p>

To show the "id-1-block-2", please go to Content >> Elements >> Pages.

Please try to use below example code in your cms contents.

 {{block class="Magento\\Cms\\Block\\Block" block_id="id-1-block-2"}}

How to create "Footer" in homepage?

1. How to create "Block-Contact-Ft"

To create the "block-contact-ft", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "block-contact-ft".
Please try to use below example code in your cms contents.

<div class="footer-block">
<div class="footer-block-title">
<h3>Contact Details</h3>
</div>
<div class="footer-block-content">
<ul class="links-contact">
<li class="add-icon"><span class="fa fa-home"> </span><span>Address:</span> No 40 Baria Sreet 133/2 NewYork City, NY, United States</li>
<li class="email-icon middle-content"><span class="fa fa-send"> </span><span>Email:</span> contact@market.com</li>
<li class="phone-icon"><span class="fa fa-phone"> </span><span>Phone 1 :</span> (888) 1900 86420 - (444) 1900 56789</li>
</ul>
</div>
</div>

2. How to create "Block-Information-Ft"

To create the "block-information-ft", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "block-information-ft".
Please try to use below example code in your cms contents.

<div class="footer-block">
<div class="footer-block-title">
<h3>Information</h3>
</div>
<div class="footer-block-content">
<ul class="links-footer">
<li><a title="About Us" href="{{store url=""}}about-us.html">About Us</a></li>
<li><a title="Market Reviews" href="#">Market Reviews</a></li>
<li><a title="Terms of Use" href="#">Terms of Use</a></li>
<li><a title="Privacy Policy" href="#">Privacy Policy</a></li>
<li><a title="Site Map" href="#">Site Map</a></li>
</ul>
</div>
</div>

3. How to create "Block-Customer-Ft"

To create the "block-customer-ft", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "block-customer-ft".
Please try to use below example code in your cms contents.

<div class="footer-block">
<div class="footer-block-title">
<h3>Customer Service</h3>
</div>
<div class="footer-block-content">
<ul class="links-footer">
<li><a title="Shipping Policy" href="#">Shipping Policy</a></li>
<li><a title="Compensation First" href="#">Compensation First</a></li>
<li><a title="My Account" href="{{store url=""}}customer/account">My Account</a></li>
<li><a title="Return Policy" href="#">Return Policy</a></li>
<li><a title="Contact Us" href="{{store url=""}}contact-us.html">Contact Us</a></li>
</ul>
</div>
</div>

4. How to create "Block-Socials-Ft"

To create the "block-socials-ft", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "block-socials-ft".
Please try to use below example code in your cms contents.

<div class="footer-block">
<div class="footer-block-title">
<h3>Payment & Shipping</h3>
</div>
<div class="footer-block-content">
<div class="description">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam</div>
{{block class="Magento\Framework\View\Element\Template" name="social.button.detail" after="product.info.overview" template="Magento_Theme::html/social-button.phtml" /}}</div>
</div>

Theme Setting

Configuration

In Magento admin panel, navigate to Stores>> Settings>> Configuration >> MAGENTECH.COM >> SM Histore and configure its settings as you want.

Please click Here to view the theme settings.

General Options

Theme Color: In this option, you can set main color of entire page.

Body Font

In these options, you can change main font, font size, link color, text color, background, etc.

Image Box

Thumbs Styles: This option allow you choose thumb style types that you want.
Enable Loop: Choose "Yes" to repeat your loop.
Enable Keyboard Trigger: Choose "Yes/No" to "Enable/Disable" keyboard trigger feature.
Show Navigation: Choose "Yes/No" to "Show/Hide" navigation.
Enable Popup Fullscreen: Choose "Yes" to show fullscreen popup when you mouse click on the product detail.
Show Thumbs Navigation: Choose "Yes/No" to "Show/Hide" thumb navigation.
Thumbs Margin: Distance between the thumb images.
Thumbs Border Active Width: You can change width of thumb boder when active.
Breakpoints: Breakpoints are used to set up the screen width at which the design of thumbnails changes.

Image Zoom

Enable Product Image Zoom: Choose "Yes/No" to "Allow/Not Allow" show product image zoom when you mouse hover on the product image.

Social Buttons

Show social buttons: Choose "Yes/No" to "Show/Hide" social button in detail page.

Related - Upsell Product

In these options, you can choose "Yes/No" to "Show/Hide" and set limit quantity for related and upsell products.

Tab

Choose tab style types that you want.

Custom Tab

Choose "Yes", you can change name and add content for Custom Tab.

Socials

Choose "Yes" to show socials. When you choose "Yes", you can change name and link of socials.

Advanced

Choose "Yes/No" to "Show/Hide" Go to Top, Add to Cart, Add to Wishlist, Add to Compare, Newsletter Popup, Copyright, etc.

Developer

To custom Css or Javascript

Theme Installation

Import Static Blocks

By clicking this button, you can import all static blocks that are used for our demo site.

Import Pages

By clicking this button, you can import all pages that are used for our demo site.

Import Demos

Click "Demo X" button to install demo version that you prefer to install.

Note: When you click "Demo X" button, the administration page will reload automatically. After it finishes reloading, please click "Save Config" button and refesh cache.

Extensions

Magentech Extensions

1. SM Mega Menu

Click here to view documentation of SM Mega Menu module.

Enable Extensions: Allow to enable/disable the module. If choose "Disable", magento's default menu style will be applied.
Select Mega Menu: Allow to choose Mega Menu.
Select Template: This module support 2 templates for presenting of menu (Horizontal and Vertical).
Select Effect: We support effects for Mega menu (CSS/Animation/Toggle)

Advanced Options

Caching: Allow to choose to cache the content of module.

How to create list Menu Items for your menu?

Step 1: Log in to Admin, navigate to SM Megamenu >> Add New Menu (add group: "Mega Menu Demo")

Step 2: Navigate to SM Megamenu >> Configuration & fill the ID number for the created menu in step 1

Step 3: In order to add menu items, go to SM Megamenu >> Menu Manager >> click on 'Edit' to open Menu Items to add items as you want.

For example about megamenu:

Sortable Categories Items: Please click Here to view.

Backend Settings: Please click Here to view.

2. SM Filter Product

Click here to view documentation of SM Filter Product module.

General Settings

Enabled : Enable or disable the module displaying on Frontend area.
Title Module: Enter the title of the module.

Source Options

Show Countdown Timer: Allow to show countdown timer for special product when you select “Yes”.
Select Category: Allow you to select Category.
Product Limitation: Allow to set product limitation.

3. SM Cart Quick Pro

Click here to view documentation of SM Cartquickpro module.

Enable Extensions: Enable or Disable this extension.
Select Type: This module support 3 types: Both, Quickview, Ajax Cart. Option "Both" including quickview and ajaxcart.
Product Class Container: Class of the product.
Button Class Container: Where to display the button.
Label Button: You can define texts of the quickview labels.
Countdown Number: The time of ajax box displaying on the screen.

4. SM Listing Tabs

Click here to view documentation of SM Listing Tabs module.

General Options

Enabled Extensions: Enable or disable the module displaying on Frontend area.
Title: Enter the title of the module.
Type Show: We support 2 types: Slider or Loadmore.
Type Listing: We support 3 types: All, only deals and under price.
Show Countdown Timer: Allow to show countdown timer for special product when you select “Yes”.

Source Options

Fiter Type: Allow you to select Type of Filter.
Select Category: Allow you to select Category.
Order By: Set Product Field to Order By.
Ordering Direction: Allow to order ascending/descending direction.
Product Limitation: Allow to set product limitation.

5. SM Categories

Click here to view documentation of SM Categories module.

General Options

Enabled Extensions: Allow to enable/disable the module.
Title: Enter the title of the module.

Source Options

Select Category: Allow you to select Category.
Category Limitation: Allow to set category limitation.

Other Extensions

SM Histore is compatible with MageFan_Blog extension. You can show Latest Blog (Store French), after install this extension.

To create the "blog", please go to Admin Panel > Content > Elements > Blocks > Add new block with Identifier "id-2-block-2" block.
Please try to use below example code in your cms contents.

	{{widget type="Magefan\Blog\Block\Widget\Recent" title="Latest Blog" number_of_posts="5"}}

To show the "blog", please go to Content >> Elements >> Pages.

Please try to use below example code in your cms contents.

 {{block class="Magento\\Cms\\Block\\Block" block_id="id-2-block-2"}}

Other

Support

SUPPORT - If you have any questions that are beyond the scope of this help file, please feel free to send us via: Support Tickets System

FAQs - Go to Here to view more the Frequently Asked Questions.

Change Log

Click here to view changelog