Ayo - Funiture Resposive Magento 2 themes!

Thank you for purchased our template. This document will guide you use this template. We recommend that you start reading the documentation at the first section. If you have questions about our template, please send us an email. We will support our best to help you!

Magento files structure

The theme package you have downloaded consists of several folders. Let's see what each folder contains:

  • Document -
    contains documentation files.
  • Themes Files
    contains: Base package, Database, Quickstart package(Included database)
    • Base package
      contains Magento theme files and directories that should be uploaded to the root directory of your Magento installation.
      • base_package_2.3.x.zip
        contains files and directories that should be uploaded to the root directory of your Magento installation.
        • base_package_2.3.x
          • app
          • lib
          • pub
          • var
      • patch_2.4.4.zip
        If you use magento version 2.4.4, please replace with folder app from folder patch_2.4.4.
        • patch_2.4.4
          • app
          • lib
      • patch_2.4.5.zip
        If you use magento version 2.4.5, please replace with folder app from folder patch_2.4.5.
        • patch_2.4.5
          • app
          • lib
      • patch_2.4.6.zip
        If you use magento version 2.4.6, please replace with folder app from folder patch_2.4.6.
        • patch_2.4.6
          • app
          • lib
      • patch_2.4.x.zip
        If you use magento version 2.4.0 or higher, You need do one more step, Upload and replace folder app from folder patch_2.4.x.zip
        • patch_2.4.x
          • app
    • Database -
      contains database file.
      • ayo.sql
        the database backup file. Contains the theme sample content.
    • Quickstart package(Included database)
      • ayo.zip
        contains the complete Magento installation package with engine files, theme and sample content.

Magento technology stack requirements


Magento 2.4.x technology stack requirements

You must install Elasticsearch before installing Magento Commerce or Magento Open Source 2.4.x. See Elasticsearch for details.

Please follow this link https://devdocs.magento.com/guides/v2.4/install-gde/system-requirements-tech.html

Magento 2.3.x technology stack requirements

Please follow this link https://devdocs.magento.com/guides/v2.3/install-gde/system-requirements.html

There are two ways to install Ayo Themes:

  1. Base package: Install only template: If you have a magento website and don't want to use our demo database, you can install only template.
  2. Quick-Start Package: Quick-start package is included Magento 2.3 and Ayo Themes. Supposing that you've just started building a Magento store, you can choose this solution to install demo store with all the sample data (similar to live demo of Ayo) and follow the instruction below.

BASE PACKAGE

1. Prepare Installation

In this guide, We assume that you already have Magento installed, so to prepare installation, you need to do the following steps:

  1. Backup your Magento source files and your store database

    Creating a backup is very imporant before installing theme, especially when you are working on a live site. Please don't ignore this step

  2. Disable all cache on your Magento site include:
    • Magento Cache (System > Cache Management)
    • Any additional cache on your server, for instance PHP cache engines, APC, ...
  3. Enable Maintenance mode for your store before uploading theme source.

2. Install

  1. Download our theme package files from themesforest.

    1.1. Extract this package, upload folders in Base package: app, lib, pub to the root directory ( www, public_html) of your magento folder. You can use a FTP software, such as FileZilla, then login to your hosting to do it.

    1.2. For 2.3.x version, upload and overwrite files in the base_package_2.3.x folder.

    1.3. For 2.4.x or higher version, continue upload and overwrite files in the patch_2.4.x.zip folder

    1.4. For 2.4.4 version, upload and overwrite files in the patch_2.4.4.zip folder.

    1.5. For 2.4.5 version, upload and overwrite files in the patch_2.4.5.zip folder.

    1.5. For 2.4.5 version, upload and overwrite files in the patch_2.4.6.zip folder.

  2. Make sure that you upload all theme folders and files successfully. You can disable Maintenance Mode for your store.
  3. Go to SSH on server then "cd" to root magento and run commandlines below:
    • php bin/magento indexer:reindex
    • php bin/magento setup:upgrade
    • php bin/magento setup:static-content:deploy -f
    • php bin/magento cache:flush
    • sudo chmod -R 777 var pub generated

3. Import static block and static page

You can import all Pages & Static Blocks. With only one click

Go to "RokanThemes => Import and Export"

Export

To export static block and static page, you can set options similar with import theme settings. Click Export Block, Export page to export all static block and all page.

Blocks exported will automatic save in folder "var": var/cms_blocks.xml, var/cms_pages.xml

Back to Content => Blocks/Pages, You'll see all Static Blocks/Pages were imported.

4. Set up Homepage, default theme:

  1. Defaut page: After importing all CMS Pages and Static Blocks, Please Go to Stores => Configuration => General => Web. Scroll down to Default Pages tab. In this Tab, choose the theme that you want to set it as your homepage and Save config.

  2. Default Theme: Go to Content => Configuration Edit store view. Then select theme that you want to use for your store. Don't forget to press Save configuration button to save your setting.

  3. Go to System => Cache management to clear cache.

Quick-Start Package

Quick-start package is included Magento 2 and Ayo Themes. Supposing that you've just started building a Magento store, you can choose this solution to install demo store with all the sample data (similar to live demo of Ayo) and follow the instruction below.

  1. Download package theme (zip file) from themesforset and upload ayo.zip in folder Quickstart package(Included database) to your website folder. You can use a FTP software such as FileZilla or Cpanel to upload
  2. Extract file: ayo.zip in folder Quickstart package(Included database) to your website folder where Magento is installed.
  3. Create new database and import database sample. You can use database management tool such as phpMyAdmin to do this step
    • Open your Browse and go to your phpmyadmin or database management tool.
    • Creat database:


    • Import database: Click database you have created. Press Import button. Choose and open file ayo.sql from folder Database. File may be compressed (gzip, bzip2, zip) or uncompressed.

    • Change site url:

      After imported database please access to core_config_data table, In this table you can see two value: web/unsecure/base_url and web/secure/base_url.

      Go to table core_config_data -> Click search


      change site url


      Scroll down then you will see "Value" Field you enter text: %http% after that you click "Go"



      change site url


      You will see 4 tables need to change url :



      change site url

    • Open file "app/etc/env.php" in your server and change database connect.
    • Run commandl line. You need login ssh and cd to root magento and run commands line below:
      • php bin/magento indexer:reindex
      • php bin/magento setup:upgrade
      • php bin/magento setup:static-content:deploy -f
      • php bin/magento cache:flush
      • chmod 777 -R pub var generated
    • Finsish install. Open a web browser and enter your domain.

Now you can go to admin page, follow this link: http://your-site.com/admin. Using account information bellow to login.

  • User name: demo
  • Password: admin@123456

You can see video install: https://www.youtube.com/watch?v=9BWgmushiHg

Ayo uses CMS Static Blocks and our module to display content of home page. With Static Blocks, you can add text, images, and can be assigned any page layout, group of pages. You can take a look at Homepage Diagram Blocks below, we show static blocks name (CONTENT => Blocks), products module that we use in homepage on the right.

You can change content of Static block in admin page: Content => Block. You have to keep HTML structure and class like below to make sure it don't break style.

Theme Option

After activating our theme, you can go to Rokanthemes => Theme settings to configure the theme. We will explain what you can do with Theme Options.

General setting

  • Auto Render Style Less: Auto render less css of theme.less when refresh page.
  • Page Width: Width of page.
  • Copyright: Copyright information (Show in footer).


Font setting

  • Custom Font: Choose: Yes to custom font.
  • Basic Font Size: Font size of body.
  • Basic Font Family: Font family of body. You can use google font or custom font.
  • Font Family - Custom Fonts: Put value if you use custom font. Select option if you choose google font.

Custom color

  • Custom Color: Choose: Yes to custom color.
  • Basic Colors:
    • Text Color: Color of text.
    • Link color: Color of link text.
    • Link Hover Color: Color of link text when hover.
  • Buttons:
    • Button Text Color: Color of text on button.
    • Button Background Color: Background color of button.
    • Button Hover Text Color: Color of text on button when hover.
    • Button Hover Background Color: Background color of button when hover.

Newsletter Popup

Change newsletter Popup settings in Rokanthemes => Theme settings

You can: enable or disable, set width, set height, background color or background images, change text, in here:

Slideshow

We created a very professional slideshow. You can create slideshows with multiple pages.

Home Page Slideshow

To Set up slideshow on homepage. Please going to Rokan Themes => Manager Slider then click button Add Slider

Choose store you want to show slider

like this image

There are all options related to Main Slishow in Setting Slider tab.

  • Autoplay: Auto run Hompage Slide Show on Main Page
  • Navigation: Show Button Option(True/False)
  • Stop On Hover: Set to 'True', if you want to pause the transaction when the slideshow is mouseovered.
  • Pagination: Show Button Next Back Option(True/False)
  • Scroll Per Page: Option(True/False)
  • Items: Show Number Items of Slideshow on home page.
  • Rewind Speed:Include Rewind Speed
  • Pagination Speed:Include Pagination Speed
  • Slide Speed: Include Slide Speed
  • Items Desktop: Show Slideshow items on Desktop
  • Items Desktop Small: Show Slideshow items on Desktop Small
  • Items Tablet : Show Slideshow items on Tablet

If you want to Edit Content and Images of Slideshow. Please going to Rokanthemes => Manage Slider Items Then looking for General tab you need setting:

  • Slider : Select slider your created in tab manager slider if have many slidershow.
  • Status : Enable/Disable
  • Image : Image Slideshow
  • Link Banner :Link banner when you click
  • Banner Text: Include Text banner

Custom menu

We released custom menu for Ayo Themes. This custom menu have many option you that can choose

1. Setting module

In admin page. Go to: Rokanthemes => Custom Menu

Menu setting

Enable: Choose Yes if you want custom menu.

Default Menu Type: This is type of menu that will be displayed if you choose Default type in the Menu type option in Catalog => Categories setting

Visible Menu Depth: Show number of submenu categories. For example, if you set this value to 2, only second level categories will be displayed.

Static Block(before): Set identifier of static block content that will be shown before the default category menu items and after home link.

Static Block(after): Set identifier of static block content that will be shown afer the default category menu items and after home link.

After set identifier of Static Block(before, after). Go to Content => Block and add new block. Make sure that this block have identifier same as identifier that you just set in Custom menu module. Click Show / Hide Editor or Edit with Page Builder on Magento version 2.4.3 to put html in.

Menu setting

You have to keep HTML structure and class like below to make sure it don't break style. If it has submenu, put this HTML tag

                            <div class="open-children-toggle"></div>
                            
after level-top to open submenu in mobile.

Menu setting

If you don't want to use static block in menu, make it empty.

Category Labels: This options are values in Category label and can be assigned to every category in Catalog => Categories => Category Label

Menu labe;

2. Custom submenu.

With this module, you can easy custom your submenu.

In admin page, go to: Catalog => Categories then select category that you want to custom submenu. Choose Enable Category and Include in menu. Scroll down, you will see custom menu option.

.

Let see what we can do!

Generate option.

.

Hide This Menu Item: Hide this category in main menu.

Menu Type: Type of submenu. We have three types of menu: Classic, Full width, Static menu.

- Classic submenu type: Simple menu, include only categroies.

- Full width submenu type: Submenu will be show full width (depend on design).

- Static width submenu type: You can manually set the width of the submenu by put an value in the box Static width.

Sub Category Columns: Column of sub category.

Float: Position of submenu: left or right.

Icon Image: Insert icon by upload images from your computer. It will be shown before category name in main menu.

Font Icon Class: You can input class of font icon on this (Note: Font icon must be included in code folder). With Ayo theme, we've already included: Font Awesome and IcoMoon icon font. You can go to their website, choose icon that you want, copy icon name and paste it to this input.

Add content to submenu.

With custom menu module, you can add text, images, video, iframe, html tags... into submenu. Let see how to do that.

We have 4 editors corresponding to 4 positions in the submenu: top, left, right, bottom. In this editors you can add content that you want to show in submenu. If you want to add html or insert images, it will be easier for you if you click WYSIWYG Editor

Left block width, Right block width: Width of right and left block compared to the total width of submenu.

If you don't want to add content in submenu. Please leave Editors top and bottom block empty and choose Do not show with Left block and Right block

Vertical menu

We released vertical menu for Ayo Themes. This vertical menu have many options that you can choose

1. Setting module

In admin page. Go to: Rokanthemes => Vertical Menu

Menu setting

Enable: Choose Yes if you want to use vertical menu.

Default Menu Type: This is type of menu that will be displayed if you choose Default type in the Menu type option in Catalog/Categories setting

Visible Menu Depth: Show number of submenu categories. For example, if you set this value to 2, only second level categories will be displayed.

Limit show more Cat: Total of category that you want to show on vertical menu, other will show when you click on all category or more category button.

Menu setting

Static Block(before): Set identifier of static block content that will be shown before the default category menu items

Static Block(after): Set identifier of static block content that will be last appearance on vertical menu

After set identifier of Static Block(before, after). Go to Content => Block and add new block. Make sure that this block have identifier same as identifier that you just set in Vertical menu module. Click Show / Hide Editor or Edit with Page Builder on Magento version 2.4.3 to put html.

You have to keep HTML structure and class like below to make sure it don't break style. If it have submenu, put this HTML tag

                            <div class="open-children-toggle"></div>
                            
after level-top to open submenu in mobile.

Menu setting

If you don't want to use static block in menu, make it empty.

Category Labels: This options are values in Category label and can be assigned to every category in Catalog => Categories => Category Label

Menu labe;

2. Vertical submenu.

With this module, you can easy setting your vertical submenu.

In admin page, go to: Catalog => Categories then select category that you want to using vertical submenu. Choose Enable Category and Include in menu. Scroll down, you will see vertical menu option.

.

Let see what we can do!

Generate option.

Hide This Menu Item: Hide this category in main menu.

Menu Type: Type of submenu. We have three types of menu: Classic, Full width, Static menu.

- Classic submenu type: Simple menu, include only categroies.

- Full width submenu type: Submenu will be show full width (depend on design).

- Static width submenu type: You can manually set the width of the submenu by put an value in the box Static width.

Sub Category Columns: Column of sub category.

Float: Position of submenu: left or right.

Icon Image: Insert icon by upload images from your computer. It will be show before category name in main menu.

Font Icon Class: You can input class of font icon on this (Note: Font icon must be included in code folder). With Ayo theme, we've already included: Font Awesome and IcoMoon icon font. You can go to their website, choose icon that you want, copy icon name and paste it to this input.

Add content to submenu.

With vertical menu module, you can add text, images, video, iframe, html tags... into submenu. Let see how to do that.

We have 4 editors corresponding to 4 positions in the submenu: top, left, right, bottom. In this ediors you can add content that you want to show in submenu. If you want to add html or insert images, it will be easier for you if you click WYSIWYG Editor

Left block width, Right block width: Width of right and left block compared to the total width of submenu.

If you don't want to add content in submenu. Please leave Editors top and bottom block empty and choose Do not show with Left block and Right block

In Ayo theme, we using only: Bottom Block

Testimonoials Module

Testimonal setting.

Go to admin page, Rokanthemes => Testimonoials => Settings to changes setting Testimonoials module. In here, you can change: Enable, disable module, title of Testimonoials, auto slider, item on destop, tablet, mobile, qty of this, background images....

Add new testimonal

Go to admin page, Rokanthemes => Testimonoials => Manage Testimonial and choose add new testimonial.

Blog post Module

Blog post setting.

Go to admin page, Rokanthemes => Blog => Blog setting. In here you can change: Enable, disable module, title blog slider (will show in homepage), Short description, items in destop, mobile, tablet, Sidebar of blog page...

Add new blog post.

Go to admin page, Rokanthemes => Blog => Posts and choose butoon Add new post.

Layered Ajax

Config Layered Ajax

Go to admin page, Store => Configuration => Rokanthemes => Layered Ajax. In here you can change: Enable, disable module, Open All Tab , Use Price Range Sliders

One Page Checkout

Config One Page Checkout

Go to admin page, Rokanthemes => One Page Checkout => Configuration.

Enable: Choose Yes if you want to add and show Terms and Conditions when customers check out.

Checkbox Text: Label show in check box.

Checkbox Content: Content of Terms and Conditions.

Title warning: Title warning when customers uncheck on Terms and Conditions check box.

Content warning: Content warning when customers uncheck on Terms and Conditions check box.

SuperDeals

If you want to using SuperDeals, first, you must enable this module in: Rokanthemes => Configuration => Super Deals Settings

ProductTab

Configuration setting:

Go to Admin => Rokanthemes => Configuration: You can customize Products configuration with the following product types:

  • New products.
  • Onesale produts.
  • Bestseller products.
  • Mostview products.
  • Feature products.
  • Price countdown products.
All of them have a similar setting structure. General Configuration for: Title, Description, OWL Product Carousels and set up to four breakpoints for different screen resolutions.

  • Enable : Enable/Disable Module.
  • Auto : Auto Play products carousels (Yes/No)
  • Title : insert text with the title design, leave the field empty if you do not want to display the title.
  • Description : Short descrition display after title.
  • Show Price : Enable/Disable the product price for products in the module.
  • Show Add To Cart : Enable/Disable Add to cart button.
  • Show Add To Wishlist : Enable/Disable Add to wishlist icon.
  • Show Rating : Enable/Disable Review option.
  • Qty Products: the total number of products to be loaded in the carousel.
  • Number Row Show: The number of rows will be displayed.
  • Items Default: Default qty of products items show in each of row.
  • Items On Desktop: Default qty of products show in each of row in destop (Min width: 992px).
  • Items On Desktop Small: Default qty of products show in each of row in destop small (Screen from: 769px to 991px).
  • Items On Tablet: Default qty of products show in each of row in tablet (Screen from: 480px to 768px).
  • Items On Mobile: Default qty of products show in each of row in mobile (Max width: 479px).
  • Show Next/Back control : Enable/Disable Nex/Back.
  • Show navigation control : Enable/Disable Navigation.

Category tab

If you want to using Category tab, first, you must enable this module in: Rokanthemes => Configuration => Category tab

To using it, go to Content => Block click Show/hide editor button or Edit with Page Builder button on Magento version 2.4.3 and choose Insert Widget

  • Title : Insert text with the title desired, leave the field empty if you do not want the title displayed.
  • Description : Short descrition display after title.
  • Enter From Price : Put value to filler price from.
  • Category Ids : Put id of your category that you want to show.
  • Slide columns Qty: The total number of products to be loaded in the carousel.
  • Items Default: Total products will be displayed.
  • Items On Desktop: Default qty of products show in each of row in destop (Min width: 992px).
  • Items On Desktop Small: Default qty of products show in eache of row in destop small (Screen from: 769px to 991px).
  • Items On Tablet: Default qty of products show in each of row in tablet (Screen from: 480px to 768px).
  • Items On Mobile: Default qty of products show in each of row in mobile (Max width: 479px).
  • Display Page Control : Enable/Disable Next/Back.

Display category tab on homepage: Go to static page and choose Insert Widget => Cms Static block and choose static block you just created

New Product

If you want to display New Product, When create product on Catalog => Products, you need set Set Product as New from Date. Like this image

Onsale Products

To set onsale product. When you create products Catalog => Products, you have to set special price for it. To set special price, please click Advanced Pricing below Price field.

Price count down products.

Similar with set onsale products, To set Price count down product you have to set special price for and you have to add Special Price From - To then choose Yes in Show Price count Down option.

Best Seller Product

Bestseller Product will automatic show when customer add products to cart and checkout success.

Mostviewed Product

Most Product: will automatic display products which are viewed most by customers in your store. It will highlight the Most Viewed Products to customers, so it attracts customers to buy these products.

Support

Again! Thank you for purchased our theme. If you have any questions that are beyond the scope of this help file, please send us a ticket to http://blueskytechmage.com/osTicket/ or You can Comment on system comment of this item.

If our theme catchs your requirements, please help us Vote Our Theme. Your ratings is goodness and encouraging us make more and more productions to end users. Thanks you so much!