Для пользователей
Установка Бесплатной Версии
Первый способ установки плагина:
- Скачайте плагин с сайта berocket.com или wordpress.org.
- Откройте админ-панель вашего сайта и проследуйте: Plugins (Плагины)→ Add new (Добавить новый)→ Upload plugin (Загрузить плагин).
- Нажмите Обзор, выберите загруженный zip-файл и нажмите Установить (Install).
- Нажмите Активировать плагин (Activate Plugin).
Второй способ установки плагина:
- Скачайте плагин с сайта berocket.com или wordpress.org.
- Откройте ваш сайт через FTP.
- Проследуйте в папку WordPress/wp-content/plugins folder.
- Извлеките файлы с загруженного zip-файла и скопируйте файлы в папку WordPress/wp-content/plugins.
- Откройте админ-панель вашего сайта и проследуйте в Плагины.
- Найдите Плагин и нажмите Активировать.
Бренды
Как добавить бренд?
- Откройте админ-панель сайта и проследуйте BeRocket→ Brands→ Все Бренды.

- Выберите нужные настройки и нажмите кнопку Добавить Новый Бренд(кнопка находится внизу страницы).

Настройки брендов
- Название – название бренда на вашем сайте.
- Слаг – пользовательский слаг бренда. “Слаг” это дружественная URL-версия названия. Обычно передается строчными буквами, цифрами и дефисами.
- Родительский бренд – родительский бренд. Вы можете назначить родительский термин для создания иерархии. Термин “джаз”, например, был бы родителем бибопа и биг-бэнда.
- Описание – описание бренда, может быть отображено на странице бренда. По умолчанию описание не видно; однако, некоторые темы могут его отображать.
- Иконка – маленькое изображение бренда, может быть отображено на странице бренда.
- Баннер – большое изображение бренда, может быть отображено на странице бренда.
- Категории – категории товаров бренда.
- Подсказка (всплывающее окно) – сообщение, которое может быть показано при наведении или нажатии мыши.
- Порядок – порядок выведения брендов.
- Рекомендуемы – показывает рекомендуемы товары первыми/ или только рекомендуемы товары.
- URL – ссылка на сайт бренда или внешний сайт.
Настройки
Глобальные настройки

Содержит общие настройки Товарных брендов.
- Использовать кэш – включить/выключить.
- Очистить кэш – очистить кэш.
*Кэш используется для ускорения загрузки страниц, он запоминает последнее состояние шорткодов и виджетов. После внесения изменений в шорткоды или виджеты нажмите кнопку “Очистить кэш”.
Список шорткодов и их атрибутов:
- Шорткоды:
- [brands_list] – список брендов:
- title – название списка брендов
- use_name – отображение названия бренда (1 or 0)
- per_row – количество столбцов для списка брендов (количество брендов в слайдере)
- hide_empty – скрыть бренды без товаров (1 or 0)
- count – максимальное количество брендов
- padding – отступы вокруг изображения и названия (по умолчанию: 3px)
- border_color – цвет границы в HEX (#FFFFFF – белый, #000000 – черный)
- border_width – ширина границы в пикселях
- slider – способ отображения: слайдер (1) или список (0)
- orderby – сортировка брендов:
- name – по названию
- count – по количеству товаров
- rating – по рейтингу брендов
- random – в произвольном порядке
- slug – по слагу бренда
- description – по описанию бренда
- order – порядок сортировки: по возрастанию (asc) или убыванию (desc)
- img – показывает изображение бренда (1 or 0)
- imgh – высота изображения бренда в пикселях или % (например, 50%, 100px; по умолчанию: 64px)
- imgw – ширина изображения бренда в пикселях или % (например, 50%, 100px; по умолчанию: 100%)
- img_fit – подгонка изображения бренда: ‘покрытие блока’, ‘помещение внутрь блока’ или ‘заполнение блока’, по умолчанию ‘покрытие блока’
- img_align – выравнивание изображения бренда к тексту: ‘сверху’, ‘слева’, ‘справа’ или ‘снизу’, по умолчанию ‘снизу’
- featured_first – показать рекомендуемые товары первыми (0 or 1)
- include – включить бренды к отображению (список id, например, include=’45,47,52,61′)
- exclude – исключить бренды из отображения (например, exclude=’45,47,52,61′)
- [brands_catalog] – список брендов, сгруппированных по названию или категориям
- title – название каталога брендов
- use_name – показать название бренда
- style – раскладка: ‘вертикальная’ или ‘горизонтальная’
- column – количество столбцов
- hide_empty – скрыть бренды без товаров (1 or 0)
- count – максимальное количество брендов
- orderby – сортировать бренды:
- name – по названию бренда
- count – по количеству товаров
- rating – по рейтингу бренда
- random – в произвольном порядке
- slug – по слагу бренда
- description – по описанию бренда
- order – порядок сортировки: по возрастанию (asc) или убыванию (desc)
- img – показывает изображение бренда (1 or 0)
- imgh – высота изображения бренда в пикселях или % (например, 50%, 100px; по умолчанию: 64px)
- imgw – ширина изображения бренда в пикселях или % (например, 50%, 100px; по умолчанию: 100%)
- img_fit – подгонка изображения бренда: ‘покрытие блока’, ‘помещение внутрь блока’ или ‘заполнение блока’, по умолчанию ‘покрытие блока’
- img_align – выравнивание изображения бренда к тексту: ‘сверху’, ‘слева’, ‘справа’ или ‘снизу’, по умолчанию ‘снизу’
- featured_first – показать рекомендуемые товары первыми (0 or 1)
- include – включить бренды к отображению (список id, например, include=’45,47,52,61′)
- exclude – исключить бренды из отображения (например, exclude=’45,47,52,61′)
- groupby – группировать бренды по:
- alphabet – названию брендов (по умолчанию)
- category – категориям брендов
- none – не группировать
- alphabet – названию брендов (по умолчанию)
- [brands_products] – список товаров для данных брендов (по ids или слагам)
- brand_id – один или больше товарных ID (например: brand_id=’12,34,35′)
- brand_slug – один или больше слагов брендов (например: brand_slug=’brand1,brand2,brand3′)
- Используйте только одну из этих опций: brand_id или brand_slug
- columns – количество столбцов в списке товаров. Может работать некорректно с некоторыми темами и плагинами.
- orderby – сортировать бренды:
- name – по названию бренда
- count – по количеству товаров
- rating – по рейтингу бренда
- random – в произвольном порядке
- slug – по слагу бренда
- description – по описанию бренда
- name – по названию бренда
- order – порядок сортировки: по возрастанию (asc) или убыванию (desc)
- [brands_info] – информация о брендах
- id – ID бренда
- type – тип информации: ‘name’, ‘image’ или ‘description’
- [brands_product_thumbnail] – изображение бренда для страницы товара
- post_id – товарный id
- width – ширина изображения (по дефолту: 35%)
- height – высота изображения (выборочно)
- position – стиль выравнивания элемента (по дефолту: справа)
- image – отобразить изображение бренда (если доступно) (1 или 0, по дефолту: 1)
- url – изображение-ссылка (1 или 0, по дефолту: 1)
- [product_brands_info] – информация об одном бренде доя одного товара
- product_id – товарный ID; его можно получить автоматически на странице этого товара
- type – вывести:
- name – название бренда
- image – изображение бренда
- description – описание бренда
- [brands_list] – список брендов:
Страница бренда

- Отобразить описание – включить/выключить.
- Иконка бренда – отобразить (включить/выключить):
- Ширина (px; %);
- Высота (px; %);
- Подгонка:
- Покрытие блока;
- Помещение внутрь блока;
- Заполнение блока;
- Нет.
- Покрытие блока;
- Выравнивание:
- нет;
- Слева;
- Справа.
- Баннер – отобразить (включить/выключить):
- Ширина (px; %);
- Высота (px; %);
- Подгонка:
- Покрытие блока;
- Помещение внутрь блока;
- Заполнение блока;
- Нет.
- Выравнивание:
- нет;
- Слева;
- Справа.
- Внешняя ссылка – отобразить (включить/выключить) (только если включена ссылка для бренда):
- Текст (например: Перейти на сайт бренда >>);
- Открыть в новой вкладке (включить/выключить).
Страница магазина

Страница магазина доступна только если включён аддон Показ Брендов.
- Отобразить бренд – включить/выключить;
- Размещение бренда:
- Перед всем
- После изображения
- После названия
- После цены
- После кнопки Добавить в корзину
- Отобразить в виде ссылки – включить/выключить;
- Изображение – отобразить (включить/выключить):
- Ширина (px; %)
- Высота (px; %)
- Подгонка:
- Покрытие блока;
- Помещение внутрь блока;
- Заполнение блока;
- Нет.
- Покрытие блока;
- Выравнивание по тексту:
- нет
- Слева
- Справа
- Сверху
- Снизу
- Пользовательский CSS изображения
- Название – отобразить (включить/выключить):
- Пользовательский CSS названия
- Размещение бренда:
Страница Продукта

Страница Продукта доступна только если включён аддон Показ Брендов.
- Отобразить бренд – включить/выключить;
- Размещение бренда:
- Перед всем
- После изображения
- После названия
- После цены
- После кнопки Добавить в корзину
- Отобразить в виде ссылки – включить/выключить;
- Изображение – отобразить (включить/выключить):
- Ширина (px; %)
- Высота (px; %)
- Подгонка:
- Покрытие блока;
- Помещение внутрь блока;
- Заполнение блока;
- Нет.
- Покрытие блока;
- Выравнивание:
- нет
- Слева
- Справа
- Пользовательский CSS изображения
- Название – отобразить (включить/выключить):
- Пользовательский CSS названия
- Размещение бренда:
Слайдер

Параметры слайдера для виджетов и шорткодов.
- Автозапуск – включить/выключить
- Скорость автозапуска – [число (мс)]
- Скорость смены слайдов – [число (мс)]
- Бесконечный автозапуск – включить/выключить
- Отображать стрелки – включить/выключить
- Бренды для прокрутки – [число]
- Режим смены слайдов – эффект затухания/скольжения.
- Сглаживание (определяет плавность изменения скорости слайдов):
- Линейное
- Ускорение – замедление – ускорение
- Ускорение
- Замедление
- Ускорение в начале – замедление в конце
- Кубическая кривая Безье [1-6]
- Остановить автопрокрутку при наведении курсора – включить/выключить.
- Отобразить точки – включить/выключить.
- Цвет точек – блок выбора цвета/по умолчанию.
CSS
- Отключить Font Awesome – не загружайте файл CSS для Font Awesome на сайт. Отключите его, только если вы не используете иконки Font Awesome в виджетах или у вас есть Font Awesome в вашей теме.
- Версия Font Awesome – версия Font Awesome, которая будет использоваться в настройках и на страницах магазина. Пожалуйста, выберите версию, которая в вашей теме.
- Пользовательский CSS – поле для пользовательского CSS. Содержит настройки пользовательского CSS кода, который будет отображен во внешнем интерфейсе. Пользовательский CSS – тот CSS, каким хотите его видеть вы.
Аддоны
Показ брендов – отображает текст и изображение брендов на странице магазина и на странице товара.
Виджеты
Каталог WooCommerce Brand
Каталог WooCommerce Brand (предыдущее название WooCommerce Brands by Name) – виджет для отображения списка брендов, сгруппированного по названиям и категориям. Разместите виджет в любом месте, отведенного для других виджетов.

- Название – название виджета с брендами.
- Отобразить текст – отобразить текст для брендов.
- Изображение:
- Отобразить – отображает иконки брендов.
- Ширина – ширина иконки бренда (px/%).
- Высота – высота иконки бренда (px/%).
- Подгонка:
- Покрытие блока
- Помещение внутрь блока
- Заполнение блока
- Нет
- Покрытие блока
- Выравнивание:
- Нет
- Слева
- Справа
- Нет
- Сортировать по:
- Алфавиту
- Количеству товаров
- Рейтингу
- Произвольно
- Разместить:
- По возрастанию
- По убыванию
- Показать количество товаров – включить/выключить.
- Скрыть бренды без товаров – включить/выключить.
- Показать рекомендуемые товары вначале – включить/выключить.
- Группировать по:
- Алфавиту
- Категории
- Не группировать
- Вкладка отобразить “Все” – включить/выключать.
- Раскладка:
- Вертикальная
- Горизонтальная
- Количество столбцов – [число].

Список WooCommerce Brand
Виджет для отображения брендов простым списком или слайдером. Разместите виджет в любом месте, отведенного для других виджетов.

- Название – название бренда.
- Отобразить текст – включить/выключить.
- Изображение:
- Отобразить – отображает иконки брендов
- Ширина – ширина иконки брендов (px/%)
- Высота – высота иконки брендов (px/%)
- Подгонка
- Покрытие блока
- Помещение внутрь блока
- Заполнение блока
- Нет
- Выравнивание:
- Нет
- Слева
- Справа
- Сортировать по:
- Алфавиту
- Количеству товаров
- Рейтингу
- Произвольно
- Разместить:
- По возрастанию
- По убыванию
- Показать количество товаров
- Скрыть товары без брендов
- Разместить рекомендуемые товары сверху
- Количество брендов в ряду – столбцы брендов. Количество брендов в слайдере (если включен)
- Отступы вокруг – отступы вокруг иконок брендов (по дефолту: 3px)
- Ширина границы – ширина границы вокруг каждого бренда
- Цвет границы – цвет границы вокруг каждого бренда (блок выбора цвета)
- Слайдер – включить/выключить (параметры слайдера настраиваются на странице настроек во вкладке Slider).

Описание WooCommerce Product Brands
Виджет для отображения информации о бренде.
Разместите виджет в любом месте, отведенного для других виджетов.

- Отобразить название – отображает название бренда.
- Отобразить иконку – отображает иконку бренда.
- Отобразить описание – отображает описание бренда.
- Ширина иконки – % (по умолчанию: 100%).
- Выравнивание иконки – выравнивание изображения:
- Нет
- Слева
- Справа

Для разработчиков
Хуки-события
includes/functions.php
br_get_woocommerce_version()
Общественная функция для получения версии WooCommerce
return string. woocommerce version
woocommerce-brand.php
Все эти функции находятся в классе BeRocket_product_brand в качестве статических функций.
init ()
Функция инициализации скриптов.
admin_init ()
Функция инициализации скриптов и настройки страницы в админ-панели.
options ()
Добавить страницу параметров в админ-меню.
br_get_template_part( $name = ” )
Получить часть шаблона (для шаблонов типа слайдера).
- $name – название шаблона
Шаблоны по умолчанию помещаются в папку плагина woocommerce-brand/templates.
Для перезаписи шаблона в папке темы создайте папку с именем woocommerce-product_brand и поместите новый шаблон с таким же именем в эту папку.
shortcode_brands_product_thumbnail ($atts)
- brands_product_thumbnail – шорткод
- $atts – атрибуты шорткода
shortcode_brands_info ($atts)
- brands_info – шорткод
- $atts – атрибуты шорткода
brands_by_name_shortcode ($atts) (brands_by_name_shortcode ($atts))
- brands_catalog (brands_by_name) – шорткод
- $atts – атрибуты шорткода
brands_list_shortcode ($atts)
- brands_list – шорткод
- $atts – атрибуты шорткода
products_shortcode ($atts)
- brands_products – шорткод
- $atts – атрибуты шорткода
Хуки-события
brands_info_before
Действие в шорткоде brand_info до HTML.
Параметры
- term – элементы таксономии брендов
- atts – атрибуты шорткода
Использование
<?php
function change_brands_info_before ( $term, $atts ) {
//your code here
}
add_action( 'brands_info_before', 'change_brands_info_before', 10, 2 );
?>brands_info_after
Действие в шорткоде brand_info после HTML.
Параметры
- term – элементы таксономии брендов
- atts – атрибуты шорткода
Использование
<?php
function change_brands_info_after ( $term, $atts ) {
//your code here
}
add_action( 'brands_info_after', 'change_brands_info_after', 10, 2 );
?>brands_letter_before_brands
Действие в шорткоде brands_catalog (brands_by_name) и в виджете WooCommerce Brand Catalog (WooCommerce Brands by Name) перед текстовым блоком.
Параметры
- letter – текущая буква
- atts – атрибуты виджета или шорткода
- random_class – класс текущего блока виджета или шорткода
Использование
<?php
function change_brands_letter_before_brands ( $letter, $atts, $random_class ) {
//your code here
}
add_action( 'brands_letter_before_brands', 'change_brands_letter_before_brands', 10, 3 );
?>brands_letter_after_brands
Действие в шорткоде brands_catalog (brands_by_name) и в виджете
WooCommerce Brand Catalog (WooCommerce Brands by Name) после текстовым блоком.
Параметры
- letter – текущая буква
- atts – атрибуты виджета или шорткода
- random_class – класс текущего блока виджета или шорткода
Использование
<?php
function change_brands_letter_after_brands ( $letter, $atts, $random_class ) {
//your code here
}
add_action( 'brands_letter_after_brands', 'change_brands_letter_after_brands', 10, 3 );
?>Хуки-фильтры
product_brand_get_template_part
Шаблон, который используется в плагине.
Параметры
- template – ссылка на шаблон, который будет загружен.
- name – название шаблона.
Использование
<?php
function change_product_brand_get_template_part ( $template, $name ) {
//your code here
return $template;
}
add_filter( 'product_brand_get_template_part', 'change_product_brand_get_template_part', 10, 2 );
?>shortcode_brands_product_thumbnail_return
HTML, который возвращается шорткодом brands_product_thumbnail
Параметры
- return – HTML код, который возвращается
- atts – атрибуты шорткода
Использование
<?php
function change_shortcode_brands_product_thumbnail_return ( $return, $atts ) {
//your code here
return $return;
}
add_filter( 'shortcode_brands_product_thumbnail_return', 'change_shortcode_brands_product_thumbnail_return', 10, 2 );
?>shortcode_brands_info_return
HTML, который возвращается шорткодом brands_info
Параметры
- return – HTML код, который возвращается
- term – элементы таксономии бренда
- atts – атрибуты шорткода
Использование
<?php
function change_shortcode_brands_info_return ( $return, $term, $atts ) {
//your code here
return $return;
}
add_filter( 'shortcode_brands_info_return', 'change_shortcode_brands_info_return', 10, 3 );
?>brands_by_name_shortcode_return
HTML, который возвращается шорткодом brands_catalog (brands_by_name)
brands_list_shortcode_return
HTML, который возвращается шорткодом brands_list
Параметры
- return – HTML код, который возвращается
- atts – атрибуты шорткода
Использование
<?php
function change_brands_list_shortcode_return ( $return, $atts ) {
//your code here
return $return;
}
add_filter( 'brands_list_shortcode_return', 'change_brands_list_shortcode_return', 10, 2 );
?>brands_products_shortcode_return
HTML, который возвращается шорткодом brands_products
Параметры
- return – HTML код, который возвращается
- atts – атрибуты шорткода
Использование
<?php
function change_brands_products_shortcode_return ( $return, $atts ) {
//your code here
return $return;
}
add_filter( 'brands_products_shortcode_return', 'change_brands_products_shortcode_return', 10, 2 );
?>Файлы
- woocommerce-brand.php – основной файл плагина
- css – стили плагина
- admin.css – стили для настроек плагина
- frontend.css – стили внешнего интерфейса
- slick.css – стили слайдера плагина JQuery
- includes – папка с дополнительными файлами PHP
- functions.php – общественные функции
- widget-catalog.php – виджет WooCommerce Brand Catalog (WooCommerce Brands by Name)
- widget-description.php – виджет WooCommerce Product Brands Description
- widget-list.php – виджет WooCommerce Product Brands
- base-widget.php – базовый виджет для WooCommerce Brand List и WooCommerce Brand Catalog
- js – папка с файлами Javascript
- admin.js – скрипты для настроек плагина
- catalog.js – скрипты для виджета WooCommerce Brand Catalog
- front.js – скрипты фронт-энда
- slick.min.js – библиотека Slick
- slider.js – скрипты слайдера
- templates – шаблоны для настроек, стиля списка и кнопок
- catalog.php – шаблоны внешнего интерфейса для виджета WooCommerce Brand Catalog (WooCommerce Brands By Name) и шорткода brands_catalog (brands_by_name)
- description.php – шаблоны внешнего интерфейса для виджета WooCommerce Product Brands Description и страницы описания брендов
- list-template.php – фронт-энд шаблон для виджета WooCommerce Brand List и шорткода brands_catalog (brands_by_name).

