esc_html__()WP 2.8.0

Переводит строку заменяя в ней спецсимволы на HTML сущности. Возвращает текст, которой можно отображать в HTML как HTML код.

Работает на основе: translate(), esc_html()

Хуков нет.

Возвращает

Строку. Оригинальный или отформатированный текст.

Использование

$text = esc_html__( $text, $domain );
$text(строка) (обязательный)
Строка для перевода.
$domain(строка) (обязательный)
Домен (идентификатор) по которому получать перевод.
По умолчанию: 'default'

Примеры

0

#1 Вывод внутрь HTML тега

Если в переводе строки используются HTML теги или символы, который нужно показать как есть, например в поле textarea, то такую строку удобно переводить функцией:

<textarea>
	<?php echo esc_html__('Any text with <span>HTML.</span>', 'kama'); ?>
</textarea>
0

#2 То же самое что в первом примере, но другим способом

<?php echo esc_html( __('Any text with <span>HTML.</span>', 'kama') );

Список изменений

С версии 2.8.0 Введена.

Код esc_html__() WP 6.1.1

function esc_html__( $text, $domain = 'default' ) {
	return esc_html( translate( $text, $domain ) );
}