esc_html__( string $text, string $domain = 'default' )

Retrieve the translation of $text and escapes it for safe use in HTML output.

Contents

Description Description

If there is no translation, or the text domain isn’t loaded, the original text is escaped and returned.

Parameters Parameters

$text

(string) (Required) Text to translate.

$domain

(string) (Optional) Text domain. Unique identifier for retrieving translated strings.

Default value: 'default'

Top ↑

Return Return

(string) Translated text

Top ↑

Source Source

File: wp-includes/l10n.php 

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

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.8.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/l10n.php: translate()

Retrieve the translation of $text.
wp-includes/formatting.php: esc_html()

Escaping for HTML blocks.

Top ↑

User Contributed Notes User Contributed Notes

  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Daniel James —

    When using esc_html__, remember that it’s also possible to echo the string value out by using the related esc_html_e which does the same thing but echoes the string too.

    An example:

    <p><?php esc_html_e( 'Hello World!', 'text-domain' ); ?></p>

    You can also read more about esc_html_e too.

You must log in before being able to contribute a note or feedback.