Getting started with premium version

Go to YITH Plugins -> Brands to have access to the plugin settings dashboard.

general_settings

 

  • Product brand taxonomy: allows you to select the type of taxonomy you want to use as brands for your products.
    • Default brand taxonomy: all entries in Product -> Brands will be treated as brands; For further details, scroll the page to the Brand creation entry.
    • Product categories: all product categories will be treated as brands and for this reason, for each of them, you can set an image to show in detail page and the redirect link for users who click on the category name.
    • Product tags: all tags created for products in your shop will be treated as brands. Therefore, what has been said for categories goes also for tags.
    • Attributes: the option Product brand taxonomy includes all product attributes created. You can handle just one attribute at a time if they are treated as brands.
  • Product brand taxonomy rewrite:  allows you to change the taxonomy in the brand’s URL.
  • Single product brand position: you can choose where showing brands in product detail page.
  • Single product brand content: allows you to choose information of the brand that has to be shown to users in product detail page: brand and logo name or just one of them.
  • Product brand position in loop page: brand position in your e-commerce shop page
  • Loop product brand content: brand details are shown to users in shop page. As well as for the option Single product brand content, you can choose to display the following information for each brand: brand name and logo or just one of them.
  • Use brand default logo: allows you to upload a default logo that can be used, if the option is enabled, for all those brands that do not have any thumbnail image associated

How to create a brand

In order to create one or more brands, click on Brands that you can find in menu entry Products.

Fill out required fields to set a new brand.

  • Name: brand name to show to users.
  • Slug: slug associated to the brand.
  • Parent: parent brand of current brand.
  • Description: brand description, shown in brand detail page.
  • Thumbnail: image associated to the brand.
  • Banner: this is the image displayed on top of the Brand page
  • Custom URL: enter here a custom URL if you want the brand page to redirect to any other URL.

How to associate brand to product

If you have already created your brands, the only thing you have to do now is to assign them to your products.
Enter WooCommerce product detail page and select the brand you want to associate from section Brands as shown in the image below.

Select brand edit product page

In product detail page, brands will be shown immediately after the list with categories to which that product belongs.

Product detail page

Brand detail page

In order to access to a brand detail page, click on its name in product detail page.

Brand detail page

Brand detail page contains a description of the brand and products associated to it.

Insert brand in product permalink

The product permalink basic structure can be edited to dynamically insert the brand name associated to the product in the URL.

Go to “Settings -> Permalinks”, select the “Custom Base” entry and insert /product/%yith_product_brand%/ in order to recover the brand name.

 

The brand name is inserted in the product page URL.

Product permalink

Brand Filter shortcode

The shortcode Brand Filter shows a complete list with all brands and gives you the possibility to filter them by name.

Shortcode attributes are the following:

  • ‘title’ : shortcode title
  • ‘pagination’: [yes / no] enable/disable brand pagination
  • ‘per_page’: [int] brands shown at a time per page
  • ‘autosense_category’: [yes / no] if set on ‘yes’, in category page, only brands associated products belonging to that category will be shown.
  • ‘category’: [ids / all] it shows one or more product categories; you can specify more than one category slug and separate them using commas (10,20,12) or select them all by specifying the value ‘all’ for the attribute.
  • ‘show_filter’: [yes / no] it allows brand filter
  • ‘show_reset’: [yes / no] it allows filter reset
  • ‘show_all_letters’: [yes / no] it shows all letters to filter brands by name
  • ‘show_count’: [yes / no] show the amount of products associated to each brand
  • ‘hide_empty’: [yes / no] it hides brands that have no products associated
  • ‘style’: [default / big-header / small-header / shadow / boxed / highlight] style to assign to the shortcode
  • ‘highlight_color’: code for the colour to assign to the text in the shortcode (available only if ‘highlited’ style is selected)

Example

[yith_wcbr_brand_filter title="Brand Filter (default style)" pagination="no" show_filter="yes" show_reset="yes" show_all_letters="yes" show_count="yes" hide_empty="yes" style="default" highlight_color="#ffd900"]

Brand Filter shortcode

Brand Thumbnail shortcode

The shortcode Brand Thumbnail adds to your page a list with all brands and shows the logo for each of them.
Shortcode attributes are:

  • ‘title’: shortcode title
  • ‘pagination’: [yes /no] enable/disable brand pagination
  • ‘autosense_category’: [yes / no] if set on ‘yes’, only brands associated to products available in the selected category will be show in the category page.
  • ‘category’: [slug / all] show brands of one or more product categories; you can specify more category slugs and separate them with commas (shoes,jackets) or select them all by specifying the value ‘all’ in the attribute.
  • ‘per_page’: [int] number of brands to show at a time
  • ‘hide_empty’: [yes / no] it hides brands that have no products associated
  • ‘hide_no_image’: [yes / no] it hides brands that have no images associated
  • ‘cols’: [int] number of columns for displaying brands
  • ‘style’: [default / boxed / shadow / borderless / top-border] style for the shortcode

Example

[yith_wcbr_brand_thumbnail title="Brand Thumbnail (default style)" pagination="no" per_page="6" hide_empty="no" hide_no_image="no" cols="2" style="default"]

Brand thumbnail shortcode

Brand Thumbnail Carousel shortcode

The shortcode Brand Thumbnail Carousel allows you to show a list with brands in a slider.
Shortcode attributes are the following:

  • ‘title’: shortcode title
  • ‘autosense_category’: [yes / no] if set on ‘yes’ only products associated to current category will be shown in category page.
  • ‘category’: [slug / all] show brands of one or more product categories; you can specify more category slugs and separate them with commas (shoes,jackets) or select them all by specifying the value ‘all’ in the attribute.
  • ‘hide_empty’: [yes / no] it hides brands that have no products associated
  • ‘hide_no_image’: [yes / no] it hides brands that have no images associated
  • ‘direction’: [horizontal / vertical] sliding direction for the slider
  • ‘cols’: [int] number of brands to show at a time
  • ‘loop’: [yes /no] enable/disable looping continuously
  • ‘pagination’: [yes /no] enable/disable brand pagination
  • ‘pagination_style’: [round /square] graphic style of the pagination
  • ‘prev_next’: [yes /no] show/hide navigation buttons: ‘prev’ and ‘next’
  • ‘prev_next_style’: [round / square] style for ‘prev’ and ‘next’ buttons
  • ‘show_name’: [yes / no] show/hide brand name
  • ‘show_rating’: [yes / no] show/hide rating for each brand
  • ‘style’: [default / top-border / shadow / centered-title / boxed / squared / background] shortcode graphic style

Example

[yith_wcbr_brand_thumbnail_carousel title="Brand Thumbnail Carousel (style 2)" hide_empty="no" hide_no_image="no" direction="horizontal" cols="4" pagination="yes" pagination_style="round" prev_next="yes" prev_next_style="square" show_name="no" show_rating="no" style="shadow"]

Brand thumbnail carousel shortcode

Brand Product shortcode

The shortcode Brand Product shows shop products that are associated to one or more brands.
Shortcode attributes are the following:

  • ‘title’: shortcode title
  • ‘per_page’: [int] number of products to show per page; enter “-1” if you do not want product pagination
  • ‘pagination’: [yes /no] enable/disable brand pagination
  • ‘cols’: [int] number of columns for displaying brands
  • ‘brand’: [slug / all] product brands to show. You can specify more brand names by adding their slugs and separate them with commas or just specify ‘all’ if you want to show them all.
  • ‘category’: [categories] a list of valid comma separated category slugs, if you want to filter brands by product cat
  • ‘product_type’: [featured / on_sale / all] type of products to display
  • ‘orderby’: [rand / date / title / price / sales] sorting criteria for displayed products (random, date, name, price, discount)
  • ‘order’: [asc / desc] sorting direction (ascending or descending) subordinated to sorting criteria specified in the attribute ‘orderby’
  • ‘hide_free’: [yes / no] hide free products
  • ‘show_hidden’: [yes / no] show/hide ‘hidden’ products
  • ‘show_brand_box’ [yes / no] show/hide box shown on top of the shortcode where all brands are listed

Example

[yith_wcbr_brand_product pagination="yes" per_page="12" cols="4" product_type="all" orderby="rand" order="DESC" hide_free="no" show_hidden="no" show_brand_box="yes" brand="yith-shirts,yith-music,globe"]

Brand Products shortcode

Brand Product Carousel shortcode

The shortcode Brand Products Carousel allows you to display products associated to brands in a slider.
Shortcode attributes are following:

  • ‘title’: shortcode title
  • ‘per_page’: [int] number of products to show per page; enter “-1” if you do not want product pagination
  • ‘pagination’: [yes /no] enable/disable brand pagination
  • ‘pagination_style’: [round / square] graphic style for slider pagination
  • ‘category’: [categories] a list of valid comma separated category slugs, if you want to filter brands by product cat
  • ‘prev_next’: [yes /no] show/hide navigation buttons: ‘prev’ and ‘next’
  • ‘prev_next_style’: [round / square] style for buttons ‘prev’ and ‘next’
  • ‘cols’: [int] number of columns for displaying products
  • ‘direction’: [horizontal / vertical] sliding direction of the slider
  • ‘brand’: [slug / all] product brands to show. You can specify more brand names by entering their slugs separated with commas and specify the value ‘all’ if you want to show all brands.
  • ‘product_type’: [featured / on_sale / all] type of products to show
  • ‘orderby’: [rand / date / title / price / sales] sorting criteria for products shown (randoam, date, name, price, discount)
  • ‘order’: [asc / desc] sorting direction (ascending or descending) subordinated to sorting criteria specified in the attribute ‘orderby’
  • ‘hide_free’: [yes / no] hide free products
  • ‘show_hidden’: [yes / no] show/hide ‘hidden’ products
  • ‘show_brand_box’ [yes / no] show/hide brand for each product
  • ‘style’ [default / square / round] shortcode layout

Example

[yith_wcbr_brand_product_carousel title="Brand Products Carousel (style 3)" cols="4" per_page="12" direction="horizontal" pagination="yes" pagination_style="round" prev_next="yes" prev_next_style="round" product_type="all" orderby="rand" order="DESC" hide_free="yes" show_hidden="yes" style="round" show_brand_box="no"]

Brand Product Carousel shortcode