加载主题的翻译字符串。

原型

load_theme_textdomain( string $domain, string $path = false )

描述

如果当前区域设置作为主题根目录中的.mo文件存在,则$ domain将包含在已翻译的字符串中。

参数

$domain (string) (Required) 文字域名。用于检索已翻译字符串的唯一标识符

$path (string) (Optional)  包含.mo文件的目录的路径。

返回值

(bool)  成功加载textdomain时为true,否则为false。

源文件

路径:wp-includes/l10n.php

<?php
...
function load_theme_textdomain( $domain, $path = false ) {
	/**
	 * 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 ) ) {
		return true;
	}
	if ( ! $path ) {
		$path = get_template_directory();
	}
	return load_textdomain( $domain, $path . '/' . $locale . '.mo' );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/load_theme_textdomain/