В WordPress хук the_excerpt используется для фильтрации отрывка записи перед его выводом. Это позволяет разработчикам изменять или добавлять дополнительные элементы в отрывок, который используется в различных частях сайта, таких как архивы или страницы поиска.
apply_filters( ‘the_excerpt’, string $post_excerpt )Хук the_excerpt применяется к содержимому поля «Отрывок / Цитата» записи, перед тем как вывести его на экран с помощью функции the_excerpt(). Он предоставляет возможность изменять или дополнительно форматировать отрывок записи. Этот фильтр используется для контроля того, как будет отображаться краткий текст записи в различных частях сайта.
Параметры
- $post_excerpt (string): Отрывок записи, который будет отображен. Это значение передается в хук для дальнейшей обработки.
Как работает хук
Функция the_excerpt() используется для вывода отрывка записи. Когда эта функция вызывается, WordPress автоматически применяет фильтр the_excerpt, что позволяет изменять содержимое отрывка перед его выводом. Это особенно полезно, если вы хотите изменить стандартный формат вывода или добавить дополнительные элементы, такие как HTML-классы или специфическое форматирование.
Добавление кастомного блока вокруг отрывка
В этом примере мы добавим кастомный HTML-блок вокруг содержимого отрывка, чтобы добавить дополнительные стили или элементы оформления.
add_filter( 'the_excerpt', 'custom_wrap_excerpt_in_div' );
function custom_wrap_excerpt_in_div( $post_excerpt ) {
// Оборачиваем отрывок в кастомный div с классом
return '<div class="custom-excerpt">' . $post_excerpt . '</div>';
}
Ограничение длины отрывка
В этом примере мы ограничим длину отрывка, добавив только первые 100 символов из текста записи. Это поможет управлять размером отрывка на страницах архива.
add_filter( 'the_excerpt', 'limit_excerpt_length' );
function limit_excerpt_length( $post_excerpt ) {
// Ограничиваем длину отрывка 100 символами
return substr( $post_excerpt, 0, 100 ) . '...';
}
Добавление мета-данных в отрывок
Иногда полезно добавить мета-данные или другие динамические данные, такие как дата записи или имя автора, в сам отрывок. Например, можно добавить дату публикации перед отрывком.
add_filter( 'the_excerpt', 'prepend_date_to_excerpt' );
function prepend_date_to_excerpt( $post_excerpt ) {
// Добавляем дату публикации в начало отрывка
$publish_date = get_the_date( 'F j, Y' );
return 'Опубликовано: ' . $publish_date . '<br>' . $post_excerpt;
}
Теперь перед отрывком будет отображаться дата публикации, что полезно для блогов или новостных сайтов.
Заключение
Хук the_excerpt предоставляет гибкость в обработке и выводе отрывков записей. Вы можете использовать его для форматирования, добавления кастомных данных или управления длиной отрывка, что поможет улучшить визуальное восприятие и функциональность сайта.