Хуки

В тему JournalX добавлены хуки: события (action) и фильтры (filter). С их помощью Вы можете добавлять свой код, изменять вывод или даже убирать какие-то блоки. Ниже идет описание хуков и примеры их использования.

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

Для событий action

Для добавления события необходимо использовать ф-цию add_action(),
первый аргумент которой – название события в теме, например journalx_after_header
второй аргумент – функция, которая будет вызвана.

Например:

add_action( 'journalx_after_header', function() {
    echo 'Hello';
} );

Данных хук после шапки сайта выведет сообщение “Hello”.

Для фильтров filter

Все аналогично, только вместо add_action() используем add_filter() и вместо echo используем return.

Ниже будут примеры готового куда для некоторых хуков:

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

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

wpshop_toc_headers

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

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

wpshop_toc_minimum_headers

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

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

journalx_metabox_thumbnail_post_type

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

/**
 * $post_type - название произвольного типа постов
 */
add_filter( 'journalx_metabox_thumbnail_post_type', function() {
   return [ 'post', 'page', '$post_id' ];
} );

journalx_metabox_hide_elements_post_type

filter / Позволяет добавить блок “Скрыть элементы” в окно редактирования записи произвольного типа поста.

/**
 * $post_type - название произвольного типа постов
 */
add_filter( 'journalx_metabox_hide_elements_post_type', function() {
   return [ 'post', '$post_id' ];
} );

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

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

journalx_thumb_big_sizes

filter / Позволяет изменить размер больших миниатюр на главной странице и страницах архивов. Ширина, высота, кадрирование (true/false). По умолчанию: 700×400.

/**
 * Изменить размеры больших миниатюр на главной странице и страницах архивов
 */
add_filter( 'journalx_thumb_big_sizes', function() {
    return [ 700, 400, true ];
} );

Не забудьте перегенерировать миниатюры.

journalx_thumb_wide_sizes

filter / Позволяет изменить размер некоторых миниатюр на главной странице и страницах архивов. Ширина, высота, кадрирование (true/false). По умолчанию: 350×200.

/**
 * Изменить размеры некоторых миниатюр на главной странице и страницах архивов
 */
add_filter( 'journalx_thumb_wide_sizes', function() {
    return [ 350, 200, true ];
} );

Не забудьте перегенерировать миниатюры.

journalx_thumb_small_sizes

filter / Позволяет изменить размер миниатюр в похожих записях. Ширина, высота, кадрирование (true/false). По умолчанию: 180×100.

/**
 * Изменить размеры миниатюр в похожих записях
 */
add_filter( 'journalx_thumb_small_sizes', function() {
    return [ 180, 100, true ];
} );

Не забудьте перегенерировать миниатюры.

Хуки шапки и верхнего меню

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

journalx_after_body

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

journalx_before_header

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

journalx_logotype_alt

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

journalx_after_header

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

journalx_before_site_content

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

Хуки записей

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

journalx_single_before_title

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

journalx_single_after_title

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

journalx_single_before_excerpt

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

journalx_single_after_excerpt

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

journalx_single_the_content

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

journalx_single_after_the_content

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

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

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

Хуки страниц

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

journalx_page_before_title

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

journalx_page_after_title

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

journalx_page_the_content

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

journalx_page_after_the_content

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

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

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

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

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

journalx_archive_before_title

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

journalx_archive_after_title

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

journalx_archive_before_posts

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

journalx_archive_after_posts

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

Хуки сайдбара

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

journalx_sidebar_before_widgets

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

journalx_sidebar_after_widgets

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

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

journalx_after_site_content

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

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

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