Метка: тег

the_excerpt()

Отображает выдержку после публикации. Фильтрует отображаемую выдержку.

Источник

Файл: wp-includes/post-template.php Строка 351-361.

function the_excerpt() {

/**

* Filters the displayed post excerpt.

*

* @since 0.71

*

* @see get_the_excerpt()

*

* @param string $post_excerpt The post excerpt.

*/

Назначение

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

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

В автоматически генерированном отрывке будут удалены все короткие коды и теги. Он обрезается до границы слова, а длина по умолчанию составляет 55 слов.

Excerpt является альтернативой использования тега more. В то время, как тег more требует, чтобы автор вручную создавал «разделение» в посте и участвует в создании ссылки «читать дальше»,  Excerpt делает всё в автоматическом режиме и не требует простановки автором никаких тегов.

Тег <! - more -> требуется, чтобы шаблоны использовали функцию the_content (), тогда как для использования отрывков достаточно разработчикам шаблонов явно выбрать, показывать ли полные сообщения (используя the_content () ) или выдержки (используя the_excerpt () ).

Еще функции

• Функция the_post_thumbnail
• Функция the_excerpt()
• Функция get_post
• Функция tag_description
• WordPress 5.0: что ждать в новой версии системы