Описание функции the_excerpt()
Функция the_excerpt() выводит краткое содержание записи, созданное на основе содержимого записи или специального краткого содержания (если оно задано). Это полезно для отображения предварительного просмотра записи на страницах архивов или в виджетах.
Функция автоматически обрезает текст до 55 слов и добавляет многоточие в конце, если текст превышает лимит.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки вывода краткого содержания
Возможные значения:
excerpt_length: Число слов для обрезки текста
excerpt_more: Строка, добавляемая после обрезки текста
Возвращаемое значение
Тип: void
Описание: Выводит краткое содержание записи на экран
Возможные значения:
• Строка с кратким содержанием
• Пустая строка если контент отсутствует
Примеры использования
Выводит краткое содержание текущей записи
the_excerpt();
Отобразит 55 слов из записи или специальное краткое содержание
Настройка длины краткого содержания и добавление многоточия
$args = array(
'excerpt_length' => 20,
'excerpt_more' => '...'
);
add_filter('excerpt_length', function() use ($args) { return $args['excerpt_length']; });
add_filter('excerpt_more', function() use ($args) { return $args['excerpt_more']; });
the_excerpt();
Отобразит 20 слов с многоточием в конце
Безопасность
Валидация входных данных: Параметры проходят валидацию через фильтры
Санитизация: Входные данные очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS
— Связанные функции
Получает краткое содержание записи без вывода
Выводит полное содержание записи
— Хуки
Фильтрует длину краткого содержания
Фильтрует текст, добавляемый после обрезки
— Примечания
– Ограничения
Не поддерживает HTML-теги в выводе
– Частые проблемы
- Краткое содержание не отображается, если запись не имеет контента
- Неверные параметры могут привести к неожиданному поведению
