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

WooCommerce Pagination Styler

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

Настройки

Настройки WooCommerce Pagination Styler находятся в админ-панели WooCommerce Pagination Styler.

  • Глобальные настройки
  • Стиль
  • Текст
  • Пользовательские CSS/ Javascript
  • Лицензия

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

  • Включить кнопки Предыдущая и Следующая страницы на пагинации – включить кнопки для предыдущей и следующей страницы.
  • Предыдущая и Следующая кнопки на пагинации – положение для кнопок Предыдущая и Следующая.
    • Вокруг пагинации
    • Вокруг центральной страницы
    • Вокруг текущей страницы
  • Первая и последняя кнопки учитываются в пагинации – количество страниц с первой и с последней страницы
  • Кнопка подсчета страниц вокруг текущей страницы – подсчет страниц с каждой стороны от текущей страницы
  • Включить точки пагинации – включить точки между первыми и последними страницами и страницами вокруг текущей страницы.

Стиль

  • Стиль пагинации – стиль размещение для пагинации:
    • По умолчанию – пагинация WooCommerce по умолчанию: 
      • Положение – горизонтальное положение пагинации
      • Положение для пагинации – включить пагинацию после товаров и перед товарами
    • Закреплена – закреплена на экране:
      • Положение – отступ в окне: сверху, снизу, слева и справа 
    • Снизу – фиксированная нижняя часть страницы, но внутри контейнера для товаров:
      • Положение – горизонтальное положение пагинации: по центру, слева, справа.
      • Текст для точек Предыдущая
      • Отступ снизу
  • Ориентация кнопок:
    • Горизонтальная
    • Вертикальная
  • Стиль пагинации – CSS-стили для пагинации и кнопок:
    • Цвет
      • Цвет фона – цвет фона для блока пагинации/ по умолчанию
      • Цвет границы – цвет границы для блока пагинации/ по умолчанию
      • Цвет текста кнопки – цвет текста в кнопках пагинации/ по умолчанию
      • Цвет текста кнопки при наведении курсора – цвет текста в пагинации кнопок при наведении курсора/ по умолчанию
      • Цвет фона кнопки – цвет фона для кнопки пагинации/ по умолчанию
      • Цвет фона кнопки при наведении курсора – цвет фона для кнопки пагинации при наведении курсора/ по умолчанию
      • Цвет границы кнопки – цвет границы для кнопки пагинации/ по умолчанию
      • Цвет границы кнопки при наведении курсора – цвет границы для кнопки пагинации при наведении курсора/ По умолчанию
    • Размер:
      • Ширина границы – ширина границы вокруг блока пагинации
        • Сверху
        • Снизу
        • Слева
        • Справа
      • Ширина границы кнопки – ширина границы вокруг кнопок пагинации
        • Сверху
        • Снизу
        • Слева
        • Справа
      • Отступы – отступы вокруг всех кнопок пагинации
        • Сверху
        • Снизу
        • Слева
        • Справа
      • Отступы кнопки – отступы вокруг текста внутри кнопок пагинации
        • Сверху
        • Снизу
        • Слева
        • Справа
      • Радиус скругления – круглый угол для блока пагинации страниц
        • Сверху-слева
        • Сверху-справа
        • Снизу-справа
        • Снизу-слева
      • Радиус скругления кнопки – круглый угол для кнопок пагинации
        • Сверху-слева
        • Сверху-справа
        • Снизу-справа
        • Снизу-слева
      • Отступы между кнопками – отступы вокруг кнопок пагинации
        • Сверху
        • Снизу
        • Слева
        • Справа
  • Специальные стили для кнопки Предыдущая – стили для кнопки Следующая страница на пагинации WooCommerce 
  • Специальные стили для кнопки Следующая – стили для кнопки Следующая страница на пагинации WooCommerce
  • Специальные стили для кнопки Точки – стили для кнопки Точки на пагинации WooCommerce
  • Специальные стили для кнопки Текущая (страница) – стили для кнопки текущей страницы на пагинации WooCommerce
  • Специальные стили для других кнопок – стили для других кнопок на пагинации WooCommerce

Текст

  • Текст для точек Предыдущая – текст для точек между первыми страницами, последними страницами и страницами вокруг текущей страницы.
    • Font Awesome/ Удалить
    • %ICON% – использовать выбранную иконку Font Awesome
  • Текст для точек Следующая – текст для точек между первыми страницами, последними страницами и страницами вокруг текущей страницы
    • Font Awesome/ Удалить
    • %ICON% – использовать выбранную иконку “Шрифт Awesome”.
  • Текст для кнопки Предыдущая – текст на кнопке для предыдущей страницы
    • Font Awesome/ Удалить
    • %ICON% – использовать выбранную иконку Font Awesome
  • Текст для кнопки Следующая – текст на кнопке для следующей страницы
    • Font Awesome/ Удалить
    • %ICON% – использовать выбранную иконку Font Awesome
  • Текст для текущей страницы – текст на кнопке для текущей страницы
  • Текст для страницы – текст на кнопках для других страниц
  • Текст для первой страницы – текст на кнопке для первой страницы
    • Font Awesome/ Удалить
    • %LAST% – номер последней страницы. %ICON% – использовать выбранную иконку Font Awesome
  • Текст для последней страницы – текст на кнопке для последней страницы
    • Font Awesome/ Удалить
    • %LAST% – номер последней страницы %ICON% – использовать выбранную иконку Font Awesome

Пользовательский CSS/ Javascript

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

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

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

includes/functions.php

br_get_woocommerce_version()

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

return string. woocommerce version

berocket_pagination()

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

pagination-styler.php

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

init ()

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

br_get_template_part( $name = ” )

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

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

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

set_pagination_settings ( $args )

Установка пагинации BeRocket в пользовательских настройках.

Используется как фильтр:

  • $args – массив с аргументами пагинации

return array. modified $args

berocket_ps_before_pagination

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

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

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

add_action( 'berocket_ps_before_pagination', 'my_block_berocket_ps_before_pagination' );
?>


berocket_ps_after_pagination

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

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

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

add_action( 'berocket_ps_after_pagination', 'my_block_berocket_ps_after_pagination' );
?>


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

berocket_pagination_styler_page_data

На пагинации можно изменить любой текст.

Параметры:

  1. args – массив с настройками для пагинации, которые имеют стандартные настройки пагинации woocommerce
    • prev_next – использовать кнопки Предыдущая и Следующая или нет
    • end_size – количество страниц от первой страницы и от последней страницы
    • mid_size – количества страниц по обе стороны текущей страницы
    • prev_text – текст на кнопке Предыдущая
    • next_text – текст на кнопке Следующая
    • dots_prev_text – текст на кнопке точек до текущей кнопки
    • dots_next_text – текст на кнопке точек после текущей кнопки
    • first_page – текст на кнопке Первая страница
    • last_page – текст на кнопке последней страницы
    • current_page – текст на кнопке текущая страница
    • page – текст на других кнопках

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

<?php
function change_berocket_pagination_styler_page_data ( $args ) {
//your code here
    return $args;
}

add_filter( 'berocket_pagination_styler_page_data', 'change_berocket_pagination_styler_page_data' );
?>

pagination_get_template_part

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

Параметры

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

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

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

add_filter( 'pagination_get_template_part', 'change_pagination_get_template_part', 10, 2 );
?>

pagination_get_template_part

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

Параметры

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

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

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

add_filter( 'pagination_get_template_part', 'change_pagination_get_template_part', 10, 2 );
?>

berocket_pagination_next

Можно изменить код html для кнопки Следующая

Параметры

  1. html – готовый код html для кнопки Следующая страница

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

<?php
function change_berocket_pagination_next ( $html ) {
//your code here
    return $html;
}

add_filter( 'berocket_pagination_next', 'change_berocket_pagination_next' );
?>


berocket_pagination_dots_previous

Вы можете изменить код html для кнопки точек перед кнопкой Текущая.

Параметры

  1. html – можно использовать html код для кнопки точек перед кнопкой Текущая
<?php
function change_berocket_pagination_dots_previous ( $html ) {
//your code here
    return $html;
}

add_filter( 'berocket_pagination_dots_previous', 'change_berocket_pagination_dots_previous' );
?>

berocket_pagination_dots_next

Вы можете изменить код html для кнопки точек после кнопкой Текущая.

Параметры

  1. html – можно использовать html код для кнопки точек перед кнопкой Текущая

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

<?php
function change_berocket_pagination_dots_previous ( $html ) {
//your code here
    return $html;
}

add_filter( 'berocket_pagination_dots_previous', 'change_berocket_pagination_dots_previous' );
?>

Файлы

  • pagination-styler.php – основной файл плагина
  • css – папка с CSS-файлами
    • admin.css – стили для админ-панели
    • colpick.css – стили для блока выбора цвета
    • font-awesome.css – стандартные стили Font Awesome
    • pagination.css – стили лицевых страниц
    • select_fa.css – стили для селектора Font Awesome
  • fonts – шрифты Font Awesome
  • includes – папку с дополнительными файлами PHP
    • functions.php – общественные функции
    • updater.php – BeRocket Updater для обновления плагинов с сайта BeRocket
  • js – папка с файлами Javascript
    • admin.js – Javascript для настройки панели администрирования
    • admin_select_fa.js – Javascript для селектора Font Awesome 
    • colpick.js – Javascript для блока подборки цвета в настройках админ панели
    • pagination_styler.js – JavaScript для лицевых страниц
  • templates – шаблоны для настроек, стиля списка и кнопок
    • general_settings.php – шаблон для вкладки Кнопки в настройках
    • javascript_settings.php – шаблон для вкладки JavaScript в настройках
    • license_settings.php – шаблон для вкладки Лицензия в настройках
    • settings.php – страница настроек плагина
    • style_settings.php – шаблон для вкладки Стиль в настройках
    • text_settings.php – шаблон для вкладки Текст в настройках