> WordPress开发手册 > load_theme_textdomain

load_theme_textDOMain


描述

加载翻译后的主题字符串。

如果本地主题根目录下有一个.mo文件,该文件会被包括在$domain的被翻译字符串中。

.mo文件必须根据本地设置命名。

用法

<?PHP load_theme_textdomain( $domain, $path ) ?>

参数

$domain

    (字符串)(必需)用以检索被翻译字符串的唯一标识符

        默认值: None

$path

    (未知)(可选)语言包 .mo 文件所在的目录(没有结尾的斜线)

        默认值:false

返回的值

(布尔)

    如果 textdomain 可以正常加载,返回 TRUE ;反之返回 FALSE

例 1

load_theme_textdomain() 必须在 after_setup_theme 动作钩子后调用。
    add_action('after_setup_theme', 'my_theme_setup');
    function my_theme_setup(){
        load_theme_textdomain('my_theme', get_template_directory() . '/languages');
    }

以上例子,指明主题的语言目录位于该主题的 languages  文件夹。

需要注意的是,WordPress主题语言包不像插件语言包,如果你将主题语言包命名为my_theme-zh_CN.mo ,它是没办法使用的。正确的命名方式是根据本地语言设置命名来命名,比如 zh_CN.mo

例 2

如果你希望通过 URL 中的参数来调用不同的语言,比如 www.example.com/?l=zh_CN 就调用 zh_CN.mo ,那你可以参考下面的例子:

// 更改本地语言
    // 必须在 load_theme_textdomain() 的前面调用
    add_filter( 'locale', 'my_theme_localized' );
    function my_theme_localized($locale) {
    if (isset($_GET['l'])) {
    return $_GET['l'];
    }
    return $locale;
    }
    // 设置主题语言路径
    // 语言包应该访问 my_theme/languages/ 目录
    // Wordpress 自身语言包放在 wp-content/languages/ 目录
    load_theme_textdomain( 'my_theme', TEMPLATEPATH . '/languages' );

注释

国际化和本地化是指计算机软件来适应不同的语言。

l10n 是 localization 的缩写,i18n的18代表第i个和最后的N国际之间的字母数。

函数历史

始见于1.5.0版本

源文件

load_theme_textdomain() 位于 wp-includes/l10n.php



上一篇:
下一篇: