WordPress函数：load_plugin_textdomain（插件本地化）

本文目录
[隐藏]

• 1描述
• 2用法
• 3参数
• 4返回的值
• 5例子
• 6注释
• 7函数历史
• 8源文件

描述

加载翻译后的插件字符串。

如果未给出路径，默认路径为插件根目录。.mo文件路径基于带有破折号的域名命名，域名后应跟有一个破折号，破折号后为本地语言简码。 这里的本地语言简码是指你在wp-config.php中填写的 WPLANG 的值，比如你填写的是 zh_CN ，那么就该使用 zh_CN，如果你的插件的 text domain 为 “my-plugin”，那么语言包的名字应该为 “my-plugin-zh_CN.mo”和 “my-plugin-zh_CN.po”。

用法

1

<?php load_plugin_textdomain( $domain, $abs_rel_path, $plugin_rel_path ) ?>

<?php load_plugin_textdomain( $domain, $abs_rel_path, $plugin_rel_path ) ?>

参数

$domain

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

默认值：None

$abs_rel_path

（字符串）（可选）.mo文件所在文件夹的ABSPATH的相对路径。该参数已弃用，但在WP 2.7前仍然有效。

默认值：false

$plugin_rel_path

（字符串）（可选）WP_PLUGIN_DIR的相对路径。推荐使用该参数，其优先级高于$abs_rel_path。

默认值：false

返回的值

（空）

该函数不返回任何值

例子

1
2
3
4

function myplugin_init() {
  load_plugin_textdomain( 'my-plugin', false, dirname( plugin_basename( __FILE__ ) ) ); 
}
add_action('plugins_loaded', 'myplugin_init');

function myplugin_init() { load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILE__ ) ) ); } add_action(‘plugins_loaded’, ‘myplugin_init’);

或者你打算将语言包放在一个子文件夹 languages ：

1

load_plugin_textdomain( 'my-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );

load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );

注释

l10n是localization的缩写形式

函数历史

始见于1.5.0版本

2.7.0 版本以后，$abs_rel_path 参数被弃用！

源文件