wp_trim_excerpt()
Создает цитату из контента поста, когда цитата (отрывок) не указана. Используется внутри Цикла WordPress.
По умолчанию текст обрезается до 55 слов и в конце добавляется "[…]
". Если переданный текст содержит меньше 55 слов, то он будет возвращен без изменений.
Ограничение в 55 слов может быть изменено в плагинах и темах, через фильтр excerpt_length, а конструкция в конце цитаты "[…]
", может быть заменена через фильтр excerpt_more.
Если параметр $text не передан (пустой), то функция получит контент текущей записи (возьмет его начальный кусок).
Хуки из функции
Возвращает
Строку
. Обрезанную строку.
Использование
wp_trim_excerpt( $text );
- $text(cтрока)
- Цитата. Если указать пустое значение, то функция получит контент текущего поста и сгенерирует цитату. Если указать текст, то функцию не обрежет его, а вернет как есть.
По умолчанию: ''
Примеры
#1 Демонстрация работы
Допустим у нас для постов предусмотрены отдельные цитаты и нам нужно проверить, если такая цитата у поста есть, то нужно вывести её, а если её нет, то нужно вывести обрезанный текст текущего поста:
$excerpt = get_post_meta($post->ID, 'special_excerpt', 1); $text = wp_trim_excerpt( $excerpt ); echo $text;
#2 Вывод короткого текста (выдержки) для поста
Если у нас уже есть выдержка, и мы просто хотим обрезать ее:
echo "Here is short info about post: \n" . wp_trim_excerpt( $excerpt );
Если готовой выдержки нет, то можно передать ИД поста, тогда функция создаст её из контента:
echo "Here is short info about post: \n" . wp_trim_excerpt( '', $post_id );
Список изменений
С версии 1.5.0 | Введена. |
С версии 5.2.0 | Added the $post parameter. |