在上一篇文章中，我涵蓋了WordPress國際化的基本原理（縮寫為I18N）；如何安裝WordPress的本地化版本以及如何輕鬆將現(xiàn)有WordPress站點轉(zhuǎn)換為本地化版本。 在本文中，我將引導(dǎo)您完成WordPress插件的國際化過程。該過程並不困難，一旦獲取知識，您就可以將WordPress插件輕鬆翻譯成其他語言。

鑰匙要點

國際化（I18N）是開發(fā)插件以容易翻譯成其他語言的過程，而本地化（L10N）是將國際化插件轉(zhuǎn)換為新語言的隨後過程。

>“準(zhǔn)備WordPress插件”翻譯對於吸引全球受眾，增強用戶體驗並通過使使用不同語言的用戶可以訪問用戶群至關(guān)重要。

>

準(zhǔn)備翻譯的插件的過程涉及設(shè)置翻譯標(biāo)題（文本域和域路徑），加載文本域以及國際化各種元素，例如字符串，佔位符，佔位符，html，html，plurals，proceponts ，context and context and casting translation strings。 >
• > WordPress I18N使用GNU getText本地化框架，該框架提供了翻譯文本的工具。這涉及將所有文本字符串包裝在__（）或_e（）函數(shù)中，並創(chuàng)建.pot（Portable Object Template）文件，該文件包含插件中的所有可翻譯字符串。
• 國際化和本地化之間的差異
多年來，開發(fā)人員傾向於誤解這些術(shù)語的含義 - 國際化和本地化。
國際化是開發(fā)插件的過程，因此可以輕鬆地翻譯成其他語言。 >
• >本地化描述了將國際化插件轉(zhuǎn)換為新語言的後續(xù)過程。

>值得注意的是，國際化通常被縮寫為I18N（因為“ i”和“ n'之間有18個字母），並且本地化被縮寫為L10N（因為“ L”和“ L'和之間有10個字母） 'n'。 ）

為什麼國際化？

答案很簡單； WordPress以許多不同的語言在世界範(fàn)圍內(nèi)使用。當(dāng)插件被國際化時，它們會吸引來自世界其他地區(qū)的較大受眾，他們顯然會通過使用自己的語言使用插件來受益。

> 作為開發(fā)人員，您可能沒有時間提供插件的本地版本，因為您不會說其他語言。但是，當(dāng)您國際化插件時，您會為他人打開大門，以創(chuàng)建本地化而不一定要修改源代碼。

• 插件國際化

  >現(xiàn)在我們已經(jīng)熟悉了插件國際化和本地化的概念，讓我們開始研究準(zhǔn)備翻譯的插件的過程。

  >

  >設(shè)置翻譯頭

  進(jìn)行插件可翻譯的第一步是在插件標(biāo)題中包含翻譯標(biāo)題。

  翻譯標(biāo)題是文本域和域路徑。 >

  >文本域用於表示屬於插件的所有文本。 這是一個唯一的標(biāo)識符，可確保WordPress可以區(qū)分所有加載的翻譯。這增加了可移植性，並且使用已經(jīng)存在的WordPress工具可以更好地發(fā)揮作用。

  >

  >文本域必須匹配插件的slug。例如，如果您的插件是一個稱為sample-plugin.php的單個文件，或者它包含在稱為sample-plugin的文件夾中，則應(yīng)為sample-plugin。

  >文本域上的註釋 文本域名必須使用破折號而不是下劃線。

  >還記得我說過文本域必須與插件slug匹配嗎？畢竟這可能不是真的。我對我的一個插件進(jìn)行了快速實驗，而不是插件的插件，我使用了一個唯一的文本，並且沒有任何問題。

  道德：確保文本域是唯一的，以免與其他插件相衝突。

  >

  域路徑是文件夾WordPress將搜索.mo Translation Files。

  默認(rèn)情況下，WordPress搜索要使用的翻譯文件的插件目錄。將翻譯文件放在插件的根文件夾中可能會使您的插件結(jié)構(gòu)混亂。

  > 例如，如果您想將翻譯文件保存在文件夾中，例如； /語言，您需要使用域路徑標(biāo)頭通知WordPress。

  下面是WordPress插件的典型標(biāo)題。
  >加載文本域
  >現(xiàn)在，我們將使用load_plugin_textdomain（）函數(shù)告訴WordPress如果使用用戶的語言，請加載翻譯文件。

  >

  以下是函數(shù)概要。

  第一個參數(shù)$域應(yīng)該是文本域； $ abs_rel_path已被棄用，應(yīng)設(shè)置為false；最後，$ plugin_rel_path是翻譯文件的相對路徑。

  <span><span><?php
  </span></span><span><span>/*
  </span></span><span><span> Plugin Name: Enable Shortcode and PHP in Text widget
  </span></span><span><span> Plugin URI: http://w3guy.com/shortcode-php-support-wordpress-text-widget/
  </span></span><span><span> Description: Enable shortcode support and execute PHP in WordPress's Text Widget
  </span></span><span><span> Author: Agbonghama Collins
  </span></span><span><span> Version: 1.2
  </span></span><span><span> Author URI: http://w3guy.com
  </span></span><span><span> Text Domain: espw-plugin
  </span></span><span><span> Domain Path: /languages/
  </span></span><span><span> */</span></span>

  如果翻譯mo文件在插件自己的目錄中，則使用如下：>
  如果翻譯mo文件在插件的語言子目錄中。使用如下：

  >您不僅要調(diào)用load_plugin_textdomain函數(shù)，還應(yīng)在插件中以插件_loaded這樣的操作在插件中調(diào)用：

  >

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

  >深入研究插件i18n

  >現(xiàn)在設(shè)置了文本域和域路徑標(biāo)頭，是時候?qū)W習(xí)如何國際化插件了。

  <span>load_plugin_textdomain( 'espw-plugin', false, dirname( plugin_basename( __FILE__ ) ) );</span>

  該教程的這一段將分為以下：
  1. >字符串翻譯
  2. 使用佔位符
  3. html翻譯
  4. 與復(fù)數(shù)打交道
  通過上下文
  逃脫翻譯字符串
  請注意：字符串ESPW-Plugin將在本教程中用作文本域。
  1。字符串翻譯
  要在插件中翻譯一個字符串，請將原始字符串包裝在__（）函數(shù)調(diào)用中如下：

  <span><span><?php
  </span></span><span><span>/*
  </span></span><span><span> Plugin Name: Enable Shortcode and PHP in Text widget
  </span></span><span><span> Plugin URI: http://w3guy.com/shortcode-php-support-wordpress-text-widget/
  </span></span><span><span> Description: Enable shortcode support and execute PHP in WordPress's Text Widget
  </span></span><span><span> Author: Agbonghama Collins
  </span></span><span><span> Version: 1.2
  </span></span><span><span> Author URI: http://w3guy.com
  </span></span><span><span> Text Domain: espw-plugin
  </span></span><span><span> Domain Path: /languages/
  </span></span><span><span> */</span></span>

  如果您想將字符串與瀏覽器相呼應(yīng)，而不是Echo語言構(gòu)造，請使用_e函數(shù)：

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

  2。使用佔位符
  作為PHP和WordPress開發(fā)人員，我認(rèn)為您知道什麼是佔位符。您可以快速瀏覽Sprintf和printf（）PHP文檔以獲取更多信息。

  如果您在字符串中使用變量，例如下面的示例，則應(yīng)使用佔位符。

  >

  <span>load_plugin_textdomain( 'espw-plugin', false, dirname( plugin_basename( __FILE__ ) ) );</span>

  正確的方法是使用printf（）函數(shù)如下：

  >

  <span>load_plugin_textdomain( 'espw-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );</span>

  瀏覽WordPress插件存儲庫中某些插件的代碼，我確實看到了這樣的內(nèi)容：

  >

  <span>function load_plugin_textdomain() {
  </span>  <span>load_plugin_textdomain( 'espw-plugin', FALSE, basename( dirname( __FILE__ ) ) . '/languages/' );
  </span><span>}
  </span>
  <span>add_action( 'plugins_loaded', 'load_plugin_textdomain' );</span>

  <span>$text =  __( 'Hello, SitePoint Readers!', 'espw-plugin' );</span>

  儘管現(xiàn)在可以翻譯字符串，但php變量$ city也可以翻譯。

  這是一個不好的做法，因為翻譯器可能會錯誤地將變量或?qū)阂獯a更改為插件代碼庫，這最終將導(dǎo)致插件故障。

  sprintf函數(shù)與printf相似，因為他們使用佔位符格式字符串，而printf輸出格式的字符串，sprintf返回字符串。

  >示例：以下代碼將格式的字符串分配給變量$ text。

  3。 html翻譯

  <span>_e( 'Hello, SitePoint Readers!', 'espw-plugin' );</span>

  在可翻譯字符串中包括HTML取決於上下文。 >

  一個示例是一個鏈接（與周圍的文本分開）：>

  另一個示例是段落中的鏈接（未與周圍的文本分開）：
  4。處理複數(shù)
  >當(dāng)可以使用_n（）函數(shù)國際化的項目數(shù)量時，該字符串會更改。

  <span>echo 'Your city is $city.'</span>

  >

  <span>printf(
  </span>    <span>__( 'Your city is %s.', 'espw-plugin' ),
  </span>    <span>$city
  </span><span>);</span>

  此函數(shù)接受4個參數(shù)，即：

  >

  單數(shù) - 字符串的單數(shù)形式

  >

  複數(shù) - 字符串的複數(shù)形式

  計數(shù) - 將確定是否應(yīng)返回單數(shù)或複數(shù)形式的對像數(shù)量
  • >文本域 - 插件文本域
  >讓我們來了解一些示例，以理解_n（）函數(shù)的工作方式。
  • 在英語中，您有“一個評論”和“兩個評論”。在其他語言中，您可以具有多種複數(shù)形式。
  下面的代碼演示瞭如何使用_n（）函數(shù)來處理此類情況。
  • >
  代碼說明上面的代碼由這三個函數(shù)組成-printf，_n和number_format_i18n。
  >易於同化，將用所述的每個函數(shù)組件剖析功能代碼。

  <span><span><?php
  </span></span><span><span>/*
  </span></span><span><span> Plugin Name: Enable Shortcode and PHP in Text widget
  </span></span><span><span> Plugin URI: http://w3guy.com/shortcode-php-support-wordpress-text-widget/
  </span></span><span><span> Description: Enable shortcode support and execute PHP in WordPress's Text Widget
  </span></span><span><span> Author: Agbonghama Collins
  </span></span><span><span> Version: 1.2
  </span></span><span><span> Author URI: http://w3guy.com
  </span></span><span><span> Text Domain: espw-plugin
  </span></span><span><span> Domain Path: /languages/
  </span></span><span><span> */</span></span>

  第一個參數(shù)傳遞給_n函數(shù)是當(dāng)評論數(shù)是單數(shù)時要顯示的文本。

  第二個是當(dāng)評論數(shù)大於一個時顯示的文本。 >

  佔位符％s將包含number_format_i18n（get_comments_number（））的值。

  第三個參數(shù)get_comments_number（）被認(rèn)為是返回註釋計數(shù)的函數(shù)。

  如果它返回1，則第一個參數(shù)一個註釋將由printf輸出，否則第二個參數(shù)％s如果大於1。

  請注意：佔位符％s被Number_format_i18n返回的整數(shù)（get_comments_number（）），這是傳遞給printf函數(shù)的第二個參數(shù)。

  >最後，第四個參數(shù)是翻譯

  文本域

  。

  >。

  >函數(shù)number_format_i18n（）根據(jù)語言環(huán)境將註釋計數(shù)轉(zhuǎn)換為格式。有關(guān)更多信息，請參見文檔。

  >類似於number_format_i18n（）是基於時間戳的局部格式的日期。 仍在_n（）函數(shù)上，下面是該函數(shù)如何工作的另一個演示。

  >如果變量$ count返回1，我們將顯示一條垃圾郵件消息的文本；但是，如果它大於1，我們將刪除％d垃圾郵件消息，佔位符％d被$ count的整數(shù)替換。

  >

  5。通過上下文

  歧義

  >有時在幾種情況下使用一個術(shù)語，儘管它是英語中的一個和相同的單詞，它必須以其他語言的方式翻譯不同。

  >

  例如，單詞帖子可以用作動詞，例如“單擊此處以發(fā)布您的評論”和名詞“編輯此帖子”。

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

  >

  在這種情況下，應(yīng)使用_x或_ex函數(shù)。

  >

  它類似於__（）和_e（），但是它有一個額外的參數(shù) - $上下文。

  在兩種情況下，使用此方法都使用此方法，我們將獲得原始版本的字符串註釋，但是翻譯人員將在不同的上下文中看到兩個評論字符串。

  >當(dāng)通過poedit等翻譯工具（例如poedit）解析函數(shù)_x（）的字符串時，上下文參數(shù)為翻譯器提供了在上下文上使用字符串/文本的提示。 在德語中，作為一個名詞的帖子是beitrag，而動詞為詞。

  > 下面的

  是Poedit的屏幕截圖，將字符串柱翻譯為德語，並帶有上下文平方。

  _x（）檢索翻譯的字符串，_ex（）顯示它。

  >

  <span>load_plugin_textdomain( 'espw-plugin', false, dirname( plugin_basename( __FILE__ ) ) );</span>

  6。逃避翻譯字符串

  具有許多用於驗證和消毒數(shù)據(jù)的功能。

  列表中的

  是用於逃脫翻譯文本的函數(shù) - esc_html（），ESC_HTML_E（），ESC_HTML_X（），ESC_ATTR（），ESC_ATTR_E（）和ESC_ATTR_E（）和ESC_ATTR_X（）。您可以在WordPress codex中獲取有關(guān)這些功能的更多信息。

  >我不需要解釋其中的每一個，但是他們所做的基本上是逃脫可翻譯的文本。

  總結(jié)

  WordPress的目標(biāo)之一是使世界各地的用戶輕鬆發(fā)佈內(nèi)容。作為插件開發(fā)人員，您可以在國際化插件時幫助進(jìn)一步簡化用戶的發(fā)布流程。

  >

  >本教程的第一部分本質(zhì)上是關(guān)於您需要了解的有關(guān)插件I18N的所有內(nèi)容。
  >結(jié)論部分將是關(guān)於如何準(zhǔn)備插件翻譯以及學(xué)習(xí)如何將插件定位到新語言的演練。

  >

  我希望您從本教程中學(xué)到了新知識。

  >

  >快樂編碼！
  經(jīng)常詢問有關(guān)WordPress I18N和插件翻譯的問題（常見問題解答）

  >使WordPress插件準(zhǔn)備就緒？

  >使WordPress插件轉(zhuǎn)換準(zhǔn)備就緒對於吸引全球受眾至關(guān)重要的重要性是什麼。並非所有WordPress用戶都是說英語的人。通過國際化您的插件，您可以將講不同語言的用戶訪問，從而增加用戶群。它還可以增強用戶體驗，因為用戶可以用母語與您的插件進(jìn)行交互，從而使其更友好。使插件的文本字符串可翻譯成其他語言。這是通過將這些文本字符串包裹在一個特殊功能中，可以翻譯它們來實現(xiàn)。 WordPress為此目的使用gnu getText本地化框架，該框架提供了一組用於翻譯文本的工具。

  是哪些步驟可以使WordPress插件轉(zhuǎn)換準(zhǔn)備？插件翻譯就緒涉及多個步驟。首先，您需要通過包裝__（）或_e（）函數(shù)中的所有文本字符串來國際化插件。接下來，您需要創(chuàng)建一個.pot（Portable對像模板）文件，該文件包含插件中的所有可翻譯字符串。該文件用作創(chuàng)建.po（Portable Object）和.mo（Machine Object）文件的模板，該模板包含翻譯字符串。

  __（）和_e（）函數(shù)之間有什麼區(qū)別WordPress I18N？
  __（）和_e（）函數(shù)都在WordPress I18N中使用，以使文本字符串可翻譯。它們之間的主要區(qū)別是__（）返回翻譯的字符串，而_e（）迴聲或直接輸出翻譯的字符串。因此，當(dāng)要將翻譯的字符串存儲在變量中時，您將使用__（），當(dāng)要向用戶顯示翻譯字符串時_e（）。

  >如何將WordPress插件轉(zhuǎn)換為不同的語言？

  >將您的WordPress插件轉(zhuǎn)換為不同的語言，您需要為每種語言創(chuàng)建.po和.mo文件。這些文件包含翻譯的字符串，並根據(jù)ISO-639語言代碼命名（例如，英語en_us，fr_fr，法語）。您可以使用poedit或loco等工具來創(chuàng)建和管理這些翻譯文件。

  我可以使用哪些工具用於WordPress I18N？ >

  >如何測試我的WordPress插件以進(jìn)行翻譯準(zhǔn)備？可以通過更改WordPress設(shè)置中的語言並檢查插件的文本字符串是否正確翻譯來測試您的WordPress插件是否準(zhǔn)備轉(zhuǎn)換。您還可以使用WordPress I18N Checker插件之類的工具，該工具會檢查您的插件中的常見i18n錯誤。

  >我如何為WordPress插件翻譯貢獻(xiàn)？

  您可以為WordPress插件翻譯貢獻(xiàn)通過WordPress Polyglots團(tuán)隊。他們負(fù)責(zé)將WordPress定位為不同的語言。您可以加入團(tuán)隊並開始將插件和主題轉(zhuǎn)換為母語。

  > .pot，.po和.mo文件在WordPress I18N？

  進(jìn)行WordPress主題翻譯準(zhǔn)備涉及與插件類似的過程。您需要通過將所有文本字符串包裝在__（）或_e（）函數(shù)中來國際化主題。然後，您需要創(chuàng)建一個.pot文件並將其用作為每種語言創(chuàng)建.po和.mo文件的模板。

以上是WordPress I18N：準(zhǔn)備您的插件翻譯的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！