編輯“WordPress:Writing a Plugin”（章節(jié)）

== 讓你的插件國際化 ==

一旦你插件的程序完成了，另一個需要考慮的是(假設(shè)你打算發(fā)布你的插件) ''國際化''. 國際化是建立軟件的一個過程，這樣它才可以''本地化'' ；本地化是翻譯軟件的顯示文本為其他語言。WordPress是全世界使用的，所以它有國際化和本地化版本，包括本地化的插件。想要知道關(guān)于WordPress的 GNU gettext的本地化使用，參見[[WordPress:Translating WordPress]]. 

強力推薦你國際化你的插件，這樣來自不同國家的用戶，可以本地化插件，過程如下:
* 給插件選擇一個翻譯"文本區(qū)域"名字。這通常和你的插件文件名字一樣(除了 <tt>.php</tt>), 而且必須是用戶安裝過的插件中唯一的。
* 不論在哪里插件使用的顯示給用戶的文本(即"消息"), 使用一個或者兩個 WordPress gettext 函數(shù)把它們包圍起來。注意在插件中，你需要使用第二種方法，你選擇的翻譯文本區(qū)域名字中的傳遞，不像WordPress核心(留下 <tt>$domain</tt> 這部分空白).
; <tt>__($message, $domain)</tt> :使用現(xiàn)有本地<tt>$domain</tt>翻譯 <tt>$message</tt>。換行你將要用來用這個函數(shù)計算的文字字符串。
; <tt>_e($message, $domain)</tt> : 使用現(xiàn)有本地<tt>$domain</tt>翻譯 <tt>$message</tt>, 然后在屏幕上顯示出來，給你使用這個函數(shù)直接顯示出的文本字符串換行。


* 創(chuàng)建一個POT文件(翻譯目錄列出了所有的可以翻譯的信息)，隨著你的插件分發(fā)出去。用戶將需要把他們的翻譯過的MO文件放在你的插件的PHP文件的同一目錄下，命名為<tt>domain-ll_CC.mo</tt>，那里<tt>ll_CC</tt>是本地文件的名字。參見[[WordPress:Translating WordPress|翻譯WordPress]]以獲得關(guān)于POT文件，MO文件和本地文件的信息。
* 通過在調(diào)用gettext函數(shù)之前調(diào)用<tt>load_plugin_textdomain</tt>為現(xiàn)有本地文件和你的文本區(qū)域文件載入翻譯，在session中越晚越好，(因為一些多語言插件載入時改變了本地文件)。一個可能的辦法是定義一個初始化函數(shù)，在所有插件函數(shù)之前調(diào)用，如，假設(shè)你的文本區(qū)域是"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>