Shop by Brand
page last edited on 05 February 2018
The addon Shop by Brand is aimed at promoting branded goods.
With this addon finding products of specific brands/manufacturers becomes much easier for customers, especially first-time visitors who may not know what exactly they are looking for.
Depending on the X-Cart edition, your store may already have the addon Shop by Brand installed and enabled.
If not, it can be obtained via the X-Cart App Store. To install the addon, follow the steps described in Installing and Activating Addons.
Brands are based on the Product attributes feature, so to configure brands you will first have to deal with attributes. Namely, you will need to create a global attribute field that you will use for brands, or choose an already existing one - like “Brand” or “Manufacturer”. For example, here we already have a global attribute field “Manufacturer”:
We can use that one or choose to add a new field named “Brand” (or anything we want) using the New attribute button:
Once you have a global attribute field for brands, you need to tell the Shop by Brand addon that you are going to use this field for brands. This can be done using the setting Which global attribute field is the product brand? on the Shop by Brand addon settings page.
To access the addon settings page, find the addon Shop by Brand on the list of your store’s installed addons (My addons section) in the Admin area and click on the link to configure the addon settings (can be found next to the addon name and description).
Detailed information on the Shop by Brand addon settings is available at the end of this article.
After specifying one of your global attribute fields as the field for brands, you are all set to work on specific brands (brand names). For that you will need the section Brands available via the menu Catalog > Brands in your store’s Admin area. This section is where you add new brands and manage your existing brands.
Note that if your store already has product attributes configured for the global attribute field you have designated for brands, the Shop by Brand addon will treat them as previously created brand names. The addon will collect such attributes throughout your catalog and have them listed in the Brands section (Catalog > Brands) where you will be able to manage them.
Of course, you can create brands manually. To create a new brand:
Click New brand.
A new page with a form for providing brand informantion opens:
Specify the brand information:
Brand name: This is the only required field. Use it to specify the name of the brand.
Brand logo : Use this field to upload a logo image for the brand. Note that X-Cart does not impose strict limitations regarding the size of brand logo images that can be uploaded because it can resize and crop images automatically for best appearance. The dimensions to which the original image will be resized and cropped are set in the Images section of your store’s Admin area (Look&Feel -> Images; see the item Brand image (grid)).
These dimensions may be different depending on the skin used by your store and can be changed manually, if required. For more info on the management of images, including brand logo images, see the section Managing Images.
Description : Provide brand description (will be displayed on the page of the respective brand).
Meta keywords : Specify one or more brand related keywords (will be used in the keywords META tag on the brand page (for SEO purposes).
Meta description : Specify a description (will be used in the description META tag on the brand page - for SEO purposes).
Clean URL : Set the brand page Clean URL (will be used for SEO purposes).
Save the changes.
The brand will be added to the list of your store’s brands.
It is possible to edit the information of any existing brands, rearrange the order in which brands are displayed in lists or delete the brands you no longer require.
After creating the brands you require, you need to specify what products in your store belong to which brands. That is done by assigning the brand names to specific products as attribute values.
Your store visitors will be able to see your store’s brands on a dedicated Brands page (https://your_store_address/?target=brands):
A link to the Brands page is not included in the store’s menus by default. However, you may decide you want the link to be included. For example, here’s the link to the Brands page included in the store’s Primary menu:
To include the link in your store’s Primary menu, you will want to go to the Menus section of your store’s Admin area (Content > Menus), locate the “Brands” menu item on the Primary menu tab and enable it: If for some reason the Brands menu item is missing from the Primary menu tab page, you will want to add it manually as provided on the screenshot above. Should you require to add the Brands link to your store’s Footer menu, you will be able to do so using the same method, but will need to use the Footer menu tab instead of the Primary menu tab.
Besides the Brands page, your store will also have a dedicated menu block from which store visitors will be able to access products by the brand:
The Brands block is visible on category pages of the store catalog. If the store administrator chooses to enable its display on the Home page, it will be displayed on the store’s Home page as well.
If required, the administrator can change the Brands block location using Webmaster mode.
By default, the brands in the Brands block and on the Brands page are sorted alphabetically. The store administrator can change the order in which brands are displayed there via the Shop by Brand addon settings.
The Brands block and the Brands page on the storefront only display brands that have products with a greater than zero inventory. If you want brands with products that are out of stock to also be displayed, enable the option Show all for the setting How to show out of stock products in the Customer Zone settings section (Store setup > Cart & Checkout).
Any brands that do not have products assigned to them will not be displayed in any case.
Enabling the option Show all for the setting How to show out of stock products in the Customer Zone settings will affect not just the display of brands, but will enable the display of out-of-stock products throughout the store.
Which global attribute field is the product brand? This setting is for you to specify the global attribute field that should be used for brands. If you have any global attribute fields configured in your store, their names will be provided in the drop-down box as a list so you can select one of them. If you do not have any global attribute fields, you will need to create at least one so it will become available for selection here.
Order brands on the Brands page by: This settings determines the order in which brand names are listed on the Brands page. The available options are “Brand names” (alphabetically), “Admin-defined order” and “Number of products”.
Enable pagination on the Brands page: This should be enabled only if the store has a lot of brands.
Default number of brands per page: The number of brands to be displayed per page by default when a user views the store’s brands on the Brands page. (The user may choose to reset this number).
Show the Brands block on the home page: If enabled, the Brands block is displayed on the store’s Home page. If disabled, the Brands block is not displayed on the Home page.
Order brands in the Brands block by: This settings determines the order in which brand names are listed in the Brands block. The available options are “Brand names” (alphabetically), “Admin-defined order” and “Number of products”.
Number of items in the Brands block: Set the maximum number of brands to be displayed in the Brands block on the store front end. Brands over this number will be visible on the Brands page, to which a link will be provided at the bottom of the block.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.