wp_html_excerpt()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_html_excerpt( string $str, int $count, string $more = null ): string
Описание
Извлечение начальной части строки с безопасной обработкой UTF-8, тегов и сущностей. Сущности внутри НЕ считаются одним символом. Например, & считается как 4 символа, < — как 3 и т. д.
Оригинал (английский)
UTF-8, tags and entities safe prefix extraction. Entities inside will NOT be counted as one character. For example & will be counted as 4, < as 3, etc.
Параметры
$str
string
обязательный
$count
int
обязательный
$more
string
необязательный
= null
Возвращаемое значение
string
Исходный код
wp-includes/formatting.php:5393
function wp_html_excerpt( $str, $count, $more = null ) {
if ( null === $more ) {
$more = '';
}
$str = wp_strip_all_tags( $str, true );
$excerpt = mb_substr( $str, 0, $count );
// Remove part of an entity at the end.
$excerpt = preg_replace( '/&[^;\s]{0,6}$/', '', $excerpt );
if ( $str !== $excerpt ) {
$excerpt = trim( $excerpt ) . $more;
}
return $excerpt;
}
История изменений
| Версия | Описание |
|---|---|
| 2.5.0 | Introduced. |

