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

WooCommerce Cart Suggestions

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

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

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

  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. Найдите Плагин и нажмите Активировать.

Настройки

Настройки 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 SuggestionsAdd Suggestion (Добавить).
  • Условия:
    • Товар
      • Равно
      • Не равно
    • Категория
      • Равно
      • Не равно
      • Включить подкатегории
    • Атрибут товара
      • Равно
      • Не равно
      • Выбрать атрибут:
        • Тэг
        • Категории товара
        • Тэги товара
        • Доставка товара
        • Цвет товара
        • Размер товара
        • Бренды
      • ==Любой==
        • Простой товар
        • Сгруппированный товар
        • Внешний/Партнерский товар
        • Вариативный товар
    • Возраст товара
      • Равно
      • Не равно
      • Равно или меньше
      • Равно или больше
      • день(дней)
    • Цена со скидкой:
      • Равно
      • Не равно
      • От – До
    • На распродаже
      • Да
      • Нет
    • Бестселлеры
      • Количество товаров
    • Цена
      • Равно
      • Не равно
      • От – До
      • Цена товара
        • С налогом
        • Без налога
    • Наличие на складе
      • В наличии
      • Нет в наличии
      • По предзаказу
    • Количество на складе
      • Равно
      • Не равно
      • Равно или меньше
      • Равно или больше
      • Предзаказ разрешен:
        • ==Любой==
        • Да
        • Нет
    • Всего продано
      • Равно
      • Не равно
      • Равно или меньше
      • Равно или больше
      • Количество товара
  • Дополнительные настройки Условий
    • Режим Условий
      • Корзина – условие проверяет все товары в корзине
      • Каждый товар – условие проверяет каждый товар
  • Товарные предложения корзины
    • Предлагаемые товары
    • Количество – ограничивает количество товаров, которое будет использовано для списка товаров из этого предложения

Custom CSS/JS

Содержит настройки для установки пользовательского CSS-кода, который будет добавлен на лицевые страницы.

  • Пользовательский CSS – поле для пользовательского CSS. Содержит настройки пользовательского CSS кода, который будет отображен во внешнем интерфейсе. Пользовательский CSS – тот CSS, каким хотите его видеть вы.
  • При загрузке страницы – поле для пользовательского Javascript, который выполнится при загрузке страницы.

Виджеты

Виджет WooCommerce Cart Suggestions

Виджет из плагина WooCommerce Cart Suggestions. Вы можете разместить этот виджет в любой области виджета, как и другие виджеты.

This image has an empty alt attribute; its file name is Widgets_‹_BeRocket_Development_—_WordPress_-_2016-06-01_13.58_.15_.png
  • Название – название виджета
  • Количество товаров – максимальное количество товаров, которое может быть отображено на странице корзины
  • Тип виджета – стиль предлагаемых товаров
    • По умолчанию
    • Изображение
    • Изображение с названием
    • Изображение с названием и ценой
    • Название
    • Название с ценой
    • Слайдер
    • Слайдер с названием
  • Кнопка Добавить в корзину – отображать кнопку Добавить в корзину под товарами
  • Товаров на строку – количество товаров на строку или на ползунок для типа ползунка [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

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

Параметры

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

Название для виджетов и шорткодов

Параметры

  1. 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

Количество товаров для виджетов и шорткодов

Параметры

  1. 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

Тип виджетов и шорткодов

Параметры

  1. 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

Используйте кнопку Добавить в корзину или нет в виджетах и шорткодах

Параметры

  1. add_to_cart – может быть true или false

Использование

cart_suggestion_widget_slider_count

Количество товаров на строку или по слайдам для ползунков в виджетах и шорткодах

Параметры

  1. 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 – шаблон виджета