函数原型
load_theme_textdomain( string $domain, string|false $path = false ): bool
函数描述
Loads the theme’s translated strings.
是否弃用
未弃用
函数参数
-
$domain
string
Required - Text domain. Unique identifier for retrieving translated strings.
-
$path
string|false
Optional - Path to the directory containing the .mo file.
Default:
false
函数返回值
bool True when textdomain is successfully loaded, false otherwise.
函数位置
File: wp-includes/l10n.php.
函数源码
function load_theme_textdomain( $domain, $path = false ) {
/** @var WP_Textdomain_Registry $wp_textdomain_registry */
global $wp_textdomain_registry;
/**
* Filters a theme's locale.
*
* @since 3.0.0
*
* @param string $locale The theme's current locale.
* @param string $domain Text domain. Unique identifier for retrieving translated strings.
*/
$locale = apply_filters( 'theme_locale', determine_locale(), $domain );
$mofile = $domain . '-' . $locale . '.mo';
// Try to load from the languages directory first.
if ( load_textdomain( $domain, WP_LANG_DIR . '/themes/' . $mofile, $locale ) ) {
return true;
}
if ( ! $path ) {
$path = get_template_directory();
}
$wp_textdomain_registry->set_custom_path( $domain, $path );
return load_textdomain( $domain, $path . '/' . $locale . '.mo', $locale );
}
源码链接
变更日志
| Version | Description |
|---|---|
| 4.6.0 | The function now tries to load the .mo file from the languages directory first. |
| 1.5.0 | Introduced. |

