WordPress 多语言支持（本地化）

Posted 2020-10-21 Ryan.zheng

本博客将介绍WordPress的多语言制作

首先需要在wp-content目录下创建一个languages文件夹，用于存放语言包文件。

然后在模板目录下的functions.php，然后在代码中添加函数加载该文件夹，示例代码如下：

add_action(\'after_setup_theme\', \'alanhou_setup\');
function alanhou_setup(){
  load_theme_textdomain(\'alanhou\', get_template_directory.\'/languages\');
}

上面代码表示在主题加载时载入语言文件也就是/wp-content/languages/文件夹下的.mo文件。

load_theme_textdomain（主题本地化）

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

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

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

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

参数

$domain

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

 

默认值： None

$path

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

 

默认值：false

返回的值

（布尔）

如果 textdomain 可以正常加载，返回 TRUE ；反之返回 FALSE

　　关于多语言设置的两种用法，一种是直接设置，另一种是通过点击链接方式设置

 方式一、

add_action(\'after_setup_theme\', \'my_theme_setup\');
function my_theme_setup(){
    load_theme_textdomain(\'my_theme\', get_template_directory() . \'/languages\');
}

　　方式二、如果你希望通过 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\' );

　　

WordPress是怎样知道该读取哪个语言文件呢？其实就是在它的wp-config.php文件中，

添加你的语言和语言环境代码到define。如果你想把你的主题翻译成德语，你可以这样做：

 

define(\'WPLANG\', \'de_DE\');

 

 

怎么运行的

当你通常制作一个主题的时候，你只需要简单地对任何主题文本进行编码，例如404.php文件中的404错误信息，或者诸如“comments：”或者“author：”之类的标签。如果用户的WordPress是德语，这些文本片段仍然会以英文显示。解决这个问题的方法是使用四个WordPress函数之一来返回或回显这些语句，这四个函数被设计为引用正确文本的语言文件。一旦将这些文本包装在这些函数中，就可以创建一个文件，其中包含每次加载主题时引用的所有翻译。有三个翻译文件，我们使用：

• .pot （便携式对象模板） - 这是模板文件，它包含对主题中需要翻译的每个文本字符串的引用。这个文件不包含任何翻译。这是一个明文文件。
• .po （便携式对象） - 由.pot文件构成，.po包含所有的字符串引用以及它们对一种特定语言的翻译。这也是一个可以编辑的纯文本文件。
• .mo （Machine Object） - .po文件的二进制版本。通过使用机器代码，文件的使用速度可以比其明文选择更快。

POEdit是一个非常棒的程序，可以让你创建你的.pot文件，还提供了一个简单易用的图形用户界面，可以用来制作你的.po文件，更重要的是.mo文件。

首先，您需要下载POEdit，您可以在这里找到Windows，Mac和Linux：http : 
//www.poedit.net/download.php

一旦POEdit安装完毕，你可以创建你的.pot文件。要做到这一点，去文件>新目录。您将看到一个对话框，您需要输入一些基本信息。

做完上面的步骤后不出意外你会在你的wordpress仪表盘后台的Setting里面选择网站语言里看到刚刚添加的语言，选上即可。

 

最后就是在你的代码里面用函数_e()包裹待翻译词条实现多语言了，

<?php _e( \'No posts found\' , \'inthy.com\' ) ; ?>

　　参考网站：https://jinwensay.wordpress.com/2009/12/02/make-your-wordpress-theme-translatable/