WooCommerce Wish/Wait List

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

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

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

Скачайте плагин с сайта 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 Wish/Wait List находятся здесь: админ-панель→WooCommerce→Wish/Wait List.

Глобальные настройки

Содержит общие настройки для страницы Wish/Wait и кнопок.

Только для залогиненых пользователей – при включенной настройке, кнопки Wish/Wait будут отображаться для клиентов которые вошли в свой аккаунт.
Страница списка желаний – страница для отображения товаров из списка желаний.
Страница списка ожидания – страница для отображения товаров из списка ожидания.
Отключить кнопку списка желаний – отключить кнопки списка желаний под товарами.
Отключить кнопку списка ожидания – отключить кнопки ожидания под продуктами.
Включить всплывающее окно об использовании файлов cookie – при включении настройки отображается всплывающее окно об использовании файлов cookie.

Стиль

Содержит настройки для визуальной настройки кнопок списка желаний/ожидания.

Размещение кнопок – место, где список желаний; список ожидания; список желаний/ожидания будет размещен:
- Перед всем
- После изображения
- После названия
- После цены
- После кнопки Добавить в корзину
- На странице единичного товара
Иконка кнопки списка желаний – иконка для кнопки, которая добавляет товар в список желаний (Загрузить/ Font Awesome/ Удалить)
Иконка кнопки списка ожидания – иконка для кнопки, которая добавляет товар в список ожидания (Загрузить/Font Awesome/Удалить).
Иконка обновления статуса – иконка для кнопок при добавлении в список желаний/ожидания.
Стили кнопок – настройки кнопок для добавления в список желаний/ожидания в разных состояниях: исходное состояние, при наведении курсора мыши, при нажатии, при наведении курсора при нажатии:

Стиль двойных кнопок списка желаний/ожидания:

Стиль списка желаний/ожидания – настройки для разных блоков списка желаний/ожидания:
- Блок товаров – стиль для блока со всеми товарами
- Блок товара – стиль для блока с каждым товаров
- Название товара – стиль для названия товаров
- Название товара при наведении курсора мыши
- Цена – стиль для цены товаров
- Нет в наличии – стиль для блока “Нет в наличии”
- Кнопка “Удалить” – стиль кнопки удаления товаров
- Кнопка “Удалить” при наведении курсора мыши

Дополнительные настройки для настроек, перечисленных выше в Стиль списка желаний/ожидания.

Стиль списка желаний/ожидания
- Размер шрифта
- Цвет шрифта
- Цвет фона
- Ширина границы
- Цвет границы
- Радиус скругления
- Ширина
- Высота
- Отступ сверху в середине кнопки
- Отступ снизу в середине кнопки
- Отступ слева в середине кнопки
- Отступ справа в середине кнопки

Текст

Содержит настройки для настройки пользовательского текста на кнопках и в таблицах.

Текст перед списком желаний – текст, который отображается перед таблицей с товарами в списке желаний.
Текст перед списком ожидания – текст, который отображается перед таблицей с товарами в списке ожидания.
Текст на кнопке, чтобы показать все товары из списка желаний – текст на кнопке внизу на таблице желаний [Показать все товары из списка желаний].
Текст на кнопке, чтобы показать все товары в списке ожидания – текст на кнопке внизу на таблице ожидания [Показать все товары из списка желаний].
Товар в наличии Email ОТ имя
Товар в наличии Email ОТ Email
Товар в наличии Email тема
Текст письма Товар в наличии:
- %product_title% – название товара
- %product_link% – ссылка на страницу товара
- %product_image% – ссылка главного изображения товара
- %product_price% – форматированная цена товара
- %product_description% – описание товара
Специальные переменные для полей темы и сообщения письма:
- %product_short_description% – краткое описание товара
- %user_id% – пользовательский ID
- %user_first_name% – имя пользователя
- %user_last_name% – фамилия пользователя
- %user_email% – Email пользователя
- %user_display_name% – отображаемое имя пользователя

Custom CSS/JavaScript

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

Виджеты

Виджет WooCommerce Wish/Wait List

Это виджет WooCommerce Wish/Wait List. Разместите виджет в любом месте, отведенного для других виджетов.

This image has an empty alt attribute; its file name is image.png

Название – название виджета
Тип товара – тип виджета
- Топ-товары из списка ожидания – товары, которые чаще всего добавляются в список ожидания
- Топ-товары из списка желаний – товары, которые чаще всего добавляются в список желаний
- Сопутствующие товары из списка ожидания пользователей – товары, которые относятся к товарам в списке ожидания пользователей
- Сопутствующие товары из списка желаний – товары, которые относятся к товарам в списке желаний пользователей
- Товары в списке ожидания пользователей в наличии – товары в наличии из списка ожидания пользователей
- Товары в списке желаний пользователей со скидкой – товары со скидкой из списка желаний пользователей
Тип – визуальный стиль предлагаемых товаров
- По умолчанию
- Изображение
- Изображение с названием
- Изображение с названием и ценой
- Название
- Название с ценой
- Слайдер
- Слайдер с названием
Товары в линии – количество товаров в линии или в слайдере
Показать кнопку Добавить в корзину – показать кнопку Добавить в корзину под товарами
Количество товаров – максимальное количество товаров, которое может быть выведено на странице

Для разработчиков

Хуки-события

includes/functions.php

br_get_woocommerce_version()

Общественная функция для получения версии WooCommerce

return string. woocommerce version

generate_ww_list ( $terms )

Общественная функция для вывода списка ожидания и желаний

$terms – массив с данными товара
- id – id товара
- title – название товара
- image – html изображения
- price – html цены
- link – ссылка на товар
- availability – html наличия товара
- is_in_stock – наличие (boolean)

wish-list.php

Все эти функции находятся в классе BeRocket_Wish_List в качестве статических функций.

init ()

Функция инициализации скриптов и добавления кнопок.

br_get_template_part( $name = ” )

Получить часть шаблона (для шаблонов типа ползунка).

Шаблоны по умолчанию помещаются в папку плагина woocommerce-wish-wait-list/templates.

Для перезаписи шаблона в папке темы создайте папку с именем woocommerce-wish-list и поместите новый шаблон с таким же именем в эту папку.

get_wish_button()

Показать кнопки Добавить в список желаний и Добавить в список ожидания

wp_head_style ()

Функция для настройки пользовательских стилей из настроек плагина.

berocket_before_wish_button

Используется для отображения информации до кнопки добавления в список желаний под товарам.

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

<?php
function my_block_berocket_before_wish_button () {
//your code here
}

add_action( 'berocket_before_wish_button', 'my_block_berocket_before_wish_button' );
?>

berocket_before_wait_button

Используется для отображения информации до кнопки добавления в список ожидания под товарам.

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

<?php
function my_block_berocket_before_wait_button () {
//your code here
}

add_action( 'berocket_before_wait_button', 'my_block_berocket_before_wait_button' );
?>

berocket_after_wait_button

Используется для отображения информации после кнопки добавления в список ожидания под товаром.

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

<?php
function my_block_berocket_after_wait_button () {
//your code here
}

add_action( 'berocket_after_wait_button', 'my_block_berocket_after_wait_button' );
?>

berocket_before_wish_list

Используется для отображения информации перед товарами в списке желаний.

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

<?php
function my_block_berocket_before_wish_list () {
//your code here
}

add_action( 'berocket_before_wish_list', 'my_block_berocket_before_wish_list' );
?>

berocket_after_wish_list

Используется для отображения информации после товаров в списке желаний и перед списком ожидания.

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

<?php
function my_block_berocket_after_wish_list () {
//your code here
}

add_action( 'berocket_after_wish_list', 'my_block_berocket_after_wish_list' );
?>

berocket_after_wait_list

Используется для отображения информации после товара в списке желаний.

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

<?php
function my_block_berocket_after_wait_list () {
//your code here
}

add_action( 'berocket_after_wait_list', 'my_block_berocket_after_wait_list' );
?>

Хуки-фильтры

berocket_wish_wait_user_func

Вы можете добавить Javascript к особым действиям. Все эти функции могут быть добавлены пользователями в настройках плагина.

Параметры:

user_func – массив с пользовательскими JavaScript функциями, которые можно настроить в настройках плагина:
- before_wish – выполняется перед нажатием на кнопку Добавить в список желаний
- after_wish – выполняется после добавления в список желаний
- before_wait – исполняется перед нажатием кнопки Добавить в список ожидания
- after_wait – выполняется после добавления в список ожидания

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

<?php
function change_berocket_wish_wait_user_func ( $user_func ) {
//your code here
    return $user_func;
}

add_filter( 'berocket_wish_wait_user_func', 'change_berocket_wish_wait_user_func' );
?>

wish_list_get_template_part

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

Параметры:

teamplate – ссылка на шаблон, который будет загружен.
name – название шаблона.

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

<?php
function change_wish_list_get_template_part ( $template, $name ) {
//your code here
    return $template;
}

add_filter( 'wish_list_get_template_part', 'change_wish_list_get_template_part', 10, 2 );
?>

Файлы

wish-list.php – основной файл плагина
css – стили плагина:
- admin.css – стили для настроек плагина
- colpick.css – стили для блока выбора цвета
- font-awesome.css – стандартные стили Font Awesome
- select_fa.css – стили для селектора Font Awesome
- wish_list.css – стили фронт-энд
fonts – шрифты Font Awesome
includes – папка с дополнительными файлами PHP
- functions.php – общественные функции
- updater.php – BeRocket Updater для обновления плагинов с сайта BeRocket
js – папка с файлами Javascript
- admin.js – скрипты для настроек плагина
- admin_select_fa.js – скрипты для настрое селектора Font Awesome
- colpick.js – скрипты для настроек блока выбора цвета плагина
- wish_list.js – скрипты для настроек фронт-энд
templates – шаблоны для настроек, стиля списка и кнопок
- general_settings.php – шаблон для вкладки Кнопки в настройках плагина
- javascript_settings.php – шаблон для вкладки Javascript в настройках плагина
- license_settings.php – шаблон для вкладки License в настройках плагина
- settings.php – настройки главной страницы плагина
- style_settings.php – шаблон для вкладки Стиль в настройках плагина
- text_settings.php – шаблон для вкладки Текст в настройках плагина
- wish_wait.php – шаблон для страницы списка ожидания и списка желаний