如果您使用 WordPress 謀生并講述您的故事，那么看到您編寫的更改添加到 WordPress 代碼庫中是一件非常令人興奮的事情。我知道這是給我的。

在本教程中，您將學(xué)習(xí)創(chuàng)建可被核心軟件接受的 WordPress 補(bǔ)丁所需了解的一些簡單知識(shí)。

雖然 WordPress 是任何人都可以下載和修改的開源軟件，但只有少數(shù)核心貢獻(xiàn)者能夠?qū)⑺麄兊母奶峤坏?WordPress 本身。如果您想對(duì) WordPress 的核心文件進(jìn)行更改，您可以通過創(chuàng)建詳細(xì)說明提議的更改并附加補(bǔ)丁的票證或?qū)⒀a(bǔ)丁附加到現(xiàn)有票證來提出建議。

補(bǔ)丁或 diff 文件是一個(gè)詳細(xì)說明您對(duì)源代碼所做的更改的文件，SVN 或 GIT 等版本控制系統(tǒng)可以使用該文件來應(yīng)用您的更改。通過命令行或通過 SourceTree 等 GUI 工具可以輕松創(chuàng)建補(bǔ)丁。

在本文中，我將詳細(xì)介紹如何使用優(yōu)秀的 GIT GUI 應(yīng)用程序 SourceTree 來檢查最新版本的 WordPress 并創(chuàng)建補(bǔ)丁文件。如果您愿意，可以使用您選擇的 GUI 工具或命令行。

在 Core Trac 中查找或創(chuàng)建票證

當(dāng)您將補(bǔ)丁提交到 WordPress 核心時(shí)，它必須附加到 WordPress 問題跟蹤器（稱為 trac）中的票證中。因此，提交補(bǔ)丁的第一步是查找或創(chuàng)建票證。

雖然具有新功能的新票證有可能被接受，但可能性不大。 WordPress 擁有數(shù)百萬用戶，主要開發(fā)人員對(duì)于引入新功能非常謹(jǐn)慎是有道理的。現(xiàn)在幾乎所有新功能都首先作為插件單獨(dú)開發(fā)，只有經(jīng)過廣泛的測試和開發(fā)后才合并到核心中。

要讓補(bǔ)丁被接受，最好的辦法是為現(xiàn)有票證創(chuàng)建補(bǔ)丁。最近，核心 trac 進(jìn)行了重新設(shè)計(jì)，以便更輕松地查找具有簡單修復(fù)的票證以及最有可能包含在下一版本和下一版本 WordPress 中的票證。

報(bào)告錯(cuò)誤

如果您想在 core trac 中創(chuàng)建新票證（如果您發(fā)現(xiàn)了新錯(cuò)誤，這是一件很棒的事情），您可以在此處執(zhí)行此操作。只需確保您在創(chuàng)建新票證之前已在 trac 中搜索了同一問題的任何報(bào)告，并且已驗(yàn)證最新版本的 WordPress 中是否存在該錯(cuò)誤。

我指的并不是最新版本，而是 GIT 術(shù)語中的 master 分支或 SVN 術(shù)語中的 trunk。我將在本教程稍后詳細(xì)介紹如何獲取最新版本。

您至少必須填寫摘要字段（工單的標(biāo)題）和描述字段，這是票證的內(nèi)容。在票證描述中，請(qǐng)盡可能具有描述性。

在我參加的 2013 年 WordCamp 奧蘭多貢獻(xiàn)者研討會(huì)上，WordPress 首席開發(fā)人員 Mark Jaquith 和 Andrew Nacin 創(chuàng)建了這份優(yōu)秀錯(cuò)誤報(bào)告的列表：

• 重現(xiàn)問題的步驟（從最早的步驟開始）
• 錯(cuò)誤描述
• 您所看到的與您所期望的
• 錯(cuò)誤消息或錯(cuò)誤代碼
• PHP 錯(cuò)誤（頁面上的警告是什么、日志中出現(xiàn)了什么內(nèi)容、是否有任何 JavaScript 或 Apache/nginx 錯(cuò)誤？）
• 什么瀏覽器？
• 環(huán)境（您的 PHP 版本、MySQL Apache 或 nginx 版本）
• 在沒有插件和默認(rèn)主題的情況下會(huì)發(fā)生這種情況嗎？
• 用戶界面問題的屏幕截圖
• 清晰簡潔
• 先切入主題，然后再詳細(xì)說明。
• 相關(guān)票號(hào)
• 每張票一個(gè)錯(cuò)誤
• 固定鏈接設(shè)置
• 是否啟用多站點(diǎn)？
• WP_DEBUG 或同等功能已啟用？
• 問題發(fā)生時(shí)登錄的用戶角色（或更改數(shù)據(jù)庫中的角色）

請(qǐng)記住，并非所有這些都與每個(gè)錯(cuò)誤相關(guān)，但您可以添加更多相關(guān)信息，效果更好。

除非您確定要在其中設(shè)置什么內(nèi)容，否則您應(yīng)該保留下面描述的字段，讓核心貢獻(xiàn)者使用它們對(duì)工單進(jìn)行相應(yīng)的分類。我建議您根據(jù)是否附加補(bǔ)丁來修復(fù)錯(cuò)誤而使用“Has Patch”或“Needs Patch”標(biāo)簽。

使用 GUI 工具從 GitHub 查看最新的 WordPress

在為任何票證創(chuàng)建補(bǔ)丁之前，擁有絕對(duì)最新版本的 WordPress 非常重要，因?yàn)槊刻於紩?huì)對(duì)其進(jìn)行許多更改。除非您使用最新的代碼，否則不可能知道您的修復(fù)是否有效或錯(cuò)誤是否仍然存在。如果您的補(bǔ)丁修改了已經(jīng)更改的代碼，則它可能不會(huì)被接受。

WordPress 在 SVN 中管理，但該代碼在兩個(gè)位置鏡像為 GIT 存儲(chǔ)庫：

1. git://core.git.wordpress.org/
2. https://github.com/WordPress/WordPress

GitHub 存儲(chǔ)庫是最容易使用的。請(qǐng)記住，即使它是官方 GitHub 存儲(chǔ)庫，它仍然不用于問題跟蹤，并且您不應(yīng)向其提交拉取請(qǐng)求。

有多種方法可以通過 SVN 或 Git 獲取最新版本的 WordPress。就我個(gè)人而言，我發(fā)現(xiàn)最簡單的方法是使用出色的 GIT GUI 工具 SourceTree 來克隆 GitHub 鏡像。這就像從文件菜單中選擇“新建/克隆”一樣簡單，在“源路徑/ URL”字段中輸入 Git 存儲(chǔ)庫的地址，然后指定用于克隆的本地路徑，該路徑位于您的 XAMMP 或 Vagrant 內(nèi)部測試環(huán)境。

說到 Vagrant，流行的 WordPress Vagrant 配置 VVV 已經(jīng)為 WordPress 核心預(yù)配置了測試環(huán)境，包括最新代碼和單元測試。

創(chuàng)建補(bǔ)丁文件

對(duì) WordPress 進(jìn)行了解決您嘗試修復(fù)的問題所需的更改并測試了修復(fù)后，您需要?jiǎng)?chuàng)建一個(gè)補(bǔ)丁文件以上傳到工單。 SourceTree 包含一種創(chuàng)建補(bǔ)丁文件的方法，或者您也可以使用命令行。

在 SourceTree 中，您可以通過轉(zhuǎn)到工作副本并右鍵單擊已更改的文件來創(chuàng)建補(bǔ)丁文件。從右鍵菜單中選擇“創(chuàng)建補(bǔ)丁”。

或者，在終端中導(dǎo)航到 WordPress 存儲(chǔ)庫的根目錄，然后使用以下命令創(chuàng)建差異：

git diff —非前綴 ~/name.path

無論您如何創(chuàng)建補(bǔ)丁文件，都應(yīng)該以它的目標(biāo)票號(hào)來命名它。如果這是上傳到票證的第二個(gè)補(bǔ)丁，請(qǐng)?jiān)跀?shù)字末尾附加 .2，如果是第三個(gè)，則附加 .3，依此類推。例如，票號(hào) #12358 的第五個(gè)補(bǔ)丁將被稱為 #12358.5

將補(bǔ)丁上傳到 Trac

現(xiàn)在您的補(bǔ)丁已準(zhǔn)備就緒，您需要將其上傳到 core trac 中的票證中。在任何現(xiàn)有的票證上，說明下方都有一個(gè)“附加文件”按鈕，您可以使用該按鈕上傳補(bǔ)丁。在下一個(gè)屏幕上，請(qǐng)務(wù)必添加補(bǔ)丁功能的描述。

要有耐心并理解

WordPress 是一個(gè)龐大的項(xiàng)目，因此期望您的補(bǔ)丁立即得到響應(yīng)是不合理的。另外，請(qǐng)了解，提交給 WordPress 的補(bǔ)丁的標(biāo)準(zhǔn)必須非常高，才能最好地服務(wù)所有用戶。

提交補(bǔ)丁后，請(qǐng)保持耐心并理解您收到的任何反饋。主要開發(fā)人員非常平易近人，如果您對(duì)補(bǔ)丁有疑問或?yàn)槭裁礇]有改進(jìn)，請(qǐng)隨時(shí)在 #wordpress-dev IRC 頻道中詢問其中一位。

雖然等待響應(yīng)并必須進(jìn)行更改可能會(huì)令人沮喪，但當(dāng)您的補(bǔ)丁已提交到 WordPress 并且變更集描述認(rèn)可您時(shí)，這是值得的。