Главная / Документация / Шаблоны / Cook It

Хуки

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

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

Для событий action

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

Например:

add_action( 'cook_it_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;
} );

cook_it_metabox_thumbnail_post_type

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

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

cook_it_metabox_hide_elements_post_type

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

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

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

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

cook_it_thumb_big

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

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

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

cook_it_thumb_wide

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

/**
 * Изменить размеры миниатюр в похожих записях и в маленьких карточках постов
 */
add_filter( 'cook_it_thumb_wide', function() {
    return [ 330, 200, true ];
} );

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

cook_it_after_post_card

action / Позволяет выводить любой код после карточек постов. Например, чтобы разместить какой-то код/блок на главной после 2 поста. При этом у функции есть 2 параметра: $n – порядковый номер карточки поста и $type – тип карточки поста.

/**
 * $n - порядковый номер карточки после
 * $type - тип карточки поста: card-big, card-line, card-small
 */
add_action( 'cook_it_after_post_card', function( $n, $type ) {
   // блок после 2 карточки на главной
   if ( is_home() && $n == 2 ) {
      echo '<div style="width: 100%;background:#eee;padding: 15px;margin: 10px 0 20px;">Блок на главной после 2 карточки</div>';
   }

   // этот блок будет выводиться после 2, 4 и 8 карточки поста в рубрике 16
   if ( is_category( 16 ) && in_array( $n, [2,4,8] ) ) {
      echo '<div style="width: 100%;background:#eee;padding: 15px;margin: 10px 0 20px;">Блок после 2, 4 и 8 карточки в рубрике 16</div>';
   }

   // после 3 карточки поста везде, где тип карточки Большая карточка
   if ( $n == 3 && $type == 'card-big' ) {
      echo '<div style="width: 100%;background:#eee;padding: 15px;margin: 10px 0 20px;">Блок после 3 карточки типа card-big</div>';
   }
}, 10, 2 );

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

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

cook_it_after_body

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

cook_it_before_header

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

cook_it_logotype_alt

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

cook_it_before_main_navigation

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

cook_it_after_main_navigation

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

cook_it_after_header

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

cook_it_before_site_content

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

Хуки записей

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

cook_it_post_thumbnail

filter / По умолчанию на странице записи выводится миниатюра 680х270 пикселей (thumb-big). С помощью данного фильтра можно изменить вывод миниатюры на полную (full), маленькую 330х200 пикселей (thumb-wide) или стандартную WP.

/**
 * Изменить вывод миниатюры на странице записи
 * Размеры миниатюр: full, thumb-big, thumb-wide или стандартный WP
 */
add_filter( 'cook_it_post_thumbnail', function() {
    return [ 680, 270, true ]; // ширина, высота, обрезать картинку true/false
} );

cook_it_ingredients_title

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

/**
 * $title - нужное название заголовка
 */
add_filter( 'cook_it_ingredients_title', function() {
   return '$title';
} );

cook_it_nutritional_title

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

/**
 * $title - нужное название заголовка
 */
add_filter( 'cook_it_nutritional_title', function() {
   return '$title';
} );

cook_it_ingredients_nutrition_gram

filter / Позволяет измененить единицы измерения в граммах питательной ценности.

/**
 * $title - нужные единицы измерения
 */
add_filter( 'cook_it_ingredients_nutrition_gram', function() {
   return '$title';
} );

cook_it_steps_title

filter / Позволяет изменить заголовок блока “Шаги” рецепта.”

/**
 * $title - нужное название заголовка
 */
add_filter( 'cook_it_steps_title', function() {
   return '$title';
} );

cook_it_before_steps

filter / Позволяет добавить текст или html-код перед шагами приготовления рецепта.


add_filter( 'cook_it_before_steps', function() {
   return 'Здесь вставьте нужный текст или html-код';
} );

cook_it_steps_thumbnail_microdata

filter / Иногда в сниппет попадает не миниатюра записи, а картинка из шагов приготовления. Данный фильтр позволяет отключить микроразметку картинок в шагах приготовления рецепта.


add_filter( 'cook_it_steps_thumbnail_microdata', '__return_false' );

cook_it_video_title

filter / Позволяет изменить заголовок “Видео-рецепт” в блоке “Шаги” рецепта.

/**
 * $title - нужное название заголовка
 */
add_filter( 'cook_it_video_title', function() {
   return '$title';
} );

cook_it_single_before_title

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

cook_it_single_after_title

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

cook_it_single_before_excerpt

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

cook_it_single_after_excerpt

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

cook_it_single_the_content

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

cook_it_single_after_the_content

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

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

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

Хуки страниц

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

cook_it_page_thumbnail

filter / По умолчанию на странице выводится миниатюра 680х270 пикселей (thumb-big). С помощью данного фильтра можно изменить вывод миниатюры на полную (full), маленькую 330х200 пикселей (thumb-wide) или стандартную WP.

/**
 * Изменить вывод миниатюры на странице
 * Размеры миниатюр: full, thumb-big, thumb-wide или стандартный WP
 */
add_filter( 'cook_it_page_thumbnail', function() {
    return [ 680, 270, true ]; // ширина, высота, обрезать картинку true/false
} );

cook_it_page_before_title

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

cook_it_page_after_title

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

cook_it_page_the_content

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

cook_it_page_after_the_content

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

cook_it_page_before_related

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

cook_it_page_after_related

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

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

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

cook_it_archive_before_title

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

cook_it_archive_after_title

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

cook_it_archive_before_posts

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

cook_it_archive_after_posts

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

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

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

cook_it_sidebar_before_widgets

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

cook_it_sidebar_after_widgets

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

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

cook_it_after_site_content

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

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

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

  • Для событий action
  • Для фильтров filter
  • Хуки встроенного содержания
  • wpshop_toc_headers
  • wpshop_toc_minimum_headers
  • cook_it_metabox_thumbnail_post_type
  • cook_it_metabox_hide_elements_post_type
  • Хуки карточек постов
  • cook_it_thumb_big
  • cook_it_thumb_wide
  • cook_it_after_post_card
  • Хуки шапки и верхнего меню
  • cook_it_after_body
  • cook_it_before_header
  • cook_it_logotype_alt
  • cook_it_before_main_navigation
  • cook_it_after_main_navigation
  • cook_it_after_header
  • cook_it_before_site_content
  • Хуки записей
  • cook_it_post_thumbnail
  • cook_it_ingredients_title
  • cook_it_nutritional_title
  • cook_it_ingredients_nutrition_gram
  • cook_it_steps_title
  • cook_it_before_steps
  • cook_it_steps_thumbnail_microdata
  • cook_it_video_title
  • cook_it_single_before_title
  • cook_it_single_after_title
  • cook_it_single_before_excerpt
  • cook_it_single_after_excerpt
  • cook_it_single_the_content
  • cook_it_single_after_the_content
  • cook_it_single_before_related
  • cook_it_single_after_related
  • Хуки страниц
  • cook_it_page_thumbnail
  • cook_it_page_before_title
  • cook_it_page_after_title
  • cook_it_page_the_content
  • cook_it_page_after_the_content
  • cook_it_page_before_related
  • cook_it_page_after_related
  • Хуки страниц архивов
  • cook_it_archive_before_title
  • cook_it_archive_after_title
  • cook_it_archive_before_posts
  • cook_it_archive_after_posts
  • Хуки сайдбара
  • cook_it_sidebar_before_widgets
  • cook_it_sidebar_after_widgets
  • Хуки подвала и нижнего меню
  • cook_it_after_site_content
  • cook_it_before_footer
  • cook_it_after_footer