WordPress函数:load_theme_textdomain()(载入本地化语言文件)
WordPress 做一个多语言网站,或者让我们的主题支持多种语言,那么就可以使用load_theme_textdomain()函数来定义主题的语言路径,只要将语言放到该目录下面且命名正确,就可以生效。
描述
加载翻译后的主题文件语言包文件
用法
<?php load_theme_textdomain( $domain, $path ) ?>
参数
- $domain(字符串)(必需)用以检索被翻译字符串的唯一标识符
- 默认值: None
- $path(未知)(可选)语言包 .mo 文件所在的目录(没有结尾的斜线)
- 默认值:false
返回值
(布尔)如果 textdomain 可以正常加载,返回 TRUE ;反之返回 FALSE
实例
load_theme_textdomain() 必须在 after_setup_theme 动作钩子后调用。
在主题的functions.php中加入以下代码:
add_action('after_setup_theme', 'wpdocs_theme_setup');
/**
* Load translations for wpdocs_theme
*/
function wpdocs_theme_setup(){
load_theme_textdomain('wpdocs_theme', get_template_directory() . '/languages');
}
以上例子,指明主题的语言目录位于该主题的 languages 文件夹。
需要注意的是,WordPress主题语言包不像插件语言包,如果你将主题语言包命名为my_theme-zh_CN.mo ,它是没办法使用的。正确的命名方式是根据本地语言设置命名来命名,比如 zh_CN.mo
如果主题页面中提供语言切换的功能,可通过http://youdomain/?lan=zh-CN的形式切换语言,则需要在functions.php中加入:
// 必须在 load_theme_textdomain() 的前面调用
add_filter( 'locale', 'my_theme_localized' );
function my_theme_localized($locale) {
if (isset($_GET['lan'])) {
return $_GET['lan'];
}
return $locale;
}
load_theme_textdomain( 'my_theme', get_template_directory(). '/languages' );
由于加载语言包会让你的网页加载速度变慢,如果你不想加载语言包,在functions.php中加入以下代码即可:
add_filter( 'locale', 'wpjam_locale' );
function wpjam_locale($locale) {
$locale = ( is_admin() ) ? $locale : 'en_US';
return $locale;
}
让插件调用语言包需在插件的主文件中加入以下代码:
add_action('plugins_loaded', 'plugin_languages_init');
function plugin_languages_init(){
load_plugin_textdomain( 'plugin', dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
需要注意的是,和主题语言包不同,插件语言包的一般命名包含两大部分:插件主文件名+语言及国别简码。如index-zh_CN.po和zh_CN.mo
源文件
load_theme_textdomain() 位于 wp-includes/l10n.php
官方文档:http://codex.wordpress.org/Function_Reference/load_theme_textdomain
本文版权归原作者所有,转载请注明原文来源出处, WordPress教程网 感谢您的支持!
本文链接: http://www.wpcn.net/1861.html
- WordPress手动升级详细步骤
- WordPress手动安全升级
- WordPress后台无插件显示文章和分类ID
- WordPress优化:wp_head和remove_action函数
- query_posts函数把你的wordpress博客变成CMS
- Bootstrap替换WordPress的get_search_form()…
- WordPress 函数:register_sidebar()创建主…
- wp_list_comments()使用回调函数自定义评论…
- WordPress过滤器(Filters):apply_filters和…
- WordPress函数:comments_template(加载评…
- WordPress函数:comment_form( )个性化评论…
- 无处不在的WordPress的主循环
- WordPress 函数do_action()详解和应用举例
- WordPress函数:add_menu_page()后台添加顶…
- WordPress函数:add_theme_page()后台添加设…
- WordPress函数:add_submenu_page()后台为顶…
- WordPress 函数:get_template_part()调用你…
- WordPress函数:load_theme_textdomain()(…
- WordPress 3D旋转彩色标签云
- WordPress文本小工具运行PHP
- WordPress无插件实现主题彩色标签云的N种方…
- WordPress函数:wp_tag_cloud(标签云)详解和…
- WordPress函数:register post type (自定义…
- WordPress使用register_post_type 函数创建…