Хуки

Для начала ознакомьтесь со статьей что такое хуки и как с ними работать.

Лучше всего для этого использовать плагин ProFunctions, установите и добавьте в него нужный код.

Хуки шапки

Список хуков, с помощью которых можно добавить или изменить элементы шапки.

bono_after_body

action / Позволяет вывести любой код сразу после тега открывающегося тега body

bono_before_header

action / Позволяет вывести любой код перед шапкой сайта

bono_search_form_placeholder

filter / Позволяет изменить текст атрибута placeholder в форме поиска

/* Изменить текст атрибута placeholder в форме поиска */
add_filter( 'bono_search_form_placeholder', function () {
    return 'Здесь вставьте нужный текст';
} );

bono_logotype_alt

action / Позволяет изменить атрибут alt у картинки логотипа

/* Изменить атрибут alt у картинки логотипа */
add_filter( 'bono_logotype_alt', function () {
    return 'Здесь вставьте нужный текст';
} );

bono_after_social_buttons

action / Позволяет вывести любой код в конце соц. кнопок с ссылками на профили (например, произвольную соц. сеть)

bono_after_header

action / Позволяет вывести любой код после шапки сайта

Хуки меню под шапкой сайта

Список хуков, с помощью которых можно добавить или изменить элементы меню под шапкой сайта.

bono_before_main_navigation

action / Позволяет вывести любой код перед меню под шапкой

bono_after_main_navigation

action / Позволяет вывести любой код после меню под шапкой

Хуки контента

Список хуков, с помощью которых можно добавить или изменить элементы контента сайта.

bono_before_site_content

action / Позволяет вывести любой код перед контентом сайта

bono_before_posts

action / Позволяет вывести любой код перед последними записями

bono_after_posts

action / Позволяет вывести любой код после последних записей

bono_force_show_sidebar

action / Позволяет подключить другой файл сайдбара

bono_after_site_content

action / Позволяет вывести любой код после контента сайта

Хуки записей

Список хуков, с помощью которых можно добавить или изменить элементы записей.

bono_post_thumbnail

filter / С помощью данного фильтра можно изменить вывод миниатюры на полную (full) или произвольного размера.

/* Изменить вывод миниатюры на странице записи */
add_filter( 'bono_post_thumbnail', function() {
    return [ 550, 300, true ]; // ширина, высота, обрезать картинку true/false
} );

bono_single_before_title

action / Позволяет вывести любой код перед названием записи на странице записи

bono_single_after_title

action / Позволяет вывести любой код после названия записи на странице записи

bono_single_before_excerpt

action / Позволяет вывести любой код перед отрывком записи на странице записи

bono_single_after_excerpt

action / Позволяет вывести любой код после отрывка записи на странице записи

bono_single_before_the_content

action / Позволяет вывести любой код перед контентом на странице записи

bono_single_after_the_content

action / Позволяет вывести любой код после контента на странице записи

bono_single_before_related

action / Позволяет вывести любой код перед блоком похожих записей на странице записи

bono_single_after_related

action / Позволяет вывести любой код после блока похожих записей на странице записи

Хуки страниц

Список хуков, с помощью которых можно добавить или изменить элементы страниц.

bono_page_before_title

action / Позволяет вывести любой код перед названием страницы

bono_page_after_title

action / Позволяет вывести любой код после названия страницы

bono_page_before_the_content

action / Позволяет вывести любой код перед контентом страницы

bono_page_after_the_content

action / Позволяет вывести любой код после контента страницы

Хуки страниц архивов

Список хуков, с помощью которых можно добавить или изменить элементы на страницах архивов.

bono_archive_before_title

action / Позволяет вывести любой код перед названием на странице архива

bono_archive_after_title

action / Позволяет вывести любой код после названия на странице архива

bono_archive_before_posts

action / Позволяет вывести любой код перед карточками постов на странице архива

bono_archive_after_posts

action / Позволяет вывести любой код после карточек постов на странице архива

Хуки подвала и нижнего меню

Список хуков, с помощью которых можно добавить или изменить элементы подвала и нижнего меню.

bono_before_footer

action / Позволяет вывести любой код перед подвалом сайта

bono_before_footer_navigation

action / Позволяет вывести любой код перед меню в подвале сайта

bono_after_footer_navigation

action / Позволяет вывести любой код после меню в подвале сайта

bono_after_footer

action / Позволяет вывести любой код после подвала сайта

bono_before_body

action / Позволяет вывести любой код перед закрывающимся тегом body

Хуки карточек товаров

В Bono для изображений карточек товаров заданы стандартные размеры, подходящей для данной темы. Если же нужно задать произвольные размеры, то можно воспользоваться одним из двух способов, установив плагин https://support.wpshop.ru/docs/general/profunctions/

Добавить фильтры, например такие

add_filter( 'bono_woocommerce_thumbnail_width', function () {
    return 500;
} );
add_filter( 'bono_woocommerce_thumbnail_height', function () {
    return 500;
} );
add_filter( 'bono_woocommerce_thumbnail_crop', function () {
    return 1;
} );

Или включить настройки плагина WooCommerce

add_action( 'Wpshop\TheTheme\Features\ImageManagement::init', function ( $instance ) {
    remove_action( 'customize_register', [ $instance, '_update_wc_customizer_sections' ], 20 );
    remove_filter( 'woocommerce_get_image_size_thumbnail', [ $instance, '_get_image_size_thumbnail' ] );
} );

Во втором случае можно задавать лишь пропорции обрезки изображений.

Хуки встроенного содержания

Список хуков, с помощью которых можно добавить или изменить элементы встроенного содержания.

wpshop_toc_headers

filter / По умолчанию, в встроенном содержании выводятся заголовки h1-h4. С помощью данного фильтра можно исключить или добавить другие заголовки (например, добавить h5).

/* Изменить заголовки в содержании */
add_filter( 'wpshop_toc_headers', function() {
    return [ 'h1', 'h2', 'h3', 'h4', 'h5' ];
} );

wpshop_toc_minimum_headers

filter / По умолчанию, встроенное содержание выводится, если в тексте записи или страницы есть 3 и больше заголовков h2-h4. С помощью данного фильтра можно изменить кол-во заголовков для вывода содержания (например, чтобы содержание выводилось от 2-х заголовков).

/* Изменить заголовки в содержании */
add_filter( 'wpshop_toc_minimum_headers', function() {
    return 2;
} );

Хуки хлебных крошек

bono_breadcrumbs_do_show

filter /С помощью данного фильтра можно скрыть хлебные настройки с конкретных страница, например, если нужно их спрятать только на странице магазина, установите и активируйте плагин ProFunctions и добавьте в него код:

add_filter( 'bono_breadcrumbs_do_show', function ( $result ) {
    if ( is_shop() ) {
        return false;
    }

    return $result;
} );

Список функций для проверки страниц:

is_shop()
is_product()
is_product_category()
is_cart()
is_checkout()
is_account_page()
bono_is_favorite_page()

Хуки встроенной формы обратной связи

Список хуков, с помощью которых можно добавить или изменить элементы встроенной формы обратной связи.

bono_contact_form_fields

filter / Позволяет настроить вывод полей в форме обратной связи. Ниже пример добавления поля “Телефон” к форме обратной связи.

/* Изменить поля в форме обратной связи
    name         - ID поля - латинские, цифры, минус, нижнее подчеркивание
    type         - type у input, по умолчанию text, может быть email, number и т.д
    placeholder  - описание у поля, можно на русском
    required     - может быть равно required, если обязательное поле
    tag          - может быть textarea, по умолчанию input
 */
add_filter( 'bono_contact_form_fields', function() {
    return [
        [
            'name'        => 'contact-name',
            'placeholder' => 'Ваше имя',
            'required'    => 'required',
        ],
        [
            'name'        => 'contact-email',
            'type'        => 'email',
            'placeholder' => 'E-mail',
            'required'    => 'required',
        ],
        [
            'name'        => 'contact-phone',
            'type'        => 'text',
            'placeholder' => 'Телефон',
            'required'    => 'required',
        ],
        [
            'name'        => 'contact-subject',
            'placeholder' => 'Тема',
        ],
        [
            'tag'         => 'textarea',
            'name'        => 'contact-message',
            'placeholder' => 'Сообщение',
            'required'    => 'required',
        ],
    ];
} );

wpshop_contact_form_button_text

filter / С помощью данного фильтра можно изменить текст кнопки “Отправить” в встроенной форме обратной связи.

/* Изменить текст кнопки "Отправить" в форме обратной связи */
add_filter( 'wpshop_contact_form_button_text', function() {
    return 'Здесь вставьте нужный текст';
} );

wpshop_contact_form_message_sent

filter / По умолчанию, после отправки сообщения формы обратной связи выводится сообщение “Сообщение успешно отправлено!”. С помощью данного фильтра можно изменить данный текст.

/* Изменить текст после отправки сообщения формы обратной связи */
add_filter( 'wpshop_contact_form_message_sent', function() {
    return 'Здесь вставьте нужный текст';
} );

wpshop_contact_form_email_to

filter / По умолчанию, сообщения формы обратной связи приходят на почту, указанную в Настройки > Общие в поле “Адрес e-mail”. С помощью данного фильтра можно указать другую почту, на которую буду приходить сообщения с формы обратной связи.

/* Изменить почту, на которую приходят сообщения с формы обратной связи */
add_filter( 'wpshop_contact_form_email_to', function() {
    return 'Здесь через запятую добавьте нужные почты';
} );

Хуки конструктора главной

bono_before_homepage_constructor

bono_after_homepage_constructor

Хуки для модификации общей информации, заданной в блоках

bono_homepage_constructor:categories_section_header_text
bono_homepage_constructor:categories_section_description
bono_homepage_constructor:html_section_header_text
bono_homepage_constructor:posts_section_header_text
bono_homepage_constructor:posts_section_description
bono_homepage_constructor:products_section_header_text
bono_homepage_constructor:products_section_description
bono_homepage_constructor:slide_title
bono_homepage_constructor:slide_button_text
bono_homepage_constructor:slide_excerpt

Выше перечисленные хуки могут использоваться для перевода

Хуки элемента слайдера категория

bono_category_slide_item_title
bono_category_slide_item_description
bono_category_slide_item_url
bono_category_slide_item_button_text

С их помощью можно поменять параметры слайда категории, также могут использоваться для перевода

Хуки параметров блоков

bono_homepage_constructor:categories_section_columns
bono_homepage_constructor:products_section_columns

С помощью данных хуков можно поменять количество колонок в секциях товаров и категорий

add_filter( 'bono_homepage_constructor:categories_section_columns', function ( $count, $section_options ) {
    return 3;
}, 10, 2 );

По умолчанию используются общие настройки.

Хуки описания категорий и товаров

bono_homepage_constructor:categories_section_description_pos
bono_homepage_constructor:products_section_description_pos

С помощью этих хуков можно перенести описание вниз под секцию с товарами или категориями

add_filter( 'bono_homepage_constructor:products_section_description_pos', function () {
    return 'bottom';
} );