Для пользователей
Установка Бесплатной Версии
Первый способ установки плагина:
- Скачайте плагин с сайта 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.
- Откройте админ-панель вашего сайта и проследуйте в Плагины.
- Найдите Плагин и нажмите Активировать.
Настройки
Настройки WooCommerce Cart Suggestions находятся здесь: админ-панель→ WooCommerce→ Cart Suggestions.
Глобальные настройки
Содержит глобальные настройки для Cart Suggestions (Товарный предложений).
- Пользовательский CSS
- Расположение – расположение на странице корзины товарных предложений
- Перед таблицей корзины
- После таблицы корзины
- После суммы товаров в корзине
- Перед таблицей корзины 2
- Перед содержанием страницы корзины
- После содержания страницы корзины
- Стиль – стиль предлагаемых товаров
- По умолчанию
- Изображение
- Изображение с названием
- Изображение с названием и указанной ценой
- Название
- Название с указанием цены
- Слайдер
- Слайдер с указанием цены
- Товаров на строку – количество товаров, которое будет отображаться в одной строке [1-10].
- Название предложений – название перед товарными предложениями.
- Максимальное количество предложений – максимальное количество товаров, которое может быть отображено на странице корзины.
- Вариации того же товара – удалить вариацию из предложений, если в корзине имеется другая вариация того же товара.
- Отключить Font Awesome – не загружать CSS-файл для Font Awesome на сайт. Отключите только в том случае, если вы не используете иконки Font Awesome в виджетах или у вас есть Font Awesome в теме.
- Версия Font Awesome – версия Font Awesome, которая будет использоваться в настройках и на лицевых страницах магазина. Пожалуйста, выберите версию, которая выбрана в вашей теме.
- Шорткод – [br_cart_suggestion title=”title” type=”default” count=4 add_to_cart=0 slide_count=4] – отображение товарных предложений
- Параметры:
- title – название (текст)
- type – тип отображение (default/image/image_title/image_title_price/title/title_price)
- count – количество товаров (количество)
- add_to_cart – отображение кнопки Добавить в корзину (1/0).
- slide_count – количество отображаемых товаров на строку или на слайде
- Параметры:
Предложения корзины
Добавление товарных предложений
- Для создания нового товарного предложение проследуйте к админ-панели→ WooCommerce→ Cart Suggestions→ Add Suggestion (Добавить).
- Условия:
- Товар
- Равно
- Не равно
- Категория
- Равно
- Не равно
- Включить подкатегории
- Атрибут товара
- Равно
- Не равно
- Выбрать атрибут:
- Тэг
- Категории товара
- Тэги товара
- Доставка товара
- Цвет товара
- Размер товара
- Бренды
- ==Любой==
- Простой товар
- Сгруппированный товар
- Внешний/Партнерский товар
- Вариативный товар
- Простой товар
- Возраст товара
- Равно
- Не равно
- Равно или меньше
- Равно или больше
- день(дней)
- Равно
- Цена со скидкой:
- Равно
- Не равно
- От – До
- Равно
- На распродаже
- Да
- Нет
- Бестселлеры
- Количество товаров
- Цена
- Равно
- Не равно
- От – До
- Цена товара
- С налогом
- Без налога
- Наличие на складе
- В наличии
- Нет в наличии
- По предзаказу
- В наличии
- Количество на складе
- Равно
- Не равно
- Равно или меньше
- Равно или больше
- Предзаказ разрешен:
- ==Любой==
- Да
- Нет
- ==Любой==
- Равно
- Всего продано
- Равно
- Не равно
- Равно или меньше
- Равно или больше
- Количество товара
- Равно
- Товар
- Дополнительные настройки Условий
- Режим Условий
- Корзина – условие проверяет все товары в корзине
- Каждый товар – условие проверяет каждый товар
- Режим Условий
- Товарные предложения корзины
- Предлагаемые товары
- Количество – ограничивает количество товаров, которое будет использовано для списка товаров из этого предложения
Custom CSS/JS
Содержит настройки для установки пользовательского CSS-кода, который будет добавлен на лицевые страницы.
- Пользовательский CSS – поле для пользовательского CSS. Содержит настройки пользовательского CSS кода, который будет отображен во внешнем интерфейсе. Пользовательский CSS – тот CSS, каким хотите его видеть вы.
- При загрузке страницы – поле для пользовательского Javascript, который выполнится при загрузке страницы.
Виджеты
Виджет WooCommerce Cart Suggestions
Виджет из плагина WooCommerce Cart Suggestions. Вы можете разместить этот виджет в любой области виджета, как и другие виджеты.

- Название – название виджета
- Количество товаров – максимальное количество товаров, которое может быть отображено на странице корзины
- Тип виджета – стиль предлагаемых товаров
- По умолчанию
- Изображение
- Изображение с названием
- Изображение с названием и ценой
- Название
- Название с ценой
- Слайдер
- Слайдер с названием
- Кнопка Добавить в корзину – отображать кнопку Добавить в корзину под товарами
- Товаров на строку – количество товаров на строку или на ползунок для типа ползунка [1-10]
Шорткод
[br_cart_suggestion] – шорткод для отображения предлагаемых товаров
Параметры:
- name – любой текст для названия
- type – типы виджетов:
- default – как и товары в магазине
- image – только изображения товаров
- image_title – изображение и название товаров
- image_title_price – изображение товара, название и цена
- title – только название товара
- title_price – название и цена товара
- count – количество товаров для отображения
- add_to_cart – отображение кнопки Добавить в корзину после товаров
- slider_count – количество товаров в строке или на один слайдер для типа слайдеров
Для разработчиков
Хуки-события
includes/functions.php
br_get_woocommerce_version()
Общественная функция для получения версии WooCommerce.
return string. woocommerce version
br_generate_product_selector($options)
Сгенерировать несколько селекторов товаров с поисковым полем.
- $options – массив с параметрами. Элементы:
- option – массив с id товаров
- block_name – уникальное имя
- name – имя, которое используется в качестве имени полей. Массив должен быть: “br_tabs[additional_product][products][]”.
- return – если false, то используется эхо для отображения HTML-кода. Если переменная имеет значение true, то возвращает HTML код в виде строки
return string or void. HTML code
woocommerce-cart-suggestions.php
Все эти функции находятся в классе BeRocket_cart_suggestion в качестве статических функций.
init ()
Функция инициализации скриптов.
admin_init ()
Функция инициализации скриптов и страницы настроек в админ-панели.
options ()
Добавить страницу параметров в админ меню.
br_get_template_part( $name = ” )
Получить часть шаблона (для шаблонов типа ползунка).
- $name – имя шаблона
Шаблоны по умолчанию помещаются в папку плагинов woocommerce-cart-suestions/templates.
Для перезаписи шаблона в папке темы создайте папку с именем woocommerce-cart_suggestion и поместите новый шаблон с таким же именем в эту папку.
after_cart ()
Функция отображения предложенных товаров на странице корзины
Хуки-фильтры
cart_suggestion_get_template_part
Шаблон, который используется в плагине.
Параметры
- template – ссылка на шаблон, который будет загружен
- name – имя шаблона
Использование
<?php
function change_cart_suggestion_get_template_part ( $template, $name ) {
//your code here
return $template;
}
add_filter( 'cart_suggestion_get_template_part', 'change_cart_suggestion_get_template_part', 10, 2 );
?>
cart_suggestion_widget_title
Название для виджетов и шорткодов
Параметры
- name – название для виджетов и шорткодов
Использование
<?php
function change_cart_suggestion_widget_title ( $title ) {
//your code here
return $title;
}
add_filter( 'cart_suggestion_widget_title', 'change_cart_suggestion_widget_title' );
?>
cart_suggestion_widget_count
Количество товаров для виджетов и шорткодов
Параметры
- count – количество предлагаемых товаров, которые могут быть отображены
Использование
<?php
function change_cart_suggestion_widget_count ( $count ) {
//your code here
return $count;
}
add_filter( 'cart_suggestion_widget_count', 'change_cart_suggestion_widget_count' );
?>
cart_suggestion_widget_type
Тип виджетов и шорткодов
Параметры
- type – тип виджетов и шорткодов
Использование
<?php
function change_cart_suggestion_widget_type ( $type ) {
//your code here
return $type;
}
add_filter( 'cart_suggestion_widget_type', 'change_cart_suggestion_widget_type' );
?>
cart_suggestion_widget_add_to_cart
Используйте кнопку Добавить в корзину или нет в виджетах и шорткодах
Параметры
- add_to_cart – может быть true или false
Использование
cart_suggestion_widget_slider_count
Количество товаров на строку или по слайдам для ползунков в виджетах и шорткодах
Параметры
- count – товаров на строку
Использование
<?php
function change_cart_suggestion_widget_slider_count ( $count ) {
//your code here
return $count;
}
add_filter( 'cart_suggestion_widget_slider_count', 'change_cart_suggestion_widget_slider_count' );
?>
Файлы
- woocommerce-cart-suggestions.php – основной файл плагина
- css – папка с CSS-файлами
- admin.css – стили для админ-панели
- colpick.css – стили для блока подборки цвета
- font-awesome.css – стандартные стили Font Awesome
- unslider.css – стили слайдеров JQuery
- fonts – шрифты Font Awesome
- includes – папка с дополнительными файлами PHP
- functions.php – общественные функции
- updater.php – BeRocket Updater для обновления плагинов с сайта BeRocket
- widget.php – виджет для отображения предлагаемых товаров
- js – папка с файлами Javascript
- admin.js – Javascript для настройки панели администрирования
- colpick.js – Javascript для палитры цветов в настройках панели администрирования
- unslider-min.js – слайдер JQuery плагина
- templates – шаблоны для настроек, стиля списка и кнопок
- settings.php – страница настроек плагина
- widget.php – шаблон виджета