_e( string $text, string $domain = 'default' )
Display translated text.
Parameters #Parameters
- $text
-
(string) (Required) Text to translate.
- $domain
-
(string) (Optional) Text domain. Unique identifier for retrieving translated strings.
Default value: 'default'
Source #Source
File: wp-includes/l10n.php
function _e( $text, $domain = 'default' ) {
echo translate( $text, $domain );
}
Expand full source code Collapse full source code View on Trac
Related #Related
Uses #Uses
| Uses | Description |
|---|---|
| wp-includes/l10n.php: translate() |
Retrieve the translation of $text. |
Used By #Used By
| Used By | Description |
|---|---|
| wp-admin/includes/class-wp-application-passwords-list-table.php: WP_Application_Passwords_List_Table::display_tablenav() |
Generates custom table navigation to prevent conflicting nonces. |
| wp-admin/update-core.php: core_auto_updates_settings() |
Display WordPress auto-updates settings. |
| wp-admin/includes/dashboard.php: wp_dashboard_site_health() |
Displays the Site Health Status widget. |
| wp-admin/includes/class-wp-privacy-data-removal-requests-list-table.php: WP_Privacy_Data_Removal_Requests_List_Table::column_next_steps() |
Next steps column. |
| wp-admin/includes/class-wp-privacy-data-export-requests-list-table.php: WP_Privacy_Data_Export_Requests_List_Table::column_next_steps() |
Displays the next steps column. |
| wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::formats_dropdown() |
Displays a formats drop-down for filtering items. |
| wp-admin/includes/dashboard.php: wp_dashboard_php_nag() |
Displays the PHP update nag. |
| wp-admin/includes/template.php: do_block_editor_incompatible_meta_box() |
Function that renders a “fake” meta box with an information message, shown on the block editor, when an incompatible meta box is found. |
| wp-admin/includes/class-wp-privacy-policy-content.php: WP_Privacy_Policy_Content::privacy_policy_guide() |
Output the privacy policy guide together with content from the theme and plugins. |
| wp-includes/widgets/class-wp-widget-custom-html.php: WP_Widget_Custom_HTML::render_control_template_scripts() |
Render form template scripts. |
| wp-includes/customize/class-wp-customize-themes-panel.php: WP_Customize_Themes_Panel::content_template() |
An Underscore (JS) template for this panel’s content (but not its container). |
| wp-includes/customize/class-wp-customize-themes-section.php: WP_Customize_Themes_Section::render_template() |
Render a themes section as a JS template. |
| wp-includes/customize/class-wp-customize-themes-section.php: WP_Customize_Themes_Section::filter_bar_content_template() |
Render the filter bar portion of a themes section as a JS template. |
| wp-admin/includes/misc.php: wp_print_plugin_file_tree() |
Outputs the formatted file list for the plugin editor. |
| wp-admin/includes/misc.php: wp_print_theme_file_tree() |
Outputs the formatted file list for the theme editor. |
| wp-admin/includes/file.php: wp_print_file_editor_templates() |
Prints file editor templates (for plugins and themes). |
| wp-includes/widgets/class-wp-widget-text.php: WP_Widget_Text::render_control_template_scripts() |
Render form template scripts. |
| wp-includes/widgets/class-wp-widget-media-audio.php: WP_Widget_Media_Audio::render_control_template_scripts() |
Render form template scripts. |
| wp-includes/widgets/class-wp-widget-media-video.php: WP_Widget_Media_Video::render_control_template_scripts() |
Render form template scripts. |
| wp-includes/widgets/class-wp-widget-media-image.php: WP_Widget_Media_Image::render_control_template_scripts() |
Render form template scripts. |
| wp-admin/includes/dashboard.php: wp_print_community_events_markup() |
Prints the markup for the Community Events section of the Events and News Dashboard widget. |
| wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::print_post_type_container() |
Print the markup for new menu items. |
| wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::print_custom_links_available_menu_item() |
Print the markup for available menu item custom links. |
| wp-includes/customize/class-wp-customize-background-position-control.php: WP_Customize_Background_Position_Control::content_template() |
Render a JS template for the content of the position control. |
| wp-admin/includes/update.php: wp_print_admin_notice_templates() |
Prints the JavaScript templates for update admin notices. |
| wp-includes/embed.php: print_embed_sharing_dialog() |
Prints the necessary markup for the embed sharing dialog. |
| wp-admin/includes/class-wp-screen.php: WP_Screen::render_meta_boxes_preferences() |
Render the meta boxes preferences. |
| wp-admin/includes/class-wp-screen.php: WP_Screen::render_view_mode() |
Render the list table view mode preferences. |
| wp-includes/customize/class-wp-customize-nav-menu-auto-add-control.php: WP_Customize_Nav_Menu_Auto_Add_Control::content_template() |
Render the Underscore template for this control. |
| wp-includes/customize/class-wp-customize-new-menu-control.php: WP_Customize_New_Menu_Control::render_content() |
Render the control’s content. |
| wp-includes/customize/class-wp-customize-nav-menu-location-control.php: WP_Customize_Nav_Menu_Location_Control::render_content() |
Render content just like a normal select control. |
| wp-includes/customize/class-wp-customize-nav-menu-item-control.php: WP_Customize_Nav_Menu_Item_Control::content_template() |
JS/Underscore template for the control UI. |
| wp-includes/customize/class-wp-customize-nav-menu-control.php: WP_Customize_Nav_Menu_Control::content_template() |
JS/Underscore template for the control UI. |
| wp-includes/class-wp-customize-panel.php: WP_Customize_Panel::render_template() |
An Underscore (JS) template for rendering this panel’s container. |
| wp-includes/class-wp-customize-panel.php: WP_Customize_Panel::content_template() |
An Underscore (JS) template for this panel’s content (but not its container). |
| wp-includes/customize/class-wp-customize-nav-menus-panel.php: WP_Customize_Nav_Menus_Panel::content_template() |
An Underscore (JS) template for this panel’s content (but not its container). |
| wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::print_templates() |
Print the JavaScript templates used to render Menu Customizer components. |
| wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::available_items_template() |
Print the HTML template used to render the add-menu-item frame. |
| wp-includes/class-wp-customize-section.php: WP_Customize_Section::render_template() |
An Underscore (JS) template for rendering this section. |
| wp-admin/includes/class-wp-links-list-table.php: WP_Links_List_Table::column_visible() |
Handles the link visibility column output. |
| wp-admin/includes/class-wp-ms-themes-list-table.php: WP_MS_Themes_List_Table::column_cb() |
Handles the checkbox column output. |
| wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::column_parent() |
Handles the parent column output. |
| wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::column_title() |
Handles the title column output. |
| wp-includes/customize/class-wp-customize-theme-control.php: WP_Customize_Theme_Control::content_template() |
Render a JS template for theme display. |
| wp-admin/includes/theme.php: customize_themes_print_templates() |
Print JS templates for the theme-browsing UI in the Customizer. |
| wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::render_control_templates() |
Render JS templates for all registered control types. |
| wp-admin/includes/revision.php: wp_print_revision_templates() |
Print JavaScript templates required for the revisions experience. |
| wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::views() |
Override parent views so we can use the filter bar display. |
| wp-signup.php: show_user_form() |
Displays the fields for the new user account registration form. |
| wp-signup.php: signup_another_blog() |
Allow returning users to sign up for another site |
| wp-signup.php: signup_user() |
Shows a form for a visitor to sign up for a new user account. |
| wp-signup.php: confirm_user_signup() |
New user signup confirmation |
| wp-signup.php: confirm_blog_signup() |
Shows a message confirming that the new site has been registered and is awaiting activation. |
| wp-signup.php: show_blog_form() |
Generates and displays the Signup and Create Site forms |
| wp-admin/includes/network.php: network_step1() |
Prints step 1 for Network installation process. |
| wp-admin/includes/network.php: network_step2() |
Prints step 2 for Network installation process. |
| wp-admin/install.php: display_header() |
Display installation header. |
| wp-admin/install.php: display_setup_form() |
Display installer setup form. |
| wp-admin/includes/user.php: use_ssl_preference() |
Optional SSL preference that can be turned on by hooking to the ‘personal_options’ action. |
| wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::no_items() | |
| wp-admin/includes/class-wp-screen.php: WP_Screen::render_screen_layout() |
Render the option for number of columns on the page |
| wp-admin/includes/class-wp-screen.php: WP_Screen::render_per_page_options() |
Render the items per page option |
| wp-admin/includes/class-wp-screen.php: WP_Screen::render_screen_meta() |
Render the screen’s help section. |
| wp-admin/includes/class-wp-plugins-list-table.php: WP_Plugins_List_Table::no_items() | |
| wp-admin/includes/class-wp-links-list-table.php: WP_Links_List_Table::no_items() | |
| wp-admin/includes/theme-install.php: install_theme_search_form() |
Display search form for searching themes. |
| wp-admin/includes/theme-install.php: install_themes_dashboard() |
Display tags filter for themes. |
| wp-admin/includes/theme-install.php: install_themes_upload() | |
| wp-admin/includes/class-wp-list-table.php: WP_List_Table::no_items() |
Message to be displayed when there are no items |
| wp-admin/includes/class-wp-list-table.php: WP_List_Table::months_dropdown() |
Displays a dropdown for filtering items in the list table by month. |
| wp-admin/includes/ms.php: choose_primary_blog() |
Handles the display of choosing a user’s primary site. |
| wp-admin/includes/ms.php: upload_space_setting() |
Displays the site upload space quota setting form on the Edit Site Settings screen. |
| wp-admin/includes/image-edit.php: wp_image_editor() |
Loads the WP image-editing interface. |
| wp-admin/includes/class-wp-ms-themes-list-table.php: WP_MS_Themes_List_Table::no_items() | |
| wp-admin/includes/misc.php: admin_color_scheme_picker() |
Display the default admin color scheme picker (Used in user-edit.php) |
| wp-admin/includes/class-wp-theme-install-list-table.php: WP_Theme_Install_List_Table::install_theme_info() |
Prints the info for a theme (to be used in the theme installer modal). |
| wp-admin/includes/class-wp-theme-install-list-table.php: WP_Theme_Install_List_Table::no_items() | |
| wp-admin/includes/class-wp-theme-install-list-table.php: WP_Theme_Install_List_Table::single_row() |
Prints a theme from the WordPress.org API. |
| wp-admin/includes/class-wp-theme-install-list-table.php: WP_Theme_Install_List_Table::theme_installer() |
Prints the wrapper for the theme installer. |
| wp-admin/includes/plugin-install.php: install_dashboard() | |
| wp-admin/includes/plugin-install.php: install_search_form() |
Displays a search form for searching plugins. |
| wp-admin/includes/plugin-install.php: install_plugins_upload() |
Upload from zip |
| wp-admin/includes/plugin-install.php: install_plugins_favorites_form() |
Show a username form for the favorites page |
| wp-admin/includes/plugin-install.php: install_plugin_information() |
Display plugin information in dialog box form. |
| wp-admin/includes/dashboard.php: wp_welcome_panel() |
Displays a welcome panel to introduce users to WordPress. |
| wp-admin/includes/dashboard.php: wp_dashboard_quota() |
Displays file upload quota on dashboard. |
| wp-admin/includes/dashboard.php: wp_network_dashboard_right_now() | |
| wp-admin/includes/dashboard.php: wp_dashboard_quick_press() |
The Quick Draft widget display and creation of drafts. |
| wp-admin/includes/user.php: default_password_nag() | |
| wp-admin/includes/class-wp-plugin-install-list-table.php: WP_Plugin_Install_List_Table::display_rows() | |
| wp-admin/includes/class-wp-plugin-install-list-table.php: WP_Plugin_Install_List_Table::no_items() | |
| wp-admin/includes/template.php: _local_storage_notice() |
Output the HTML for restoring the post data from DOM storage |
| wp-admin/includes/template.php: find_posts_div() |
Outputs the modal window used for attaching media to posts or pages in the media-listing screen. |
| wp-admin/includes/template.php: iframe_header() |
Generic Iframe header for use with Thickbox |
| wp-admin/includes/template.php: wp_comment_reply() |
Outputs the in-line comment reply-to form in the Comments list table. |
| wp-admin/includes/template.php: wp_comment_trashnotice() |
Output ‘undo move to Trash’ text for comments |
| wp-admin/includes/template.php: list_meta() |
Outputs a post’s public meta data in the Custom Fields meta box. |
| wp-admin/includes/template.php: meta_form() |
Prints the form in the Custom Fields meta box. |
| wp-admin/includes/template.php: touch_time() |
Print out HTML form date elements for editing post or comment publish date. |
| wp-admin/includes/template.php: wp_import_upload_form() |
Outputs the form used by the importers to accept the data to be imported |
| wp-admin/includes/template.php: do_accordion_sections() |
Meta Box Accordion Template Function. |
| wp-admin/includes/class-wp-themes-list-table.php: WP_Themes_List_Table::no_items() | |
| wp-admin/includes/class-wp-themes-list-table.php: WP_Themes_List_Table::display_rows() | |
| wp-admin/includes/class-wp-ms-sites-list-table.php: WP_MS_Sites_List_Table::no_items() | |
| wp-admin/includes/class-wp-users-list-table.php: WP_Users_List_Table::no_items() |
Output ‘no users’ message. |
| wp-admin/includes/class-wp-users-list-table.php: WP_Users_List_Table::extra_tablenav() |
Output the controls to allow user roles to be changed in bulk. |
| wp-admin/includes/media.php: media_upload_type_form() |
Outputs the legacy media upload form for a given media type. |
| wp-admin/includes/media.php: media_upload_type_url_form() |
Outputs the legacy media upload form for external media. |
| wp-admin/includes/media.php: media_upload_gallery_form() |
Adds gallery form to upload iframe |
| wp-admin/includes/media.php: media_upload_library_form() |
Outputs the legacy media upload form for the media library. |
| wp-admin/includes/media.php: media_upload_html_bypass() |
Displays the browser’s built-in uploader message. |
| wp-admin/includes/media.php: edit_form_image_editor() |
Displays the image and editor in the post editor |
| wp-admin/includes/media.php: attachment_submitbox_metadata() |
Displays non-editable attachment metadata in the publish meta box. |
| wp-admin/includes/media.php: media_upload_form() |
Outputs the legacy media upload form. |
| wp-admin/includes/media.php: wp_iframe() |
Outputs the iframe to display the media upload page. |
| wp-admin/includes/post.php: _admin_notice_post_locked() |
Outputs the HTML for the notice to say that someone else is editing or has taken over editing of this post. |
| wp-admin/includes/meta-boxes.php: post_trackback_meta_box() |
Display trackback links form fields. |
| wp-admin/includes/meta-boxes.php: post_comment_status_meta_box() |
Display comments status form fields. |
| wp-admin/includes/meta-boxes.php: post_comment_meta_box() |
Display comments for post. |
| wp-admin/includes/meta-boxes.php: post_slug_meta_box() |
Display slug form fields. |
| wp-admin/includes/meta-boxes.php: post_author_meta_box() |
Display form field with list of authors. |
| wp-admin/includes/meta-boxes.php: page_attributes_meta_box() |
Display page attributes form fields. |
| wp-admin/includes/meta-boxes.php: link_submit_meta_box() |
Display link create form fields. |
| wp-admin/includes/meta-boxes.php: link_categories_meta_box() |
Display link categories form fields. |
| wp-admin/includes/meta-boxes.php: link_target_meta_box() |
Display form fields for changing link target. |
| wp-admin/includes/meta-boxes.php: link_xfn_meta_box() |
Display xfn form fields. |
| wp-admin/includes/meta-boxes.php: link_advanced_meta_box() |
Display advanced link options form fields. |
| wp-admin/includes/meta-boxes.php: post_submit_meta_box() |
Displays post submit form fields. |
| wp-admin/includes/meta-boxes.php: post_format_meta_box() |
Display post format form elements. |
| wp-admin/includes/meta-boxes.php: post_excerpt_meta_box() |
Display post excerpt form fields. |
| wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::no_items() | |
| wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::no_items() | |
| wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::column_cb() | |
| wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::inline_edit() |
Outputs the hidden row displayed when inline editing |
| wp-admin/includes/class-walker-nav-menu-edit.php: Walker_Nav_Menu_Edit::start_el() |
Start the element output. |
| wp-admin/includes/nav-menu.php: wp_nav_menu_item_link_meta_box() |
Displays a meta box for the custom links menu item. |
| wp-admin/includes/nav-menu.php: wp_nav_menu_item_post_type_meta_box() |
Displays a meta box for a post type menu item. |
| wp-admin/includes/nav-menu.php: wp_nav_menu_item_taxonomy_meta_box() |
Displays a meta box for a taxonomy menu item. |
| wp-admin/includes/file.php: request_filesystem_credentials() |
Displays a form to the user to request for their FTP/SSH details in order to connect to the filesystem. |
| wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::inline_edit() |
Outputs the hidden row displayed when inline editing |
| wp-admin/includes/widgets.php: wp_widget_control() |
Meta widget used to display the control form for a widget. |
| wp-admin/includes/class-custom-image-header.php: Custom_Image_Header::step_1() |
Display first step of custom header image page. |
| wp-admin/includes/class-custom-image-header.php: Custom_Image_Header::step_2() |
Display second step of custom header image page. |
| wp-admin/includes/class-custom-image-header.php: Custom_Image_Header::show_header_selector() |
Display UI for selecting one of several default headers. |
| wp-admin/includes/ms.php: confirm_delete_users() | |
| wp-admin/update-core.php: core_upgrade_preamble() |
Display upgrade WordPress for downloading latest or upgrading automatically form. |
| wp-admin/update-core.php: list_plugin_updates() |
Display the upgrade plugins form. |
| wp-admin/update-core.php: list_theme_updates() |
Display the upgrade themes form. |
| wp-admin/update-core.php: list_translation_updates() |
Display the update translations form. |
| wp-admin/update-core.php: do_core_upgrade() |
Upgrade WordPress core display. |
| wp-admin/includes/class-custom-background.php: Custom_Background::admin_page() |
Display the custom background page. |
| wp-includes/functions.php: wp_auth_check_html() |
Output the HTML that shows the wp-login dialog when the user is no longer logged in. |
| wp-includes/widgets/class-wp-nav-menu-widget.php: WP_Nav_Menu_Widget::form() |
Outputs the settings form for the Navigation Menu widget. |
| wp-includes/widgets/class-wp-widget-recent-comments.php: WP_Widget_Recent_Comments::form() |
Outputs the settings form for the Recent Comments widget. |
| wp-includes/widgets/class-wp-widget-tag-cloud.php: WP_Widget_Tag_Cloud::form() |
Outputs the Tag Cloud widget settings form. |
| wp-includes/widgets/class-wp-widget-categories.php: WP_Widget_Categories::form() |
Outputs the settings form for the Categories widget. |
| wp-includes/widgets/class-wp-widget-recent-posts.php: WP_Widget_Recent_Posts::form() |
Outputs the settings form for the Recent Posts widget. |
| wp-includes/widgets/class-wp-widget-text.php: WP_Widget_Text::form() |
Outputs the Text widget settings form. |
| wp-includes/widgets/class-wp-widget-calendar.php: WP_Widget_Calendar::form() |
Outputs the settings form for the Calendar widget. |
| wp-includes/widgets/class-wp-widget-archives.php: WP_Widget_Archives::form() |
Outputs the settings form for the Archives widget. |
| wp-includes/widgets/class-wp-widget-search.php: WP_Widget_Search::form() |
Outputs the settings form for the Search widget. |
| wp-includes/widgets/class-wp-widget-meta.php: WP_Widget_Meta::widget() |
Outputs the content for the current Meta widget instance. |
| wp-includes/widgets/class-wp-widget-meta.php: WP_Widget_Meta::form() |
Outputs the settings form for the Meta widget. |
| wp-includes/widgets/class-wp-widget-pages.php: WP_Widget_Pages::form() |
Outputs the settings form for the Pages widget. |
| wp-includes/widgets/class-wp-widget-links.php: WP_Widget_Links::form() |
Outputs the settings form for the Links widget. |
| wp-includes/widgets.php: wp_widget_rss_form() |
Display RSS widget options form. |
| wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::_render() | |
| wp-includes/rss.php: wp_rss() |
Display all RSS items in a HTML ordered list. |
| wp-includes/customize/class-wp-widget-area-customize-control.php: WP_Widget_Area_Customize_Control::render_content() |
Renders the control’s content. |
| wp-includes/customize/class-wp-customize-header-image-control.php: WP_Customize_Header_Image_Control::print_header_image_template() | |
| wp-includes/customize/class-wp-customize-header-image-control.php: WP_Customize_Header_Image_Control::render_content() | |
| wp-includes/class-wp-customize-control.php: WP_Customize_Control::render_content() |
Render the control’s content. |
| wp-includes/class-walker-comment.php: Walker_Comment::ping() |
Outputs a pingback comment. |
| wp-includes/comment-template.php: comments_popup_link() |
Displays the link to the comments for the current post ID. |
| wp-includes/class-wp-customize-widgets.php: WP_Customize_Widgets::output_widget_control_templates() |
Renders the widget form control templates into the DOM. |
| wp-includes/class-wp-editor.php: _WP_Editors::wp_link_dialog() |
Dialog for internal linking. |
| wp-includes/media-template.php: wp_print_media_templates() |
Prints the templates used in the media manager. |
Changelog #Changelog
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |
User Contributed Notes #User Contributed Notes
You must log in before being able to contribute a note or feedback.
Basic Example
Display some translated text:
The WordPress documentation states that you should not use
but use
instead.
In this function,the “$domain” is used to locate the multilingual file.(The file which is the translation of your theme.)
In wp-include there is a function related to this var
function load_theme_textdomain( $domain, $path = false ) { $locale = apply_filters( 'theme_locale', get_locale(), $domain ); if ( ! $path ) $path = get_template_directory(); // Load the textdomain from the Theme provided location, or theme directory first $mofile = "{$path}/{$locale}.mo"; if ( $loaded = load_textdomain($domain, $mofile) ) return $loaded; // Else, load textdomain from the Language directory $mofile = WP_LANG_DIR . "/themes/{$domain}-{$locale}.mo"; return load_textdomain($domain, $mofile); }Expand full source codeCollapse full source code
You can see $domain is used in this file.Actually it’s used to locate the .mo file.So you must may sure it share the same name with your theme folder name
This function is same as
echo __like:Important security note:
_e()is not an escaping function. Since all output really needs to be escaped, consider using__()instead.For example, this is safe:
echo esc_html( __( 'This is my translatable text' ) )But this might not be, because the output can get filtered and is not escaped close to where it is output:
_e( 'This is my translatable text' )