# wp_html_excerpt()

URL: https://chugunov.pro/api-wordpress/functions/wp_html_excerpt/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.5.0.

## Сигнатура

```php
wp_html_excerpt( string $str, int $count, string $more = null ): string
```

## Описание

Извлечение начальной части строки с безопасной обработкой UTF-8, тегов и сущностей. Сущности внутри НЕ считаются одним символом. Например, & считается как 4 символа, < — как 3 и т. д.

## Параметры

- `$str` `string` — обязательный. Строка, из которой берётся отрывок.
- `$count` `int` — обязательный. Максимальное количество символов для извлечения.
- `$more` `string` — необязательный, по умолчанию `null`. Что добавить, если $str требуется обрезать. Значение по умолчанию — пустая строка.

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

`string`

## Исходный код

Файл: `wp-includes/formatting.php:5393`

```php
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.

## Связанные

Использует: [`wp_strip_all_tags`](https://chugunov.pro/api-wordpress/functions/wp_strip_all_tags/).
Используется в: `WP_Customize_Nav_Menus::customize_register`, [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), `WP_Comments_List_Table::column_author`, [`wp_admin_bar_site_menu`](https://chugunov.pro/api-wordpress/functions/wp_admin_bar_site_menu/), [`do_trackbacks`](https://chugunov.pro/api-wordpress/functions/do_trackbacks/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_html_excerpt/