В этой статье мы рассмотрим функцию the_excerpt() в WordPress, которая используется для получения и вывода отрывка текущего поста или страницы. Эта функция полезна для отображения краткого содержания поста на главной странице, в архивах и в результатах поиска.
Описание функции
Функция the_excerpt() в WordPress выводит отрывок текущего поста или страницы. Если отрывок не задан вручную, WordPress автоматически создает его, обрезая содержимое поста до заданного количества слов.
the_excerpt()Параметры:
- Функция не принимает параметров.
Возвращаемое значение:
- Функция выводит отрывок текущего поста или страницы.
Примеры использования
Рассмотрим несколько примеров использования функции the_excerpt().
Пример 1: Вывод отрывка поста на главной странице
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
echo '<h2>' . get_the_title() . '</h2>';
the_excerpt();
}
}
В этом примере the_excerpt() используется для вывода отрывка каждого поста на главной странице. Заголовок поста выводится с помощью функции get_the_title().
Пример 2: Добавление ссылки «Читать далее» к отрывку
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
echo '<h2>' . get_the_title() . '</h2>';
the_excerpt();
echo '<a href="' . get_permalink() . '">Читать далее</a>';
}
}
Здесь the_excerpt() используется вместе с ссылкой «Читать далее», которая ведет на полный пост.
Пример 3: Использование отрывка в архивах archive.php
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
echo '<article>';
echo '<header><h2>' . get_the_title() . '</h2></header>';
the_excerpt();
echo '</article>';
}
}
В этом примере the_excerpt() используется для вывода отрывка каждого поста в архиве. Посты обернуты в элементы article для улучшения семантики HTML.
Пример 4: Кастомизация длины отрывка
Чтобы изменить длину отрывка, можно использовать фильтр excerpt_length в файле functions.php темы:
function my_custom_excerpt_length( $length ) {
return 20; // Устанавливаем длину отрывка в 20 слов
}
add_filter( 'excerpt_length', 'my_custom_excerpt_length' );
Теперь все отрывки будут обрезаться до 20 слов.
Пример 5: Кастомизация текста «Читать далее»
Для изменения текста «Читать далее» можно использовать фильтр excerpt_more:
function my_custom_excerpt_more( $more ) {
return '... <a href="' . get_permalink() . '">Читать далее</a>';
}
add_filter( 'excerpt_more', 'my_custom_excerpt_more' );
Этот код добавляет ссылку «Читать далее» к каждому отрывку.
Зачем использовать the_excerpt()?
- Краткое содержание: Функция
the_excerpt()позволяет выводить краткое содержание постов, что улучшает пользовательский опыт и помогает пользователям быстро понять суть поста. - Гибкость: Функция может использоваться в различных контекстах, таких как главная страница, архивы и результаты поиска, что делает её очень гибкой.
Заключение по the_excerpt
Функция the_excerpt() в WordPress является важным инструментом для получения и вывода отрывка текущего поста или страницы. Её использование упрощает отображение краткого содержания постов и улучшает навигацию на сайте.