Функция get_the_excerpt() в WordPress используется для получения краткого содержания (анонса) поста. В отличие от the_excerpt(), которая сразу выводит анонс, get_the_excerpt() возвращает его в виде строки, что позволяет гибко использовать значение в шаблонах.
get_the_excerpt( $post )Параметры
- $post (int|WP_Post, необязательный): ID поста или объект
WP_Post. По умолчанию используется текущий пост в цикле.
Возвращаемое значение
- (строка): Возвращает краткое содержание поста.
Примеры использования
Пример 1: Получение и вывод краткого содержания текущего поста
Этот пример показывает, как получить анонс текущего поста в цикле и вывести его.
$excerpt = get_the_excerpt();
echo $excerpt;Пример 2: Получение краткого содержания для определённого поста
Вы можете передать ID поста, чтобы получить его анонс.
$post_id = 42;
$excerpt = get_the_excerpt( $post_id );
echo $excerpt;Или используя объект поста:
$post = get_post(42);
$excerpt = get_the_excerpt( $post );
echo $excerpt;Пример 3: Использование краткого содержания в условии
Вы можете использовать полученный анонс в условии, например, для проверки его наличия.
$excerpt = get_the_excerpt();
if ( !empty($excerpt) ) {
echo $excerpt;
} else {
echo 'Анонс не доступен';
}Примечания
- Если у поста нет специально заданного краткого содержания,
get_the_excerpt()автоматически генерирует его из содержимого поста, обрезая текст до первого абзаца или до 55 слов по умолчанию. - Функция
get_the_excerpt()применяет фильтры к анонсу, что позволяет модифицировать вывод перед использованием.
Пример 4: Применение фильтра для модификации анонса
Этот пример показывает, как применить фильтр get_the_excerpt для модификации анонса перед его выводом.
function custom_excerpt_more( $excerpt ) {
return $excerpt . '... <a href="' . get_permalink() . '">Читать далее</a>';
}
add_filter( 'get_the_excerpt', 'custom_excerpt_more' );
$excerpt = get_the_excerpt();
echo $excerpt;Заключение
Функция get_the_excerpt() является мощным инструментом для получения краткого содержания постов в WordPress. Она предоставляет гибкость в использовании анонсов в различных контекстах, позволяя легко интегрировать их в ваши шаблоны и модифицировать перед выводом. Используйте get_the_excerpt() в своих проектах для улучшения представления контента на вашем сайте.