如果您使用 wordpress 謀生并講述您的故事，那么看到您編寫的更改添加到 wordpress 代碼庫中是一件非常令人興奮的事情。我知道這是給我的。
在本教程中，您將學習創建可被核心軟件接受的 WordPress 補丁所需了解的一些簡單知識。
雖然 WordPress 是任何人都可以下載和修改的開源軟件，但只有少數核心貢獻者能夠將他們的更改提交到 WordPress 本身。如果您想對 WordPress 的核心文件進行更改，您可以通過創建詳細說明提議的更改并附加補丁的票證或將補丁附加到現有票證來提出建議。
補丁或 diff 文件是一個詳細說明您對源代碼所做的更改的文件，SVN 或 GIT 等版本控制系統可以使用該文件來應用您的更改。通過命令行或通過 SourceTree 等 GUI 工具可以輕松創建補丁。
在本文中，我將詳細介紹如何使用優秀的 GIT GUI 應用程序 SourceTree 來檢查最新版本的 WordPress 并創建補丁文件。如果您愿意，可以使用您選擇的 GUI 工具或命令行。
在 Core Trac 中查找或創建票證
當您將補丁提交到 WordPress 核心時，它必須附加到 WordPress 問題跟蹤器（稱為 trac）中的票證中。因此，提交補丁的第一步是查找或創建票證。
雖然具有新功能的新票證有可能被接受，但可能性不大。 WordPress 擁有數百萬用戶，主要開發人員對于引入新功能非常謹慎是有道理的。現在幾乎所有新功能都首先作為插件單獨開發，只有經過廣泛的測試和開發后才合并到核心中。
要讓補丁被接受，最好的辦法是為現有票證創建補丁。最近，核心 trac 進行了重新設計，以便更輕松地查找具有簡單修復的票證以及最有可能包含在下一版本和下一版本 WordPress 中的票證。
報告錯誤
如果您想在 core trac 中創建新票證（如果您發現了新錯誤，這是一件很棒的事情），您可以在此處執行此操作。只需確保您在創建新票證之前已在 trac 中搜索了同一問題的任何報告，并且已驗證最新版本的 WordPress 中是否存在該錯誤。
我指的并不是最新版本，而是 GIT 術語中的 master 分支或 SVN 術語中的 trunk。我將在本教程稍后詳細介紹如何獲取最新版本。
您至少必須填寫摘要字段（工單的標題）和描述字段，這是票證的內容。在票證描述中，請盡可能具有描述性。
在我參加的 2013 年 WordCamp 奧蘭多貢獻者研討會上，WordPress 首席開發人員 Mark Jaquith 和 Andrew Nacin 創建了這份優秀錯誤報告的列表：
- 重現問題的步驟（從最早的步驟開始）
- 錯誤描述
- 您所看到的與您所期望的
- 錯誤消息或錯誤代碼
- PHP 錯誤（頁面上的警告是什么、日志中出現了什么內容、是否有任何 JavaScript 或 Apache/nginx 錯誤？）
- 什么瀏覽器？
- 環境（您的 PHP 版本、MySQL Apache 或 nginx 版本）
- 在沒有插件和默認主題的情況下會發生這種情況嗎？
- 用戶界面問題的屏幕截圖
- 清晰簡潔
- 先切入主題，然后再詳細說明。
- 相關票號
- 每張票一個錯誤
- 固定鏈接設置
- 是否啟用多站點？
- WP_DEBUG 或同等功能已啟用？
- 問題發生時登錄的用戶角色（或更改數據庫中的角色）
請記住，并非所有這些都與每個錯誤相關，但您可以添加更多相關信息，效果更好。
除非您確定要在其中設置什么內容，否則您應該保留下面描述的字段，讓核心貢獻者使用它們對工單進行相應的分類。我建議您根據是否附加補丁來修復錯誤而使用“Has Patch”或“Needs Patch”標簽。
使用 GUI 工具從 GitHub 查看最新的 WordPress
在為任何票證創建補丁之前，擁有絕對最新版本的 WordPress 非常重要，因為每天都會對其進行許多更改。除非您使用最新的代碼，否則不可能知道您的修復是否有效或錯誤是否仍然存在。如果您的補丁修改了已經更改的代碼，則它可能不會被接受。
WordPress 在 SVN 中管理，但該代碼在兩個位置鏡像為 GIT 存儲庫：
- git://core.git.wordpress.org/
- https://github.com/WordPress/WordPress
GitHub 存儲庫是最容易使用的。請記住，即使它是官方 GitHub 存儲庫，它仍然不用于問題跟蹤，并且您不應向其提交拉取請求。
有多種方法可以通過 SVN 或 Git 獲取最新版本的 WordPress。就我個人而言，我發現最簡單的方法是使用出色的 GIT GUI 工具 SourceTree 來克隆 GitHub 鏡像。這就像從文件菜單中選擇“新建/克隆”一樣簡單，在“源路徑/ URL”字段中輸入 Git 存儲庫的地址，然后指定用于克隆的本地路徑，該路徑位于您的 XAMMP 或 Vagrant 內部測試環境。
說到 Vagrant，流行的 WordPress Vagrant 配置 VVV 已經為 WordPress 核心預配置了測試環境，包括最新代碼和單元測試。
創建補丁文件
對 WordPress 進行了解決您嘗試修復的問題所需的更改并測試了修復后，您需要創建一個補丁文件以上傳到工單。 SourceTree 包含一種創建補丁文件的方法，或者您也可以使用命令行。
在 SourceTree 中，您可以通過轉到工作副本并右鍵單擊已更改的文件來創建補丁文件。從右鍵菜單中選擇“創建補丁”。
或者，在終端中導航到 WordPress 存儲庫的根目錄，然后使用以下命令創建差異：
git diff —非前綴 ~/name.path
無論您如何創建補丁文件，都應該以它的目標票號來命名它。如果這是上傳到票證的第二個補丁，請在數字末尾附加 .2，如果是第三個，則附加 .3，依此類推。例如，票號 #12358 的第五個補丁將被稱為 #12358.5
將補丁上傳到 Trac
現在您的補丁已準備就緒，您需要將其上傳到 core trac 中的票證中。在任何現有的票證上，說明下方都有一個“附加文件”按鈕，您可以使用該按鈕上傳補丁。在下一個屏幕上，請務必添加補丁功能的描述。
要有耐心并理解
WordPress 是一個龐大的項目，因此期望您的補丁立即得到響應是不合理的。另外，請了解，提交給 WordPress 的補丁的標準必須非常高，才能最好地服務所有用戶。
提交補丁后，請保持耐心并理解您收到的任何反饋。主要開發人員非常平易近人，如果您對補丁有疑問或為什么沒有改進，請隨時在 #wordpress-dev IRC 頻道中詢問其中一位。
雖然等待響應并必須進行更改可能會令人沮喪，但當您的補丁已提交到 WordPress 并且變更集描述認可您時，這是值得的。
