SM Agood Magento 2.1.x

This document is for SM Agood Magento Version 2.1.x

View demo

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.

Note: This theme has this version for Magento 2.1.x.

1 SYSTEM REQUIREMENT

At the basic level, this theme will require the following conditions:

    • Compatible with Magento Community Edition 2.1.x
    • Composer (latest stable version)
    • PHP 5.6 (Magento 2.1.x no longer supports PHP 5.5)
    • PHP 7.0.2, 7.0.6 up to 7.1
    • MySQL 5.6
    • Apache 2.2 or 2.4
    • nginx 1.8 (or latest mainline version)
    • Memory_limit no less than 2GB
    • In the future if the conditions change, please check the Magento technology stack requirements

2INSTALLATION

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.

2.1 Quickstart Installation:

Magentech provides SM Quickstart package for each theme which aims to ease the installation for users. Please note that with Quickstart, all your existing data will be overwritten. Thus, if you plan to start your site from the beginning, it will help you save much time of installing and configuring.

Note: Follow Magento 2.0 Installation Guide to install the Composer before doing this Quickstart installation.

Please follow steps below:

  • Step 1: Download the quickstart package named as sm_agood_quickstart_pl_m2.1.6_v1.3.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

    • Note: You need to remember the database name to use in the next steps

    • Step 4:Import database sample_data.sql under the folder sm_agood_quickstart_pl_m2.1.6_v1.3.0\data_quickstart

    Note:

    After successful import DO NOT run magento.

    1. Now we are going to Set file system ownership and permissions. To perform all actions, you should use PuTTY - a free SSH and telnet client for Windows on your computer. When you have the command-line access, enter the following commands in the order shown:

    Go Here to readmore about the action.

    • Step 5: Run installation process by opening browser and navigate to your URL (where the Quickstart uploaded) to load default Magento installer and follow each step of the Installer so that the installation process can be set.

    • 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:

    • ;extension=php_intl.dll
    • ;extension=php_xsl.dll

    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.

    Note:

    Finally, run this command:

    php bin/magento catalog:images:resize

    The magento “catalog images:resize” command enables you to resize images for display on your storefront.
    The message “Product images resized successfully” displays to confirm the command succeeded.

    2.2 Manual Installation

      • Step 1: Please unzip ‘sm_agood_theme_m2.1.x_v1.3.0′ file and upload folders app; pub from the theme package to the root of your Magento site folder on your server.

        Note: You could change the name of this folder. However, if you want your website run correctly, it need to have the same name as the database.

      • Step 2:

        • Now we are going to verify Composer installation, Clear compiled code and the cache, Deploy static content, Reindex the Magento 2 blocks and Flush Magento 2 cache. Remember that you have had the Composer before doing this step by following Magento 2.0 Installation Guide to get the Composer.
        On Windows server environment, to perform all above actions, press WINDOWS KEY + R to open RUN dialog and type cmd to open Command Prompt.

        Type cd PATH_TO_YOUR_MAGENTO2_FILES to enter in Magento 2 ROOT directory.

        • 1. Now to verify Composer installation in above directory, type: composer install.

          • If you get any error in this step, please check your Composer installation.

        • 2. Clear compiled code and the cache by typing php bin/magento setup:upgrade in CMD. Typically, you use magento this command line to update components and each component can require different compiled classes.

        • 3. In this step, we are setting up static content to deploy on our Magento store. To perform this, type: php bin/magento setup:static-content:deploy.

          • If you get any error, check your PHP.EXE and PHP.INI Environment Variable

        • 4. Next, to reindex Magento Static Blocks, type: php bin/magento indexer:reindex.

        • 5. And finally, to flush Magento 2 cache, type: php bin/magento cache:flush.

        Note:

        1. Now we are going to Set file system ownership and permissions. To perform all actions, you should use PuTTY - a free SSH and telnet client for Windows on your computer. When you have the command-line access, enter the following commands in the order shown:

        Go Here to readmore about the action.
        2. Command usage:

        The magento “catalog images:resize” command enables you to resize images for display on your storefront.
        The message “Product images resized successfully” displays to confirm the command succeeded.

      • Step 3: Log in to your Admin Panel (e.g. https://yourdomain.com/admin/)

        Note: If you are using the Admin Panel when copying folders in step 1, you need to log out and log in back.

      • Step 4: Disable Cache: Go to System >> Tools >> Cache Management, click ‘Sellect All’ button, then choose ‘Disable’ and click ‘Submit’ button to complete the action.

      • Step 5: Navigate to Content>> Design>> Configuration. In your storeview, select Default Theme field with the SM Agood.

    • Step 6: Click “Save Config” button to save your changes.

    2.3 Theme Setting

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

    Please click Here to view the theme settings.

    Set Below options

    • Configure General Options with Color (of theme), Body Font, Elements Google Font, Menu for any store.
    • Configure Theme Layout with Layout style
    • Configure the Product Listing with Layout 1 Column, Layout 2 Columns, Layout 3 Columns
    • Configure the Product Detail To zoom image of product, adjust Zoom Mode, Custom tab, and content, etc.
    • Configure Socials : To connect with social networks such as Facebook, Twitter, Google Plus, Linkedin, Pinterest
    • Configure Advanced : To Show Go to Top, Add to Cart, Add to Wishlist, Add to Compare
      • Configure Developer: To Custom Css or Javascript
    • Configure Theme Installation: To Import Static Blocks, Pages and Demo

    2.4 Demo Installation

    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 >> SM Agood >> 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: And finally, to flush Magento 2 cache, you could use this command as php bin/magento cache:flush in Command Prompt. Or you could go to System >> Tools >> Cache Management, click ‘Flush Magento Cache’ button to flush all the cache.

3CONFIGURATION

3.1 Page Configuration

3.1.1 Home Style 1

Frontend of Home Style 1 - Layout Position
home-layout1
In the Admin Panel, please navigate to Content >> Elements >> Pages to create a new page in Pages section.

  • Backend Setting: Please click Here to view.
  • Copy and paste the following code into the Content field:

3.1.2 Home Style 2

Frontend of Home Style 2 - Layout Position
home-layout2
In the Admin Panel, please navigate to Content >> Elements >> Pages to create a new page in Pages section.

  • Backend Setting: Please click Here to view.
  • Copy and paste the following code into the Content field:

3.1.3 Home Style 3

Frontend of Home Style 3 - Layout Position
home-layout3
In the Admin Panel, please navigate to Content >> Elements >> Pages to create a new page in Pages section.

  • Backend Setting: Please click Here to view.
  • Copy and paste the following code into the Content field:
  • Copy and paste the following code into the Layout Update XML field:

Note: Set Default Page

  • To set a default page for your Magento Site, in the Admin Panel you go to Stores>> Settings >>Configuration>>Web>>Default Pages. Please click to see the Backend Setting.
  • 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.

3.2 Configure Megamenu

3.2.1 Horizontal Megamenu:

Horizontal-mega-menu

  • Sortable Categories Items Please click Here to view.

Features
Frontend Appearance

  • Backend Setting: Please click Here to view.
  • Backend Setting of ‘Dropdown Features’: Please click Here to view.

    • Copy and paste the following code into the Content field::

Shop
Frontend Appearance

  • Backend Setting: Please click Here to view.
  • Backend Setting of ‘Group 1- Categories’: Please click Here to view.
  • Backend Setting of ‘Categories’ in ‘ Group1- Categories’: Please click Here to view.
  • Backend Setting of ‘Banner’: Please click Here to view.

Furnitures
Frontend Appearance

  • Backend Setting: Please click Here to view.
  • Backend Setting of ‘Banner’: Please click Here to view.

    • Copy and paste the following code into the Content field::

  • Backend Setting of ‘Group 1′: Please click Here to view.
  • Backend Setting of ‘New arrivals’ in ‘ Group1′: Please click Here to view.

    • Note: Do the same with the others having same level.

Electronics
Frontend Appearance

  • Backend Setting: Please click Here to view.

    • Note: Do the same with the others having same level.

3.2.2 Vertical Megamenu:

Horizontal-mega-menu

  • Sortable Categories Items Please click Here to view.

Computer & Laptop
Frontend Appearance

  • Backend Setting: Please click Here to view.
  • Backend Setting of ‘Group 1- Categories’: Please click Here to view.
  • Backend Setting of ‘Categories’ in ‘Group 1- Categories’: Please click Here to view.
  • Backend Setting of ‘Banner’: Please click Here to view.

Electronics
Frontend Appearance

  • Backend Setting: Please click Here to view.

    • Note: Do the same with the others having same level.

Furniture
Frontend Appearance

  • Backend Setting: Please click Here to view.
  • Backend Setting of ‘Sub Categories’: Please click Here to view.

    • Copy and paste the following code into the Content field::

    Note: Do the same with ‘Jewelry products’ and its ‘Sub Categories’.

3.3 Configure Extensions

The SM Agood front-page has been integrated with the extensions in the following list:

In SM Agood Administration Page, please navigate to Stores>> Settings>> Configuration >> MAGENTECH to configure extensions as you want.

      • Position: SM Box Search
      • Frontend Appearance

      • Backend of SM Search Box: Click Here
3.3.2 SM Megamenu
      • Position: SM Megamenu
      • Frontend Appearance

Horizontal Megamenu:
Vertical Megamenu:

      • Backend of SM Megamenu: Click Here
3.3.3 SM Image Slider
      • Position: SM Image Slider
      • Frontend Appearance

      • Backend of SM Image Slider: Click Here
3.3.4 SM Countdown Product Slider
      • Position: SM Countdown Product Slider
      • Frontend Appearance

      • Backend of SM Countdown Product Slider: Click Here
3.3.5 SM Categories
      • Position: SM Categories
      • Frontend Appearance

      • Backend of SM Categories: Click Here
3.3.6 SM Listing Tabs
      • Position: SM Listing Tabs
      • Frontend Appearance

      • Backend of SM Listing Tabs: Click Here
3.3.7 SM Basic Products
      • Position: SM Basic Products
      • Frontend Appearance

      • Backend of SM Basic Products: Click Here
3.3.8 SM Super Categories
      • Position: SM Super Categories
      • Frontend Appearance

      • Backend of SM Super Categories: Click Here
3.3.9 SM Quick View
      • Position: SM Quick View
      • Frontend Appearance

      • Backend of SM Quick View: Click Here

3.4 Configure Static Blocks

The SM Agood front-page has the following static blocks in the theme:

To create a new static block, go to Content>> Elements>> Blocks >> Add new block.

Static Block: header-livechat

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “header-livechat”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: header-hotline

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “header-hotline”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: quick-access

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “quick-access”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: box-infos

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “box-infos”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “banner-home1-1″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “banner-home1-2″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: block-blog

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “block-blog”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: clients-say

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “clients-say”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: slider-brands

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “slider-brands”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: spotlight1

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “spotlight1″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: spotlight2

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “spotlight2″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: spotlight3

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “spotlight3″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: spotlight4

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “spotlight4″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “footer-product-tag”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “footer-payment”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: banner2-1

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “banner2-1″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “top-popular-left”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: latest-news

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “latest-news”

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: banner2-2

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “banner2-2″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

Static Block: clients-say2

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “clients-say2″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

To create the static block, go to Content>> Elements>> Blocks with Identifier * : “banner-home3-1″

Frontend Appearance

  • Backend Setting: Please click Here to view.

Copy and paste the following code into the content tab of this static block:

3.5 How To Edit Copyright in Admin Panel

Frontend Appearance

In SM Agood Administration Page, please navigate to Stores>> Settings>> Configuration >> MAGENTECH >> SM Agood >> Advanced to configure this theme’s copyright.

Edit the code here:

3.6 How To Customize the Social symbols in admin panel

Frontend Appearance

In SM Agood Administration Page, please navigate to Stores>> Settings >> Configuration >> MAGENTECH >> SM Agood >> Socials.

3.7 NEWSLETTER

1. NEWSLETTER
Frontend Appearance

In your Website’s Directory, go to app\design\frontend\Sm\agood\Magento_Newsletter\templates folder. To change the text in this part, in this folder, you could open the file named subscribe.phtml by your editor program.
Find and change the following text in this file as you want:

  • Backend Setting: Please click Here to view.

2. NEWSLETTER POP-UP
Frontend Appearance

In your Website’s Directory, go to app\design\frontend\Sm\agood\Magento_Newsletter\templates folder. To change the text in this part, in this folder, you could open the file named subscribe-popup.phtml by your editor program, and find the word Submit to change.

  • Backend Setting: Please click Here to view.

Find and change the following text in this file as you want:

In your Website’s Directory, go to app\design\frontend\Sm\agood\web\images folder. To change the image in this part, in this folder, you could replace the image named bg-popupnews.jpg by your image.

  • Please click Here to view.

4SUPPORT

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