Getting Started

Welcome to marsech 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.

Compatible with Magento

marsech Magento Theme is fully compatible with Magento Community Edition version 2.4.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.


Installation

Elasticsearch

As of Magento 2.4.0, MySQL is no longer used for search. You must use Elasticsearch. Magento supports Elasticsearch 7.6.x.

Note: Magento no longer supports Elasticsearch 2.x, 5.x, and 6.x.

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): Manual Installation (including Theme Installation): Suitable if your store is full with data/content (category, products...) that you don't want to overwrite.
Note:
  • To use magento 2.2.4+ most effectively we recommend using PHP 7.1
  • To use magento 2.3.x most effectively we recommend using PHP 7.1.3+
  • To use magento 2.4.x most effectively we recommend using PHP 7.4.0

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

    Important: You must use the command line to install Magento 2.4+.

    • Step 1: Download the quickstart package named as sm_marsech_quickstart_pl_m2.4.1_v1.0.0
    • Step 2: Upload and Extract the whole Quickstart package to your server. In Quickstart folder you will see the extracted folder that include all sample data


      • After upload quickstart package, please extract package by this command: unzip file.zip

    • 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_marsech_quickstart_pl_m2.4.1_v1.0.0\data_quickstart
      Note: You can import database by run this command mysql -u root -p database_name < sample_data.sql

      Note: After that please go to folder root and run these command to permissions:
      chmod -R 777 pub
      chmod -R 777 generated
      chmod -R 777 var
    • Step 5: Install Magento

      This example assumes that the Magento install directory is named sm_marsech, the db-host is on the same machine (localhost), and that the db-name, db-user, and db-password are all magento:

      php bin/magento setup:install --base-url=http://192.168.1.220/ytc_templates/magento/sm_marsech --base-url-secure=https://192.168.1.220/ytc_templates/magento/sm_marsech --db-host=localhost --db-name=magento --db-user=magento --db-password=magento --admin-firstname=admin --admin-lastname=admin --admin-email=admin@admin.com --admin-user=admin --admin-password=admin123 --language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 --backend-frontname="admin" --search-engine=elasticsearch7


      Messages similar to the following display to indicate a successful installation:
      Post installation file permissions check...
      For security, remove write permissions from these directories: '/var/www/html/ytc_templates/magento/sm_marsech/app/etc'
      [Progress: 274 / 274]
      [SUCCESS]: Magento installation complete.
      [SUCCESS]: Admin Panel URI: /admin_puu71q
      Note: You can customize the Admin URI with the --backend-frontname option. However, we recommend omitting this option and allowing the installation command to automatically generate a random URI. A random URI is harder for hackers or malicious software to exploit. The URI displays in your console when installation is complete.
    • Step 6: Can't login to admin panel
      When you login to admin will be display like this image:

      Please open file app/etc/config.php and change 'Magento_TwoFactorAuth' => 1 to 'Magento_TwoFactorAuth' => 0

      After that run these command:
      php bin/magento setup:upgrade
      and php bin/magento setup:static-content:deploy -f
    • Step 7: Finally, permissions for the following folders by run these commands:
      chmod -R 777 pub
      chmod -R 777 generated
      chmod -R 777 var

    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: Download Magento 2.4.x https://magento.com/tech-resources/download and install on your server
    • Step 2: Please download 'sm_marsech_theme_m2.4.x_v1.0.0.zip' file and upload to the root of your magento site folder on your server, after that unzip by command unzip name_file.zip.
    • Step 3: Active SM Extensions, open command line in folder root of magento and run commands php bin/magento setup:upgrade


    • Step 4: Run deploy command: php bin/magento setup:static-content:deploy -f
      Finally, permissions for the following folders by run these commands:
      chmod -R 777 pub
      chmod -R 777 generated
      chmod -R 777 var
    • Step 5: Select "Sm Marsech" theme in Content > Design > Configuration > Edit Default Store > Select "Sm Marsech" theme.

    • Step 6: Click "Save Configuration" button to save your changes.
    • Step 7: Navigate to Stores>> Settings>> Configuration >> MAGENTECH >> Sm Marsech >> Theme Installation. Press the buttons named 'Static Blocks' and 'Pages' to import all default blocks and pages. Click "Save Configuarion" button to save your changes.
    • Step 8: Click "Demo X" button to install demo version that you prefer to install. After that, click "Save config" button on the top.

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

    • Step 9: 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.

    • Step 9: Finally, go to front-end to view demo (example import demo 1).

    Layout Position

    home 1 Home Style 1

    Homepage Configuration

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

    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 edit description?
    To edit description, please go to Admin Panel > Content > Elements > Blocks > Search Identifier "short-description-newsletter-popup".
    You can edit code HTML in your cms contents.
    <p>Subscribe to the marsech mailing list to receive updates on new arrivals, special offers and other discount information</p>

  • To show the "slideshow", please go to Content >> Elements >> Pages >> Edit Pages.
    • Please add this code in your cms contents. 
    {{block class="Sm\ImageSlider\Block\ImageSlider" name="imageslider" template="Sm_ImageSlider::default.phtml"}}

  • To edit the "Policy", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "policy-shop4".
    You can edit code HTML in your cms contents.
    <div class="policy-shop4">
<div class="row">
<div class="col-sm-4">
<div class="inner-content"><img src="{{media url="wysiwyg/banner/icon4-1.png"}}" alt="" /> <a href="#">Enjoy free Shipping Now</a></div>
</div>
<div class="col-sm-4">
<div class="inner-content center"><img src="{{media url="wysiwyg/banner/icon4-2.png"}}" alt="" /> <a href="#">Over 11,000 designers</a></div>
</div>
<div class="col-sm-4">
<div class="inner-content"><img src="{{media url="wysiwyg/banner/icon4-3.png"}}" alt="" /> <a href="#">Bonus gift on order overs $99</a></div>
</div>
</div>
</div>

  • To show the "New Arrivals", please go to Content >> Elements >> Pages >> Edit Pages.
    • Please add this code in your cms contents. 
     {{block class="Sm\BasicProducts\Block\BasicProducts" name="basicproducts" template="Sm_BasicProducts::product-v4.phtml" title="New Arrivals" product_order_by="created_at" product_category="97" posttext="block-posttext" product_limitation="9" nb_column1="5" nb_column2="5" nb_column3="3"}}

  • To edit the "Banner", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "banner-homev4".
    You can edit code HTML in your cms contents.
    <div class="banner-home4 mr40">
<div class="row">
<div class="col-sm-6"><a class="mr10 effect-img1" href="#"> <img src="{{media url="wysiwyg/banner/bn41.jpg"}}" alt="" /> </a></div>
<div class="col-sm-6"><a class="mr10 effect-img1" href="#"> <img src="{{media url="wysiwyg/banner/bn42.jpg"}}" alt="" /> </a></div>
</div>
<div class="row">
<div class="col-sm-3"><a class="mr10 effect-img1" href="#"> <img src="{{media url="wysiwyg/banner/bn44.jpg"}}" alt="" /> </a></div>
<div class="col-sm-6"><a class="mr10 effect-img1" href="#"> <img src="{{media url="wysiwyg/banner/bn43.jpg"}}" alt="" /> </a></div>
<div class="col-sm-3"><a class="mr10 effect-img1" href="#"> <img src="{{media url="wysiwyg/banner/bn45.jpg"}}" alt="" /> </a></div>
</div>
</div>
  • To show the "Banner", please go to Content >> Elements >> Pages >> Edit Pages.
    • Please add this code in your cms contents. 
    {{block class="Magento\\Cms\\Block\\Block" block_id="banner-homev4"}}

  • To edit the "Footer1", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "customer-services-footer".
    You can edit code HTML 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="Store Locator" href="#">Store Locator</a></li>
<li><a title="Returns Policy" href="#">Returns Policy</a></li>
<li><a title="Order Tracking" href="#">Order Tracking</a></li>
<li><a title="Give Back Box" href="#">Give Back Box</a></li>
<li><a title="Download Team Catalog" href="#">Download Team Catalog</a></li>
</ul>
</div>
</div>

  • To edit the "Footer2", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "about-footer".
    You can edit code HTML in your cms contents.
    <div class="footer-block">
<div class="footer-block-title">
<h3>About Us</h3>
</div>
<div class="footer-block-content">
<ul class="links-footer">
<li><a title="Who are we ?" href="#">Who are we ?</a></li>
<li><a title="Delivery and return" href="#">Delivery and return</a></li>
<li><a title="Size guide" href="#">Size guide</a></li>
<li><a title="Terms & Conditions" href="#">Terms & Conditions</a></li>
<li><a title="Legal Mentions" href="#">Legal Mentions</a></li>
</ul>
</div>
</div>

  • To edit the "Footer3", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "our-guarantees".
    You can edit code HTML in your cms contents.
    <div class="footer-block">
<div class="footer-block-title">
<h3>OUR GUARANTEES</h3>
</div>
<div class="footer-block-content">
<ul class="links-footer">
<li><a title="Authenticity 100% guaranteed" href="#">Authenticity 100% guaranteed</a></li>
<li><a title="Money Back Guarantee" href="#">Money Back Guarantee</a></li>
<li><a title="Protection for Buyers and Sellers" href="#">Protection for Buyers and Sellers</a></li>
<li><a title="Buyers and Sellers" href="#">Buyers and Sellers</a></li>
<li><a title="Secure Payment" href="#">Secure Payment</a></li>
</ul>
</div>
</div>

  • To edit the "Footer4", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "contact-footer".
    You can edit code HTML in your cms contents.
    <div class="footer-block">
<div class="footer-block-title">
<h3>Contact Us</h3>
</div>
<div class="footer-block-content">
<ul class="links-contact">
<li><span>Address : </span>123 Suspendis mattis, Sollicitudin District, NY Accums Fringilla</li>
<li><span>Email :</span> support@domain.com</li>
<li><span>Hotline : </span>0123-456-78910</li>
</ul>
</div>
</div>

  • To edit the "Footer4", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "payment-footer ".
    You can edit code HTML in your cms contents.
    <p><img src="{{media url="wysiwyg/payment/payment.png"}}" alt="Payment" /></p>

  • To edit the "Footer4", please go to Admin Panel > Content > Elements > Blocks > Search with Identifier "block-ft-policy4 ".
    You can edit code HTML in your cms contents.
    <div class="ft-policy4">
<div class="container">
<div class="row">
<div class="col-md-9 col-lg-8">
<ul>
<li><img src="{{media url="wysiwyg/banner/icon41.png"}}" alt="" />AUTHENTICITY <br />100% GUARANTEED</li>
<li><img src="{{media url="wysiwyg/banner/icon42.png"}}" alt="" />MONEY BACK <br />GUARANTEE</li>
<li><img src="{{media url="wysiwyg/banner/icon43.png"}}" alt="" />SECURE<br /> PAYMENT</li>
<li><img src="{{media url="wysiwyg/banner/icon44.png"}}" alt="" />PROTECTION FOR <br />BUYERS & SELLERS</li>
</ul>
</div>
<div class="col-md-3 col-lg-4">
<div class="app-ft"><a href="#"><img src="{{media url="wysiwyg/banner/apple.png"}}" alt="" /></a> <a href="#"><img src="{{media url="wysiwyg/banner/google.png"}}" alt="" /></a></div>
</div>
</div>
</div>
</div>

    • Theme Setting

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

    Please click Here to view the theme settings.

    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.

    Menu

    Menu Style: This theme support 2 types: mega menu and css menu. You can select a menu style that you want.

  • Mega Menu: The menu are items that you have created from module megamenu.
  • CSS Menu: The menu are categories that you have created.

    • Menu on Top: Choose "Yes" to turn on "Sticky Menu" feature, the menu will be fixed on top when scroll down the page.

    Mobile Menu Type: This theme support sidebar menu and collapse on mobile. You can select a menu style that you want.

    Layout Style: This theme support boxed and full width layout. You can select a layout style that you want.
    Responsive Layout: Choose "Yes" to show responsive layout for each type of devices.

    We provides flexible grid system includes: layout 1 column, layout 2 columns, layout 3 columns. You can change product's quantity per row to fit each screen.

    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.

    Choose "Yes" in params Show Facebook, Twitter, Google+, Linkedin 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

    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

    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 >> Menu Group (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.
    • 2. SM Cart Quick Pro

    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.

    3. SM Image Slider

    4. SM Basic Product


    Optimized Speed

    When your store is ready to go, you should set the Magento 2 in Production mode. Because it help you improve the performance of the store, improve security and ease of use.
    To change or set the Production mode, you can use the following CLI command in your SSH Terminal:
    php bin/magento deploy:mode:set {mode} [-s|--skip-compilation]

  • {mode} is required field;
  • --skip-compilation is an optional parameter you can use to skip code compilation when you change to production mode.
    • Following is a summary of messages that display:

    You’ll get the next messages:




    After changing the mode, you should clean the cache as well by running the following command:
    php bin/magento cache:clean

    How To Setup Currency?

    To setup currency, you can go to Store -> Configuration -> General -> Currency Setup. Set Allowed Currencies are the currency you want on your store:

    How To Setup Multi Languages?

    To setup multi languages, you can go to Admin -> Stores -> All Stores -> Create Store View

    Example with French:

  • Name: French
  • Code: fr
  • Status: Enable

    • How To Translate Languages?

    You can translate the interface lables into other languages. Example: To translate the interface into Arabic languages, follow these instruction:

  • Step 1: In admin panel, Go to Store >> Configuration >> General

  • Step 2: In folder code, go to app/design/frontend/Sm/marsech/i18n and open file ar_SA.csv

  • Step 3: Open ar_SA.csv file and make all required changes in your translation. File opened in a text editor might look like this:

    • The first column contains the original character strings. In the second column you can place your translation of each string.
  • Step 4: Because you use another language so you need to specify it along with the command like: php bin/magento setup:static-content:deploy ar_SA
    Note: Do not forget to change ar_SA to your own language tag.
  • Step 5: Well done! Please refresh the frontend of your store to see result.