Функция has_excerpt() в WordPress используется для проверки, имеется ли у поста отрывок. Это полезно, когда вам нужно изменить поведение или вывод контента в зависимости от того, присутствует ли отрывок у поста.
Описание функции
has_excerpt() проверяет, задан ли отрывок для указанного поста и возвращает true, если отрывок есть, и false, если его нет.
Синтаксис
has_excerpt( $post = null )Параметры
$post(int|WP_Post|null): ID поста или объект поста. По умолчанию — текущий пост в цикле WordPress.
Примеры использования
Пример 1. Проверка наличия отрывка у текущего поста
Часто используется в шаблонах тем, чтобы проверить, есть ли у текущего поста отрывок, и в зависимости от результата выводить отрывок или часть контента.
if ( have_posts() ) :
while ( have_posts() ) : the_post();
if ( has_excerpt() ) {
the_excerpt();
} else {
the_content();
}
endwhile;
else :
echo 'Ничего не найдено';
endif;В этом примере, если у поста есть отрывок, он будет выведен. В противном случае, будет выведен полный контент поста.
Пример 2. Проверка наличия отрывка у конкретного поста
Вы можете проверить наличие отрывка у поста с определенным ID.
$post_id = 42;
if ( has_excerpt( $post_id ) ) {
echo 'У поста с ID ' . $post_id . ' есть отрывок.';
} else {
echo 'У поста с ID ' . $post_id . ' нет отрывка.';
}Этот пример проверяет, есть ли отрывок у поста с ID 42, и выводит соответствующее сообщение.
Пример 3. Использование в комбинации с get_the_excerpt()
Иногда может потребоваться не только проверить наличие отрывка, но и получить его значение для дальнейшей обработки.
if ( have_posts() ) :
while ( have_posts() ) : the_post();
if ( has_excerpt() ) {
$excerpt = get_the_excerpt();
echo '<div class="custom-excerpt">' . $excerpt . '</div>';
} else {
the_content();
}
endwhile;
else :
echo 'Ничего не найдено';
endif;Здесь, если у поста есть отрывок, он сохраняется в переменную $excerpt и выводится с пользовательским классом CSS для стилизации.
Заключение по has_excerpt
Функция has_excerpt() позволяет гибко управлять выводом контента в зависимости от наличия отрывка у поста. Она особенно полезна в шаблонах тем WordPress, где важно предоставить пользователю наиболее релевантную и структурированную информацию. Используйте has_excerpt() вместе с другими функциями WordPress для создания мощных и адаптивных шаблонов.