the_excerpt

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

Описание хука

Хук «the_excerpt» позволяет изменить отображаемый анонс поста. Он вызывается в функции «get_the_excerpt», которая используется для получения анонса поста. Хук позволяет определить, какой анонс будет отображаться на странице.

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

apply_filters( 'the_excerpt', string $post_excerpt )

В данном примере применяется хук «the_excerpt» к переменной $post_excerpt. Функция apply_filters позволяет применить все фильтры, связанные с хуком «the_excerpt», к данной переменной.

  • $post_excerpt (string): Анонс поста.
<?php
/**
 * Функция, применяемая к хуку "the_excerpt".
 *
 * @param string $post_excerpt Анонс поста.
 * @return string Измененный анонс поста.
 */
function custom_excerpt_filter( $post_excerpt ) {
    // Ваш код для изменения анонса поста
    
    return $post_excerpt;
}
add_filter( 'the_excerpt', 'custom_excerpt_filter' );
?>

В данном примере показана функция, которая применяется к хуку «the_excerpt». Внутри функции вы можете добавить свой код для изменения анонса поста. Функция должна возвращать измененный анонс.

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

Изменение отображаемого текста в анонсе статьи


/**
 * Функция для изменения отображаемого текста в анонсе статьи.
 *
 * @param string $post_excerpt The post excerpt.
 * @return string The modified post excerpt.
 */
function custom_excerpt( $post_excerpt ) {
    // Заменяем часть текста в анонсе статьи
    $modified_excerpt = str_replace( 'old text', 'new text', $post_excerpt );
    
    return $modified_excerpt;
}
add_filter( 'the_excerpt', 'custom_excerpt' );

Добавление ссылки на автора в анонсе статьи


/**
 * Функция для добавления ссылки на автора в анонсе статьи.
 *
 * @param string $post_excerpt The post excerpt.
 * @return string The modified post excerpt.
 */
function add_author_link( $post_excerpt ) {
    // Получаем ID автора статьи
    $author_id = get_post_field( 'post_author', get_the_ID() );
    
    // Получаем ссылку на профиль автора
    $author_link = get_author_posts_url( $author_id );
    
    // Добавляем ссылку на автора в анонсе статьи
    $modified_excerpt = $post_excerpt . ' <a href="' . $author_link . '">Read more by the author</a>';
    
    return $modified_excerpt;
}
add_filter( 'the_excerpt', 'add_author_link' );

Форматирование текста анонса статьи


/**
 * Функция для форматирования текста анонса статьи.
 *
 * @param string $post_excerpt The post excerpt.
 * @return string The modified post excerpt.
 */
function format_excerpt( $post_excerpt ) {
    // Применяем форматирование к анонсу статьи
    $modified_excerpt = '<p>' . $post_excerpt . '</p>';
    
    return $modified_excerpt;
}
add_filter( 'the_excerpt', 'format_excerpt' );

Удаление HTML-тегов из анонса статьи


/**
 * Функция для удаления HTML-тегов из анонса статьи.
 *
 * @param string $post_excerpt The post excerpt.
 * @return string The modified post excerpt.
 */
function remove_html_tags( $post_excerpt ) {
    // Удаляем HTML-теги из анонса статьи
    $modified_excerpt = strip_tags( $post_excerpt );
    
    return $modified_excerpt;
}
add_filter( 'the_excerpt', 'remove_html_tags' );

Добавление изображения в анонс статьи


/**
 * Функция для добавления изображения в анонс статьи.
 *
 * @param string $post_excerpt The post excerpt.
 * @return string The modified post excerpt.
 */
function add_image_to_excerpt( $post_excerpt ) {
    // Получаем URL изображения, прикрепленного к статье
    $image_url = get_the_post_thumbnail_url( get_the_ID(), 'thumbnail' );
    
    // Добавляем изображение в анонс статьи
    $modified_excerpt = '<img src="' . $image_url . '" alt="Post Thumbnail">' . $post_excerpt;
    
    return $modified_excerpt;
}
add_filter( 'the_excerpt', 'add_image_to_excerpt' );

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

Как изменить длину обрезанного текста?

Для изменения длины обрезанного текста, отображаемого с помощью хука the_excerpt, можно использовать фильтр excerpt_length. Этот фильтр позволяет задать количество слов, которое будет отображаться в обрезанном тексте.

// Установка длины обрезанного текста в 20 слов
add_filter( 'excerpt_length', function( $length ) {
    return 20;
} );

Как удалить HTML-теги из обрезанного текста?

Если требуется удалить HTML-теги из обрезанного текста, можно воспользоваться фильтром wp_strip_all_tags. Этот фильтр удаляет все HTML-теги из строки.

// Удаление HTML-тегов из обрезанного текста
add_filter( 'the_excerpt', 'wp_strip_all_tags' );

Как добавить ссылку для чтения полного поста?

Для добавления ссылки для чтения полного поста в обрезанный текст, можно использовать фильтр excerpt_more. Этот фильтр позволяет задать текст или HTML-код, который будет добавлен в конец обрезанного текста в качестве ссылки.

// Добавление ссылки для чтения полного поста
add_filter( 'excerpt_more', function( $more ) {
    return ' <a href="' . get_permalink() . '">Читать дальше</a>';
} );

Как изменить символы, используемые для обрезки текста?

Хук the_excerpt позволяет изменить отображаемый обрезанный текст публикации. По умолчанию, WordPress использует символы «…» для обрезки текста. Вы можете изменить эти символы на свои.

Для изменения символов обрезки текста, вам необходимо использовать фильтр excerpt_more. Этот фильтр принимает один параметр — строку символов, которые будут использоваться для обрезки текста.

Пример кода:


function custom_excerpt_more( $more ) {
    return '...';
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );

Как добавить классы к обрезанному тексту?

Хук the_excerpt также позволяет добавить классы к обрезанному тексту публикации. Это может быть полезно, если вы хотите стилизовать обрезанный текст с помощью CSS.

Для добавления классов к обрезанному тексту, вам необходимо использовать фильтр excerpt_class. Этот фильтр принимает один параметр — строку классов, которые будут добавлены к обрезанному тексту.

Пример кода:


function custom_excerpt_class( $class ) {
    return 'custom-class';
}
add_filter( 'excerpt_class', 'custom_excerpt_class' );

Как изменить стиль обрезанного текста?

Хук the_excerpt также позволяет изменить стиль обрезанного текста публикации. Вы можете добавить свои CSS-правила для стилизации обрезанного текста.

Для изменения стиля обрезанного текста, вам необходимо использовать фильтр excerpt_style. Этот фильтр не принимает параметров, но вы можете добавить свои CSS-правила внутри функции обратного вызова.

Пример кода:


function custom_excerpt_style() {
    echo '<style>
        .excerpt {
            color: red;
        }
    </style>';
}
add_action( 'wp_head', 'custom_excerpt_style' );

Как скрыть обрезанный текст, если он пустой?

Если обрезанный текст пустой, то можно скрыть его с помощью хука the_excerpt. Для этого нужно использовать фильтр the_excerpt и проверить, является ли обрезанный текст пустым.


function hide_empty_excerpt( $excerpt ) {
    if ( empty( $excerpt ) ) {
        return '';
    }
    return $excerpt;
}
add_filter( 'the_excerpt', 'hide_empty_excerpt' );

Как добавить кнопку ‘Читать далее’ к обрезанному тексту?

Для добавления кнопки ‘Читать далее’ к обрезанному тексту можно использовать фильтр the_excerpt и добавить необходимый HTML-код после обрезанного текста.


function add_read_more_button( $excerpt ) {
    $excerpt .= ' <a href="' . get_permalink() . '">Читать далее</a>';
    return $excerpt;
}
add_filter( 'the_excerpt', 'add_read_more_button' );

Как изменить стандартный текст ‘Читать далее’?

Для изменения стандартного текста ‘Читать далее’ можно использовать фильтр the_excerpt и заменить текст на необходимый.


function change_read_more_text( $excerpt ) {
    $excerpt = str_replace( 'Читать далее', 'Продолжить чтение', $excerpt );
    return $excerpt;
}
add_filter( 'the_excerpt', 'change_read_more_text' );

Хук the_excerpt позволяет изменять отображаемый обрезанный текст поста. С его помощью можно скрыть пустой обрезанный текст, добавить кнопку ‘Читать далее’ или изменить стандартный текст кнопки. Этот хук является полезным инструментом для настройки отображения обрезанного текста в WordPress.

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

  • Функция get_the_excerpt(): возвращает отформатированный отрывок поста.
  • Функция the_excerpt(): выводит отформатированный отрывок поста.
  • Функция has_excerpt(): проверяет, есть ли у поста отрывок.
  • Функция wp_trim_excerpt(): обрезает отрывок до указанной длины и удаляет HTML-теги.
  • Хук get_the_excerpt: фильтрует отрывок поста, возвращаемый функцией get_the_excerpt.
  • Хук excerpt_length: фильтрует максимальную длину отрывка поста.
  • Хук excerpt_more: фильтрует символы, добавляемые в конец обрезанного отрывка.
Анонс
Обсуждение

Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы принимаете условия пользовательского соглашения и даете свое согласие на использование cookie.