функция since 2.5.0

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
Что добавить, если $str требуется обрезать. Значение по умолчанию — пустая строка.

Возвращаемое значение

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.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.