get_the_excerpt()

Извлекает краткое описание записи
Функция WordPress
INT 4.5.0, 0.71
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Получение краткого описания поста
  4. Извлечение краткого описания поста
  5. Формирование краткого описания поста
  6. Получение краткого содержания поста
  7. Извлечение краткого содержания поста
  8. Вопросы и ответы
  9. Как получить отрывок записи с помощью функции get_the_excerpt()?
  10. Как изменить длину отрывка, возвращаемого функцией get_the_excerpt()?
  11. Как удалить HTML-теги из отрывка, полученного с помощью функции get_the_excerpt()?
  12. Как добавить ссылку ‘Читать дальше’ к отрывку, возвращаемому функцией get_the_excerpt()?
  13. Как изменить стандартный текст ‘Читать дальше’ в отрывке, полученном с помощью функции get_the_excerpt()?
  14. Как получить отрывок без обрезания слов с помощью функции get_the_excerpt()?
  15. Как получить отрывок с определенным количеством символов с помощью функции get_the_excerpt()?
  16. Как получить отрывок без удаления HTML-тегов с помощью функции get_the_excerpt()?
  17. Как получить отрывок с определенным количеством слов с помощью функции get_the_excerpt()?
  18. Связанные элементы

Описание функции

Функция get_the_excerpt() используется для получения отрывка (excerpt) поста.

Отрывок — это короткое описание содержимого поста, которое обычно выводится на странице архива, в списке постов или в результатах поиска.

Функция возвращает отрывок поста в виде строки.

Использование

get_the_excerpt( int|WP_Post $post = null ): string

Функция принимает один необязательный параметр:

  • $post (int|WP_Post) — Необязательный. Идентификатор поста или объект WP_Post. По умолчанию используется глобальная переменная $post.

Функция возвращает отрывок поста в виде строки.

<?php
$post_id = 123; // Идентификатор поста
// Получаем отрывок поста
$excerpt = get_the_excerpt($post_id);
// Выводим отрывок
echo $excerpt;
?>

В данном примере мы указываем идентификатор поста, для которого нужно получить отрывок. Затем мы вызываем функцию get_the_excerpt() и передаем ей этот идентификатор в качестве аргумента. Результат сохраняем в переменную $excerpt. Затем мы выводим полученный отрывок с помощью функции echo.

Примеры использования

Получение краткого описания поста


/**
 * Получение краткого описания поста.
 *
 * @param int|WP_Post $post Optional. Идентификатор поста или объект WP_Post. По умолчанию - глобальная переменная $post.
 * @return string Краткое описание поста.
 */
function get_the_excerpt( $post = null ) {
    $post = get_post( $post );
    if ( ! $post ) {
        return '';
    }
    $post_excerpt = $post->post_excerpt;
    /**
     * Фильтрует краткое описание поста.
     *
     * @since 1.2.0
     *
     * @param string $post_excerpt Краткое описание поста.
     * @param WP_Post $post        Объект поста.
     */
    return apply_filters( 'get_the_excerpt', $post_excerpt, $post );
}

Извлечение краткого описания поста


$post_id = 123;
$excerpt = get_the_excerpt( $post_id );
echo $excerpt;

Формирование краткого описания поста


/**
 * Формирование краткого описания поста.
 *
 * @param int|WP_Post $post Optional. Идентификатор поста или объект WP_Post. По умолчанию - глобальная переменная $post.
 * @return string Краткое описание поста.
 */
function get_the_excerpt( $post = null ) {
    $post = get_post( $post );
    if ( ! $post ) {
        return '';
    }
    $post_excerpt = $post->post_excerpt;
    /**
     * Фильтрует краткое описание поста.
     *
     * @since 1.2.0
     *
     * @param string $post_excerpt Краткое описание поста.
     * @param WP_Post $post        Объект поста.
     */
    return apply_filters( 'get_the_excerpt', $post_excerpt, $post );
}

Получение краткого содержания поста


$post_id = 123;
$excerpt = get_the_excerpt( $post_id );
echo $excerpt;

Извлечение краткого содержания поста


$post_id = 123;
$excerpt = get_the_excerpt( $post_id );
echo $excerpt;

Вопросы и ответы

Как получить отрывок записи с помощью функции get_the_excerpt()?

Функция get_the_excerpt() используется для получения отрывка записи в WordPress. Она возвращает строку с отрывком.

Для получения отрывка записи с помощью функции get_the_excerpt() можно использовать следующий код:


$excerpt = get_the_excerpt();
echo $excerpt;

Как изменить длину отрывка, возвращаемого функцией get_the_excerpt()?

Для изменения длины отрывка, возвращаемого функцией get_the_excerpt(), можно использовать фильтр excerpt_length.

Пример кода:


function custom_excerpt_length( $length ) {
    return 20; // Изменяем длину отрывка на 20 слов
}
add_filter( 'excerpt_length', 'custom_excerpt_length' );

Как удалить HTML-теги из отрывка, полученного с помощью функции get_the_excerpt()?

Для удаления HTML-тегов из отрывка, полученного с помощью функции get_the_excerpt(), можно использовать функцию strip_tags().

Пример кода:


$excerpt = get_the_excerpt();
$excerpt = strip_tags( $excerpt );
echo $excerpt;

Как добавить ссылку ‘Читать дальше’ к отрывку, возвращаемому функцией get_the_excerpt()?

Для добавления ссылки ‘Читать дальше’ к отрывку, возвращаемому функцией get_the_excerpt(), можно использовать фильтр ‘excerpt_more’. Этот фильтр позволяет изменить текст, добавляемый в конце отрывка.

// Функция для изменения текста 'Читать дальше'
function custom_excerpt_more( $more ) {
    return ' <a href="'. get_permalink( get_the_ID() ) . '">' . __( 'Читать дальше', 'textdomain' ) . '</a>';
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );

Как изменить стандартный текст ‘Читать дальше’ в отрывке, полученном с помощью функции get_the_excerpt()?

Для изменения стандартного текста ‘Читать дальше’ в отрывке, полученном с помощью функции get_the_excerpt(), можно использовать фильтр ‘excerpt_more’ и функцию ‘get_the_excerpt’.

// Функция для изменения текста 'Читать дальше'
function custom_excerpt_more( $more ) {
    return ' <a href="'. get_permalink( get_the_ID() ) . '">' . __( 'Продолжить чтение', 'textdomain' ) . '</a>';
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );

Как получить отрывок без обрезания слов с помощью функции get_the_excerpt()?

Для получения отрывка без обрезания слов с помощью функции get_the_excerpt(), можно использовать фильтр ‘wp_trim_excerpt’. Этот фильтр позволяет изменить способ обрезания отрывка.

// Функция для изменения способа обрезания отрывка
function custom_trim_excerpt( $text ) {
    return wp_trim_words( $text, 55, '' );
}
add_filter( 'wp_trim_excerpt', 'custom_trim_excerpt' );

Как получить отрывок с определенным количеством символов с помощью функции get_the_excerpt()?

Функция get_the_excerpt() позволяет получить отрывок (краткое описание) записи.

Чтобы получить отрывок с определенным количеством символов, необходимо использовать функцию substr() для обрезания строки отрывка до нужной длины.

$excerpt = get_the_excerpt();
$excerpt = substr($excerpt, 0, 100); // обрезаем до 100 символов
echo $excerpt;

Как получить отрывок без удаления HTML-тегов с помощью функции get_the_excerpt()?

По умолчанию функция get_the_excerpt() удаляет HTML-теги из отрывка. Если вам нужно получить отрывок без удаления HTML-тегов, можно использовать фильтр the_excerpt.

$excerpt = get_the_excerpt();
$excerpt = apply_filters('the_excerpt', $excerpt);
echo $excerpt;

Как получить отрывок с определенным количеством слов с помощью функции get_the_excerpt()?

Если вам нужно получить отрывок с определенным количеством слов, можно воспользоваться функцией wp_trim_words().

$excerpt = get_the_excerpt();
$excerpt = wp_trim_words($excerpt, 10); // получаем 10 слов
echo $excerpt;

Функция get_the_excerpt() позволяет получить отрывок записи. Вы можете использовать различные методы для обработки отрывка, включая обрезание по количеству символов или слов, а также сохранение HTML-тегов. Эта функция является полезным инструментом для работы с отрывками в WordPress.

Связанные элементы

  • Хук get_the_excerpt: позволяет изменить отрывок после его получения.
  • Класс WP_Post: представляет объект записи (поста) в WordPress.
  • Класс WP_Query: используется для выполнения запросов к базе данных WordPress.
  • Класс WP_Tax_Query: используется для создания запросов по таксономиям (категориям, меткам и т. д.) в WordPress.
  • Класс WP_Meta_Query: используется для создания запросов по метаполям в WordPress.
  • Класс WP_User_Query: используется для создания запросов по пользователям в WordPress.
  • Класс WP_Comment_Query: используется для создания запросов по комментариям в WordPress.
  • Класс WP_Date_Query: используется для создания запросов по датам в WordPress.
Обсуждение