Blocks and shortcodes

The Brands Filter is a block or shortcode that shows a complete list of all brands and gives you the possibility to filter them by name.

block

Below, you find the options of the block.

• Title: you can enter a custom title before this block
• Paginate items: choose whether to paginate the items or not
• Items per page: if you paginate items, you can choose how many items per page to show
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Enter the parent brand ID to show. All the sub-brands will be displayed. Leave empty to show all brands.
• Order by – choose here how to sort the displayed brands:
  • None
  • Name
  • Slug
  • Term ID
  • Description
• Order – if any order option has been selected, choose whether to sort them:
  • Ascending
  • Descending
• Show filters: choose whether to show or not letter filters just below the title.
• Show reset button: this will display a reset button, to quicky reset the filter.
• Show all filters or just filters with content (that include at least one brand).
• Show items count for each brand: this allows you to show a counter with the total number of products in each brand.
• Hide brands with no products: choose whether or not to hide brands that do not include any product.
• Shortcode style:
  • Default
  • Big header
  • Small header
  • Shadow
  • Boxed
  • Highlight

• Highlight color selector (available only for the Hightlight style and if the Show items count is enabled): this is the accent color of the counter items.

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘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 to ‘yes’ it only shows the brands of the current category.
• ‘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"]

The Brand Thumbnail is a block or shortcode that shows a list of all brands with a logo for each of them.

block

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Paginate items: choose whether to paginate the items or not
• Items per page: if you paginate items, you can choose how many items per page to show
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Enter the parent brand ID to show. All the sub-brands will be displayed. Leave empty to show all brands.
• Order by – choose here how to sort the displayed brands:
  • None
  • Name
  • Slug
  • Term ID
  • Description
• Order – if any order option has been selected, choose whether to sort them:
  • Ascending
  • Descending
• Hide brands with no products: choose whether or not to hide brands that do not include any product.
• Hide brands with no image: choose whether to show or hide brands without a logo image.
• Show brand name: choose whether to show or hide the brand name, so only the logo will show.
• Show average rating for products of the brand: this will show a genearal rating calculated out of the reviews rating of all products of the same brand.
• Columns: you can choose how many brands per row to show.
• Shortcode style:
  • Default
  • Shadow
  • Boxed
  • Borderless
  • Top border

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘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 shown 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"]

The Brand Thumbnail Carousel is a block or shortcode that shows a list of brands in a slider.

BLOCK

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Paginate items: choose whether to paginate the items or not
• Items per page: if you paginate items, you can choose how many items per page to show
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Enter the parent brand ID to show. All the sub-brands will be displayed. Leave empty to show all brands.
• Order by – choose here how to sort the displayed brands:
  • None
  • Name
  • Slug
  • Term ID
  • Description
• Order – if any order option has been selected, choose whether to sort them:
  • Ascending
  • Descending
• Hide brands with no products: choose whether or not to hide brands that do not include any product.
• Hide brands with no image: choose whether to show or hide brands without a logo image.
• Autoplay carousel on page load: this will automatically start the carousel when the page is loaded.
• Loop carousel: if set to yes, the brands carousel will start again from the beginning once it displays the last brand. If set to no, it will simply stop after the last brand.
• Slider direction: you can choose between horizontal and vertical.
• Show slider dots: choose whether to show the slider navigation or not.
• Carousel pagination style: choose between square or rounded dots.
• Show prev/next buttons: show the arrows to let users move to the next or previous brand logo in the slider.
• Prev/Next buttons style: square or rounded arrows.
• Show brand name: choose whether to show or hide the brand name, so only the logo will show.
• Show average rating for products of the brand: this will show a genearal rating calculated out of the reviews rating of all products of the same brand.
• Columns: you can choose how many brands per row to show.
• Shortcode style:
  • Default
  • Shadow
  • Boxed
  • Top border
  • Centered title
  • Square
  • Background

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘title’: shortcode title
• ‘autosense_category’: [yes / no] if set on ‘yes’ only products associated to current category will be shown 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.
• ‘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"]

The Brand Products Carousel is a block or shortcode that allows you to display products of one or more brands in a slider.

block

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Show only products of the selected brand: enable this option to dinamically show only the products of the current brand. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Products to show:
  • All products
  • Featured products
  • On sale products
• Items per page: choose how many products you will show.
• Order by – choose here how to sort the displayed brands:
  • Random
  • Post date
  • Product title
  • Product rate
  • Sales count
• Order – if any order option has been selected, choose whether to sort them:
  • Ascending
  • Descending
• Autoplay carousel on page load: this will automatically start the carousel when the page is loaded.
• Loop carousel: if set to yes, the brands carousel will start again from the beginning once it displays the last brand. If set to no, it will simply stop after the last brand.
• Slider direction: you can choose between horizontal and vertical.
• Show slider dots: choose whether to show the slider navigation or not.
• Carousel pagination style: choose between square or rounded dots.
• Show prev/next buttons: show the arrows to let users move to the next or previous brand logo in the slider.
• Prev/Next buttons style: square or rounded arrows.
• Show brand name: choose whether to show or hide the brand name, so only the logo will show.
• Hide free products: choose whether or not to hide free products from this block.
• Show hidden products: choose whether or not to hide free products from this block.
• Show a box containing a list of all matching brands for current product selection: it will show a box on top of the block with the names of the brands which products are displayed below.
• Columns: you can choose how many brands per row to show.
• Shortcode style:
  • default
  • square
  • round

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘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 navigation
• ‘pagination_style’: [round / square] graphic style for slider navigation dots
• ‘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 Select is both a block and a shortcode that adds a select dropdown with all your brands, so your users can select the brand and see the products in it.

block

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Paginate items: choose whether to paginate the items or not
• Items per page: if you paginate items, you can choose how many items per page to show
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Enter the parent brand ID to show. All the sub-brands will be displayed. Leave empty to show all brands.
• Order by – choose here how to sort the displayed brands:
  • None
  • Name
  • Slug
  • Term ID
  • Description
• Order – if any order option has been selected, choose whether to sort them:
  • Ascending
  • Descending
• Show items count for each brand: this allows you to show a counter with the total number of products in each brand.
• Hide brands with no products: choose whether or not to hide brands that do not include any product.

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘title’: [yes / no] shortcode title
• ‘autosense_category’: [yes / no] if set on ‘yes’ only brands associated to products belonging to the current category will be shown in category page.
• ‘category’: [slug / all] show brands of one or more product categories; you can specify more than one category slugs and separate them with commas (shoes,jacket) or select them all by specifying the value ‘all’ for the attribute.
• ‘show_count’: [yes / no] show the number of products associated to each brand
• ‘hide_empty’: [yes / no] hide brands with no products associated

Example

[yith_wcbr_brand_select title="Brand Select" hide_empty="no" show_count="yes"]

The Brands List is a block or shortcode that shows a list of all the brands available in your shop but without filters.

block

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Paginate items: choose whether to paginate the items or not
• Items per page: if you paginate items, you can choose how many items per page to show
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Enter the parent brand ID to show. All the sub-brands will be displayed. Leave empty to show all brands.
• Order by – choose here how to sort the displayed brands:
  • None
  • Name
  • Slug
  • Term ID
  • Description
• Order – if any order option has been selected, choose whether to sort them:
  • Ascending
  • Descending
• Show items count for each brand: this allows you to show a counter with the total number of products in each brand.
• Hide brands with no products: choose whether or not to hide brands that do not include any product.
• Shortcode style:
  • Default
  • Big header
  • Small header
  • Shadow
  • Boxed
  • Highlight

• Highlight color selector (available only for the Hightlight style and if the Show items count is enabled): this is the accent color of the counter items (yellow in the screenshot below)

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘title’: [yes / no]
• ‘pagination’: [yes /no] enable/disable brand pagination
• ‘per_page’: [int] number of brands to show at a time; enter the value “-1” if you want to show them all together
• ‘autosense_category’: [yes / no] if set to ‘yes’ it only shows the brands of the current category.
• ‘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.
• ‘show_count’: [yes / no] show the number of products associated to each brand
• ‘hide_empty’: [yes / no] hide free products
• ‘style’: [default / big-header / small-header / shadow / boxed / highlight] shortcode layout
• ‘highlight_color’: code for the colour to assign to shortcode text (available only if ‘highlighted’ style is selected)

Shortcode example

[yith_wcbr_brand_list title="Brand List" pagination="no" per_page="-1" show_count="yes" hide_empty="no" style="big-header" highlight_color="#ffd900"]

Brand Grid shows a grid with all or selected brands of your shop and allows you to sort and group them by category or name with filters as well.

block

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Show only brands of the current category: enable this option to dinamically show only the brands of the current category. This option is useful if you are displaying this block on a category page or on a filtered page.
• Enter the list of category slugs (separated with a comma) to show. Leave empty to show all categories. This option overrides the previous option.
• Enter the list of brand slugs (separated with a comma) to show. Leave empty to show all brands.
• Enter the parent brand ID to show. All the sub-brands will be displayed. Leave empty to show all brands.
• Show items count for each brand: this allows you to show a counter with the total number of products in each brand.
• Hide brands with no products: choose whether or not to hide brands that do not include any product.
• Columns: choose how many brands per row to show.
• Group brands by:
  • category
  • letter
  • do not group brands
• Show category filter? (Only when brands are grouped by name): this allows you to show category filters above the grid, so you can further filter the brands by category.
• Show name filter? (Only when brands are grouped by name)
• Show all letters in filter section (Only when brands are grouped by name)
  • Show only filters with contents, so letters that contain at least one brand.
  • Show all filters, regardless of whether they contain a brand or not.
• Category filter type(Only when brands are grouped by name and category filter is enabled)
  • Multiselect: allows you to select multiple category filters and show all brands in those categories.
  • Dropdown: allows you to select only one brand at a time.
    
• Category filter style (Only when brands are grouped by name and category filter is enabled)
  • Default
  • Shadow
  • Border
  • Round
• Preselected category (only when brands are grouped by name and the category filter is enabled). Leave empty to use “All” as default.
• URL format of Shop page filtered by brand & category (only when brands are grouped by name)
  • use plain brands URLs
  • use filtered URLs

Shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

• ‘title’: shortcode title
• ‘cols’: [int] number of columns for displaying products
• ‘show_count’: [yes / no] show number of products associated to each brand
• ‘hide_empty’: [yes / no] hide brands with no products associated
• ‘show_image’: [yes / no] show/hide brand image
• ‘hide_no_image’: [yes / no] hide brands with no images associated
• ‘show_name’: [yes / no] show/hide brand name
• ‘show_filtered_by’: [none / name / category] order brands according to their name or category. Enter ‘none’ if you do not want to have any classification.
• ‘show_category_filter’: [yes / no] show/hide shop category filter (attribute available only if the value for ‘show_filtered_by’ is ‘name’)
• ‘category_filter_type’: [multiselect / dropdown] filter type: you can choose among multiple select option or dropdown menu for products (this attribute is available only if the value for ‘show_filtered_by’ is ‘name’)
• ‘category_filter_style’: [default / shadow / border / round] layout for category filter (attribute available only if the value for ‘show_filtered_by’ is ‘name’)
• ‘show_name_filter’: [yes / no] show/hide a complete list of letters so that users can click on one of them and go immediately to the part of the page where brands with that letter are listed (attribute available only if the value for ‘show_filtered_by’ is ‘name’)
• ‘show_all_letters’: [yes / no] show/hide all letters (attribute available only if the value for ‘show_filtered_by’ is ‘name’ and if the value for ‘show_name_filter’ is ‘yes’)

Example

[yith_wcbr_brand_grid title="Brands Grid (multiselect - style 1)" cols="4" show_count="yes" show_image="yes" hide_empty="yes" hide_no_image="yes" show_name="yes" show_category_filter="yes" category_filter_type="multiselect" category_filter_style="default" show_name_filter="no" show_all_letters="yes"]

The Product Brand is both a block and a shortcode that allows displaying the brand(s) associated with a specific product.

block

Following you find the options of the block.

• Title: you can enter a custom title before this block
• Product ID (leave empty to use global product): if you enter a specific product ID here, the brands associated with that product will be displayed. If you use this shortcode on a product page, you can leave this field empty and it will automatically show the brands of the product you are viewing.
• Show logo: choose whether to show or hide the brand logo
• Show title: choose whether to show or hide the brand name

shortcode

The same options are available in the shortcode as attributes. Below you find all the attributes and their accepted values.

Shortcode attributes are:

• ‘title’: shortcode title
• ‘product_id’: product ID that will be used to retrieve brands; leave empty to use the global product, if defined
• ‘show_logo’: [yes/no] show or hide the brand logo
• ‘show_title’: [yes/no] show or hide the brand name

Example

[yith_wcbr_product_brand product_id="12345" show_logo="yes" show_title="yes"]