Обрати сторінку

WooCommerce Brands

Для пользователей

Установка Бесплатной Версии

Первый способ установки плагина:

  1. Скачайте плагин с сайта berocket.com или wordpress.org.
  2. Откройте админ-панель вашего сайта и проследуйте: Plugins (Плагины) Add new (Добавить новый) Upload plugin (Загрузить плагин).
  3. Нажмите Обзор, выберите загруженный zip-файл и нажмите Установить (Install).
  4. Нажмите Активировать плагин (Activate Plugin).

Второй способ установки плагина:

  1. Скачайте плагин с сайта berocket.com или wordpress.org.
  2. Откройте ваш сайт через FTP.
  3. Проследуйте в папку WordPress/wp-content/plugins folder.
  4. Извлеките файлы с загруженного zip-файла и скопируйте файлы в папку WordPress/wp-content/plugins.
  5. Откройте админ-панель вашего сайта и проследуйте в Плагины.
  6. Найдите Плагин и нажмите Активировать.

Бренды

Как добавить бренд?

  • Откройте админ-панель сайта и проследуйте 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 – не группировать
    • [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 – по описанию бренда
      • 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 – описание бренда

Страница бренда

  • Отобразить описание – включить/выключить.
  • Иконка бренда – отобразить (включить/выключить):
    • Ширина (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.

Параметры

  1. term – элементы таксономии брендов
  2. 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.

Параметры

  1. term – элементы таксономии брендов
  2. 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) перед текстовым блоком.

Параметры

  1. letter – текущая буква
  2. atts – атрибуты виджета или шорткода
  3. 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) после текстовым блоком.

Параметры

  1. letter – текущая буква
  2. atts – атрибуты виджета или шорткода
  3. 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

Шаблон, который используется в плагине.

Параметры

  1. template – ссылка на шаблон, который будет загружен.
  2. 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

Параметры

  1. return – HTML код, который возвращается
  2. 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

Параметры

  1. return – HTML код, который возвращается
  2. term – элементы таксономии бренда
  3. 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

Параметры

  1. return – HTML код, который возвращается
  2. 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

Параметры

  1. return – HTML код, который возвращается
  2. 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).