GeneratePress — легкая и гибкая тема для WordPress, которая предоставляет большое количество хуков и фильтров для удобного добавления пользовательских функций. В этой статье разберём, как правильно использовать эти возможности для расширения функционала сайта без риска потерять изменения при обновлении темы.
Что такое хуки и фильтры в GeneratePress
Хуки (actions) — это специальные точки в коде темы, куда вы можете «подцепить» свои функции и выполнить их в нужный момент. Они обычно используются для вставки HTML, запуска скриптов или выполнения других действий.
Фильтры (filters) позволяют изменить или дополнить данные, которые возвращает тема или WordPress. С их помощью можно модифицировать текст, атрибуты, параметры и многое другое.
GeneratePress содержит более 100 хуков и фильтров, что даёт практически безграничные возможности кастомизации.
Основные хуки GeneratePress для добавления контента
Рассмотрим несколько популярных хуков, где можно добавить свои элементы:
generate_before_header— перед шапкой сайта;generate_after_header— сразу после шапки;generate_inside_header— внутри шапки;generate_before_footer— перед футером;generate_after_footer— сразу после футера;generate_after_entry_content— после контента записи;generate_sidebar— внутри сайдбара.
Пример добавления баннера перед шапкой:
add_action('generate_before_header', 'generatepress_ru_custom_banner');
function generatepress_ru_custom_banner() {
echo '<div class="custom-banner" style="background:#eee;padding:10px;text-align:center;">Добро пожаловать на generatepress.ru!</div>';
}Этот код нужно добавить в файл functions.php дочерней темы или в плагин для пользовательских функций. Таким образом вы вставите простой баннер без изменения исходного кода темы.
Использование фильтров GeneratePress для изменения вывода
Фильтры позволяют изменять данные перед их выводом. Например, фильтр generate_post_meta управляет метаинформацией записи.
Пример: добавим к дате публикации текст «Опубликовано на generatepress.ru»
add_filter('generate_post_meta', 'generatepress_ru_custom_post_meta');
function generatepress_ru_custom_post_meta($meta) {
return $meta . ' | Опубликовано на generatepress.ru';
}Кроме того, можно изменить классы CSS, заголовки и многое другое, используя фильтры. Например, фильтр body_class позволяет добавлять свои CSS классы к тегу <body>.
Практические примеры: как создать кастомный виджет с хуками GeneratePress
Предположим, надо вывести список популярных статей в сайдбаре, используя хук generate_sidebar. Для этого можно написать функцию, которая получает 5 самых комментируемых записей и выводит их список.
add_action('generate_sidebar', 'generatepress_ru_popular_posts_widget');
function generatepress_ru_popular_posts_widget() {
$args = array(
'posts_per_page' => 5,
'orderby' => 'comment_count',
'order' => 'DESC',
'ignore_sticky_posts' => true
);
$popular_posts = get_posts($args);
if (!empty($popular_posts)) {
echo '<div class="widget popular-posts"><h3>Популярные статьи</h3><ul>';
foreach ($popular_posts as $post) {
echo '<li><a href="' . get_permalink($post->ID) . '">' . esc_html($post->post_title) . '</a></li>';
}
echo '</ul></div>';
}
}Так вы можете расширять функционал сайта без установки дополнительных плагинов, используя встроенные возможности GeneratePress.
Как отладить хуки и фильтры GeneratePress
Чтобы понять, какие хуки срабатывают, полезно использовать плагины типа Show Hooks или писать тестовые функции с выводом сообщений.
Кроме того, в GeneratePress можно включить расширенную документацию и примеры хуков на официальном сайте, что значительно ускорит разработку.
Если ваш код не работает — проверьте правильность указания имени хука, приоритет и наличие ошибок в PHP.
Советы по безопасности и производительности
При добавлении кастомного кода важно не забывать о безопасности. Используйте функции экранирования данных (esc_html(), esc_url(), wp_kses_post()) при выводе информации.
Избегайте тяжелых запросов и кешируйте результаты, чтобы не замедлять сайт. Например, для популярных постов можно использовать transient API WordPress.
add_action('generate_sidebar', 'generatepress_ru_popular_posts_widget_cached');
function generatepress_ru_popular_posts_widget_cached() {
$cache_key = 'gp_popular_posts_widget';
$output = get_transient($cache_key);
if (false === $output) {
ob_start();
$args = array(
'posts_per_page' => 5,
'orderby' => 'comment_count',
'order' => 'DESC',
'ignore_sticky_posts' => true
);
$popular_posts = get_posts($args);
if (!empty($popular_posts)) {
echo '<div class="widget popular-posts"><h3>Популярные статьи</h3><ul>';
foreach ($popular_posts as $post) {
echo '<li><a href="' . get_permalink($post->ID) . '">' . esc_html($post->post_title) . '</a></li>';
}
echo '</ul></div>';
}
$output = ob_get_clean();
set_transient($cache_key, $output, 12 * HOUR_IN_SECONDS);
}
echo $output;
}Заключение
Хуки и фильтры GeneratePress — мощный инструмент для расширения функционала сайта. Используя их, можно добавлять кастомные блоки, менять вывод темы, создавать виджеты и оптимизировать работу без установки лишних плагинов.
Для вдохновения рекомендую ознакомиться с официальной документацией на https://docs.generatepress.com/article/hooks/ и примерами использования.
Если хотите получить готовые расширения для GeneratePress и WordPress, обратите внимание на плагины на wpshop.ru.