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

鑰匙要點(diǎn)

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

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

>

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

>值得注意的是，國(guó)際化通常被縮寫為I18N（因?yàn)椤?i”和“ n'之間有18個(gè)字母），並且本地化被縮寫為L(zhǎng)10N（因?yàn)椤?L”和“ L'和之間有10個(gè)字母） 'n'。 ）

為什麼國(guó)際化？

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

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

• 插件國(guó)際化

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

  >

  >設(shè)置翻譯頭

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

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

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

  >

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

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

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

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

  >

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

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

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

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

  >

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

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

  <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文件在插件的語(yǔ)言子目錄中。使用如下：

  >您不僅要調(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)頭，是時(shí)候?qū)W習(xí)如何國(guó)際化插件了。

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

  該教程的這一段將分為以下：
  1. >字符串翻譯
  2. 使用佔(zhàn)位符
  3. html翻譯
  4. 與復(fù)數(shù)打交道
  通過(guò)上下文
  逃脫翻譯字符串
  請(qǐng)注意：字符串ESPW-Plugin將在本教程中用作文本域。
  1。字符串翻譯
  要在插件中翻譯一個(gè)字符串，請(qǐng)將原始字符串包裝在__（）函數(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語(yǔ)言構(gòu)造，請(qǐng)使用_e函數(shù)：

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

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

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

  >

  <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插件存儲(chǔ)庫(kù)中某些插件的代碼，我確實(shí)看到了這樣的內(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也可以翻譯。

  這是一個(gè)不好的做法，因?yàn)榉g器可能會(huì)錯(cuò)誤地將變量或?qū)阂獯a更改為插件代碼庫(kù)，這最終將導(dǎo)致插件故障。

  sprintf函數(shù)與printf相似，因?yàn)樗麄兪褂脕?zhàn)位符格式字符串，而printf輸出格式的字符串，sprintf返回字符串。

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

  3。 html翻譯

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

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

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

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

  <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個(gè)參數(shù)，即：

  >

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

  >

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

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

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

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

  佔(zhàn)位符％s將包含number_format_i18n（get_comments_number（））的值。

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

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

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

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

  文本域

  。

  >。

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

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

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

  >

  5。通過(guò)上下文

  歧義

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

  >

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

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

  >

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

  >

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

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

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

  > 下面的

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

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

  >

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

  6。逃避翻譯字符串

  具有許多用於驗(yàn)證和消毒數(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)這些功能的更多信息。

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

  總結(jié)

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

  >

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

  >

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

  >

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

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

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

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

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

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

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

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

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

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

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

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

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

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