编辑“WordPress:Writing a Plugin”（章节）

== 让你的插件国际化 ==

一旦你插件的程序完成了，另一个需要考虑的是(假设你打算发布你的插件) ''国际化''. 国际化是建立软件的一个过程，这样它才可以''本地化'' ；本地化是翻译软件的显示文本为其他语言。WordPress是全世界使用的，所以它有国际化和本地化版本，包括本地化的插件。想要知道关于WordPress的 GNU gettext的本地化使用，参见[[WordPress:Translating WordPress]]. 

强力推荐你国际化你的插件，这样来自不同国家的用户，可以本地化插件，过程如下:
* 给插件选择一个翻译"文本区域"名字。这通常和你的插件文件名字一样(除了 <tt>.php</tt>), 而且必须是用户安装过的插件中唯一的。
* 不论在哪里插件使用的显示给用户的文本(即"消息"), 使用一个或者两个 WordPress gettext 函数把它们包围起来。注意在插件中，你需要使用第二种方法，你选择的翻译文本区域名字中的传递，不像WordPress核心(留下 <tt>$domain</tt> 这部分空白).
; <tt>__($message, $domain)</tt> :使用现有本地<tt>$domain</tt>翻译 <tt>$message</tt>。换行你将要用来用这个函数计算的文字字符串。
; <tt>_e($message, $domain)</tt> : 使用现有本地<tt>$domain</tt>翻译 <tt>$message</tt>, 然后在屏幕上显示出来，给你使用这个函数直接显示出的文本字符串换行。


* 创建一个POT文件(翻译目录列出了所有的可以翻译的信息)，随着你的插件分发出去。用户将需要把他们的翻译过的MO文件放在你的插件的PHP文件的同一目录下，命名为<tt>domain-ll_CC.mo</tt>，那里<tt>ll_CC</tt>是本地文件的名字。参见[[WordPress:Translating WordPress|翻译WordPress]]以获得关于POT文件，MO文件和本地文件的信息。
* 通过在调用gettext函数之前调用<tt>load_plugin_textdomain</tt>为现有本地文件和你的文本区域文件载入翻译，在session中越晚越好，(因为一些多语言插件载入时改变了本地文件)。一个可能的办法是定义一个初始化函数，在所有插件函数之前调用，如，假设你的文本区域是"fabfunc":
<pre>
$fabfunc_domain = 'fabfunc';
$fabfunc_is_setup = 0;

function fabfunc_setup()
{
   global $fabfunc_domain, $fabfunc_is_setup;

   if($fabfunc_is_setup) {
      return;
   } 

   load_plugin_textdomain($fabfunc_domain, 'wp-content/plugins');
}
</pre>
If your plugin is in its own subdirectory, append that to the second argument of <tt>load_plugin_textdomain</tt>

如果你阅读了这个部分因为你想要国际化一个主题，你大体上可以按照上面的步骤来，除非:
* MO文件在主题目录中(与style.css同样的位置).
* MO 文件命名为<tt>ll_CC.mo</tt>, <tt>ll_CC</tt>是本地文件名(这个域不是文件名字的一部分).
* 想要载入文本域，加入如下代码(在某个PHP 溢出，如果需要的话) 到你的主题的functions.php文件:
<pre>
load_theme_textdomain('your_domain');
</pre>
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*