Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Thank you for purchasing our extension. If you have any questions that are beyond the scope of this document, please feel free to contact us, we will be happy to assist

Created: 22/06/2016 Updated: 2nd August 2021 | By: Magenest | Email: [email protected] | Shop By BrandSupport Portal:  http://servicedesk.izysync.com/servicedesk/customer/portal/21

Table of Contents


Introduction

Image RemovedImage Added

Shop By by Brand Extension for Magento 2 is a powerful tool to boost sales by allowing customers to choose products from brands they want to buy.

Key Features

for Magento 2 helps merchants to showcase products by brand, taking advantage of familiar brand names to customers to create more sales. Also, the extension shortens the buying journey by letting customers find out products of their favorite brands easily.

Key Features

For admin

  • Show brands on brands page, brand detail page, product list and product detail page
  • Create multiple brand groups to classify and manage
  • Easily create new brandsEasily create the new brand, including: brand name, logo, banner,  slogan description and more
  • Allow admin to add products when creating the new brand
  • Allow admin to add an existing product into Add products to a brand
  • Allow admin to show product with the brand name
  • The dashboard displays the percentage of brands (using pie chart) that contain the product
  • The dashboard displays total order of brands, contribution of each brand (calculation based on product price).

  • Allow admin to show brand icon in product list

  • Allow admin to show featured product and featured brand
  • Allow customers to search for the brand

System Requirements

 Your store should be running on Magento 2 Community Edition version 2.2.x, 2.3.x or Magento 2 Enterprise Edition version 2.2.x, 2.3.x.

  • Show brand with multiple display mode: icon, brand name or both
  • Show featured brand list and featured product list
  • Edit the title for featured list
  • Add short description and detail description for brand
  • Show number of products on each brand
  • Set image for brand logo and banner on brand page 
  • SEO setting for brands page
  • Export Brands using MassAction and Magento’s Export function

For Customers

  • View brands on brands page, brand detail page, product list and product detail page
  • Hover to the brand icon to view brand short description
  • View detail information of a brand on the brand detail page
  • Search for brands by the search box or brand group
  • View featured brands and featured product list
  • View the number of product on each brand
  • View products of the same brand on product page

System Requirements

 

Your store should be running on Magento Open Source version 2.3.x, 2.4.x or Adobe Commerce version 2.3.x 2.4.x.




Configuration

(plus) On

Configuration

On the admin sidebar, go to Shop By Brand > Settings to set the general configuration for the extension. On the Configuration page:

General

This section contains the setting for the brands on the main menu and product pages.

  • Add All Brands
  • page Link to Main Menu
  • category to main menu: Choose Yes to add Brands tab on the main menu.
  • Menu
  • Title of All Brands category on main menu: Enter the name of the brands tab on the main menu. The default title
  • "
  • Brands
  • "
  • will be shown if this field is left blank.
  • Display brand icons on product listing page: Choose Yes to display the brand icon on each product on product listing page.
  • Display brand icons on product detail page: Select a layout for the brand information on product detail page.

Image Removed

(plus) Brand Detail Page 

  • Display Featured Products: Enable the featured products to display for each brand
  • Title featured products: The title displayed for Feature products section
  • Display Featured Brands: To enable the popular brands to display on Brands page
  • Title featured brand: The title of the popular brands section
  • Display brands list: Show brand list in alphabet order

Image Removed

(plus) Product Detail:

You have 4 options for display mode:

  • No: Disable this option
  • Show brand name
  • Show brand icon
  • Show brand name and icon

(plus) Product Listing

Display Icon Brand in Product List: To show brand icon in each product on product listing page

(plus) All Brand Page Setup

  • URL Key: URL of Brands page
  • Title: Title displayed on Brand Page
  • Meta keywords
  • Meta description

Image Removed

Main Functions

Backend 

  • Dashboard

Go to Shop By Brand > Dashboard, admin can view the charts reporting the percentage of each brand in store (pie chart) and the total order of the brands in store (bar chart)

 

Image Removed

  • Create a new group

In admin panel, go to Shop By Brand > Manage Groups

Click on Add new group button to create a brand attribute.

Image Removed

In the New group page, fill in the brand attribute title and choose Enable.

Then click on Save Group to create the new brand attribute.

Image Removed

 The brand attributes created will be displayed on the front end as follows

 Image Removed

 

 

  • Create a new brand

Go to Shop By Brand > Manage Brands

You can add new brand by clicking on Add New Brand button, or import the brand list by clicking on Import.

Image Removed

  1. Add New Brand button

There are 4 tabs: General, Images, Products, Brand Page

(plus) General:

  • Title: The brand name
  • Status: Enable brand rule
  • Featured: Enable showing the featured products of the brand
  • Store Views: Choose All Store Views or a certain store that you want. 
  • Group: Choose one or more brand groups/attributes

 

Image Removed

(plus) Images: Admin can upload logo of the brand on Brand Page, and in Brand Detail, as well as Banner displayed on Brand Page

Image Removed

(plus) Products: 

To add the products to the brand, you select the products in the grid table then click on Add Product button.

Image Removed

 

(plus) Brand Page: You can update the brand information in this tab, including the title, URL, slogan, description, meta keywords, meta description.

 

Image Removed

Please Save button to create new brand.

2. Import brand list

When clicking on Import button, you will be directed to a page where you can upload the brand list using csv or xml file.

You can download the sample file here SampleFile.csv

Image Removed

 

  • Add products into the brand

There are 2 ways to add a product into a brand: adding when the brand is created (see in Create a new brand section), adding in each product setting.

Image Removed

To add the products in the product setting, you can go to Products > Catalog then choose the product.

In the product info page, scroll down to Brand Product tab, you can choose the brand from Product Brand.

Image Removed

  • Create the widget displays brand list

Go to Content > Pages, choose to edit the page you want to show the widget. For example, here we choose the Home Page.

In the Content section, click on Insert Widget button

Image Removed

Choose the Widget Type as List Brand

Image Removed

Frontend 

  • Brand Listing Page

Customers only click on Brand on menu bar to view all of brands or choose a brand from the drop-down list.  

 

Image Removed

Click on Brands, it will direct customer to the Brand page

The brands can be group by brand attributes (Kid's, Men's, Women's)

The popular brands (Featured brands) will be shown with logos and names.

All of the brands will be displayed in Alphabet order.

Image Removed

 

  • Brand detailed page 

When customers click on any brand at front end such as Nike, the brand detailed page will be shown.
It will show all of things related this product, including: logo, banner, slogan, all of products belongs to this brand and more.

Image Removed

 

  • Product details page

When customers buy a product, at this product details page will be shown the brand name if  this product belongs to any brands.            

Image Removed

  • Show widget on any page

    The brand list widget will be shown according to the sort order number.
  • There are four options: No, Brand name only, Icon only, Brand name and icon.

Image Added

  • Front-end layout

  (plus) International Brands tab could be renamed from the back-end


Image Added
(plus) Brand icon 650pxon the product list

Image Added
(plus) Brand icon on the product on product detail page

Image Added



All Brand Page Setup

In this section, admin can set the layout for the brands list page.

  • URL Key: Set url rewrite key for brand listing page. Customer can access the the page using the following format: <domain_name>/<url_key>/
  • Meta Title: Set meta title for brand listing page.
  • Meta keywords: Set meta keywords for brand listing page.
  • Meta description: Set meta description for brand listing page.
  • Display Featured Brands list: Choose Yes to display the most-popular-brand list at the top of Brands listing page.
  • Title of Featured Brands list: Name the title for the featured brands list.
  • Display All Brands list: Select a layout for the brand information on brand list page.
    • There are two options: Brand name only and Brand name and icon.
  • Title of All Brands list: Set header for the brand list section of Brand listing page
  • Display product quantity of each brand: Choose Yes to display the items quantity along with each brand icon on the all-brand list.
  • Sort order of All Brands list: Set sort order of the brand list.
    • There are two options: Number first and Character first.

Image Added

  • Front-end layout

Image Added

Image Added

Image Added

Brand Detail Page Setup

This section contains the settings for the Brand detail page.

  • Display Featured Products list: Choose Yes to enable the featured products list on the Brand detail page.
  • Title Of Featured Product list: Name the title for the featured products list.

Image Added

  • Front-end layout

Image Added





Manage Groups

Before creating new brands, admin need to create groups to classify the brands.

(plus) On the admin sidebar, go to Shop By Brand > Manage Groups.

(plus) On Brand Groups page, admin can delete or change status of the available groups.

(plus) To create a new group, click Add New Group button.

Image Added

(plus) On New Group page, set name and status for the new group. Then click Save Group button to save.

Image Added





Manage Brands

(plus) On the admin site bar, go to Shop By Brand > Manage Brands.

(plus) On the Manage Brands page, admin can edit or delete the available brands on the list grid.

(plus) MassAction can be used to delete, export, toggle status or Featured Brand attribute of multiple brands.


Image Added


Create a new brand

To create a new brand, click Add New Brand button. On the New Brand page:

(plus) General

  • Title: Set a name for the new brand.
  • Status: Choose Yes to activate the brand.
  • Add to Featured Brands: If choose Yes, the brand will be added to the featured brands list.
  • Display same-brand products in Product Page: Choose Yes to display other products from the same brand on Product page.
  • Display limit:
    • Only appear when Display same-brand products in Product Page is enabled.
    • Set the maximum number of same-brand products displayed in the product page.
  • Store Views: Select a store view for the brand.
  • Group: Assign the brand to one or several groups.

Image Added

  • Same brand section in Product Page (with Display limit of 10):

Image Added

(plus) Images

Logo in Brand Page: Set the brand logo on brands page. 

Logo in Brand Detail: Set the brand logo on brand detail page.

Banner: Set the banner on brand detail page.

Image Added

Front-end layout


Image Added


Image Added

(plus) Products

Select products to add to the new brand.

When editing a brand, in case admin want to add more products to the available list, click on Add Product button then select products to add.

Image Added

(plus) Brand Page

Setup the detail page for the brand.

Page Title: Title in the header html.

URL Key: The URL Key for marketing purposes.

Short Description: A short description for the brand. This description will display when users hover on the brand icon.

Brand Description: A detailed description for the brand using the.

Meta keywords, Meta description: Search Engine Optimization for the brands page.

(plus) Click Save to save the brand.

Image Added

(plus) Related Brand

Select brands to add to the new brand. These brands will be displayed in the Related Brand section on the frontend.

When editing a brand, in case the admin wants to add more brands to the available list, click on the Add Brand button then select brands to add.

Click Save to save the brand.


Image Added

Import Brand

On the admin site bar, go to Shop By Brand > Import Brand

(plus) Import Settings

Entity Type: Select Magenest Shop By Brand Import. Then press Download Sample File and modify the content accordingly.

Image Added

(plus) Import Behavior

Import Behavior: Set Import Behavior to one of the following: Add/Update    Replace     Delete

Validation Strategy: To determine what happens when an error is encountered when importing data, choose one of the following: Stop on Error   or  Skip error entries

Allowed Errors Count: Enter the number of errors that can occur before the import is canceled.

Field separator: Accept the default value of a comma (,).

Multiple value separator: Accept the default value of a comma (,).

Fields enclosure: If you want to enclose any special characters that might be found in the data as an escape sequence, select the Fields Enclosure checkbox.


Image Added

(plus) File to Import

Select File to Import: Find the CSV file that you prepared to import and click Open.

Images File Directory: Enter the relative path to the location on the Magento server where uploaded images are stored.

Image Added

Then click the Check Data button and wait a few moments for the validation process to complete. If the import data is valid, the following message appears:


Image Added

If the file is valid, click Import


Image Added

Export Brand

Aside from MassAction export in management grid, brands can be exported using Magento’s Export function.

On the admin sidebar, go to Shop By Brand > Export Brand list > select Magenest ShopByBrand in Entity Type.

(plus) Entity Attribute: Filter to-be-exported brands

  • Filter column: Select an attribute to filter brand list.
    • You have to select at least 1 filter for the export function. If you wish to export all brands, only select the Please select attribute in Brand Names attribute label.
  • Exclude column: This is a reverse filter. Instead of exporting Brands that matched selected filters, Brands that don't match the selected filter will be exported.
    • Example: If we select Nike brand in Brand Name
      • Without exclude checkbox, only the brand Nike will be exported.
      • With exclude checkbox, all brands except Nike will be exported.

Image Added

Select the filter you want, then click on Continue button to proceed.

Depending on the current Magento version, you will receive the export file right away, or the export request will be added to queue to be processed later.

  • If export request is added to queue, admin should receive a notification once the export process is complete and the file is ready to download:

Image Added

  • The queue processor can be executed immediately with Magento CLI, using the following command:
    bin/magento queue:consumers:start exportProcessor

Add brands list widget

On the admin site bar, go to Content > Widget.

Click Add Widget button

Type: Select List Brand

Design Theme: Select the theme to which the widget will be applied.

           Then press the Continue button.

Storefront Properties: Config widget name and where the widget will show up.

Image Added


(plus) Widget Options: 

Number of Brand: Brand number will show up on widget.
Sort Brand By: Choose sort order brands. There are 2 options: Ascending and Descending.


Image Added

On frontend layout:

Image Added


Main functions on the front-end

View brands page

On the store, customer can view a separate page for all available brands.

Image Added

Search for a brand

(plus) Search by brand name: Customers enter a brand name on the search bar to find the brand.

Image Added

(plus) Search by group:  Select a group and all the brands on the group will display on the list below. 


Image Added


View featured brand list

The featured brands list is displayed on a slider.

Image Added

View product quantity on each brand

Customers can view the number of products on each brand.

Image Added

View brand detail page

Customers can click on a brand to view the detail page of it.

Image Added

View featured product list

Customers can view a list of featured product on the brand page. This list is set by admin from the back-end.

Image Added

View brand icon and short description on products list

On the product list, the short description will display when customers hover on the brand icon of a product.

Image Added


View related brand

Customers can view a list of related brands on the brand page. 

Image Added

View brand icon and short description on product detail page

On the product detail page, the short description will display when customers hover on the brand icon.

Image Added

Image Removed


Update


When a bug fix or new feature is released, we will provide you with the updated package.

All you need to do is repeating the above installing steps and uploading the package onto your store. The code will automatically override.

Flush the configure cache. Your store and newly installed module should be working as expected.

 



Support

We will reply to support request within 2 business days.

We will offer lifetime free update and 6 months free support for all of our paid products. Support includes answering questions related to our products, bug/error fixing to make sure our products fit well in your site exactly like our demo.

Support DOES NOT include other series such as customizing our products, installation and uninstallation service.