__( string $text, string $domain = 'default' ): string

User Contributed Notes

1. Skip to note 4 content

   Arun Basil Lal 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 10You must log in to vote on the helpfulness of this note

   For escaping text that contains links, use __() in combination with sprintf. Like this

   sprintf( __( 'You can visit the page by clicking <a href="%s">here</a>.', 'text_domain' ), 
   			'http://example.com'
   		);

   This will prevent the links from being changed by translators.
2. Skip to note 5 content

   Saurabh Ranjan 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 8You must log in to vote on the helpfulness of this note

   We have _e as well which do the same thing but and only difference between them is
   _e echo directly whereas __ we need to echo them.

   For Example:

   _e(‘this is some message’, ‘twentyfourteen’);

   is same as

   echo __(‘this is a some message’, ‘twentyfourteen’);
3. Skip to note 6 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note

   Make a string inside your plugin or theme translatable:

   $translated = __( 'Hello World!', 'mytextdomain' );

   ‘mytextdomain’ needs to be a unique text domain used throughout your plugin/theme. This should always be directly passed as a string literal as shown above, not a string assigned to a variable or constant. E.g., this is incorrect:

   $text_domain = 'mytextdomain';
   $string = 'Hello World!';
   $translated = __( $string, $text_domain );

   This seems to work, but it will interfere in automatic parsing of your plugin/theme’s files for translation.