如何將您的插件添加到 WordPress 插件目錄
最後更新於 2024 年 7 月 12 日，由編輯團隊撰寫 | 審核人：Syed Balkhi
您已完成了！您的 WordPress 插件已準備就緒。現在，您可能在想如何將其上傳至插件目錄，讓成千上萬的 WordPress 用戶能夠發現並使用它。WordPress 插件目錄不僅僅是存儲空間，它是一個充滿創意和解決方案的熱鬧市場。
但問題在於：提交您的插件並不如看起來那麼簡單。許多開發者在這個階段被絆住，延遲了插件的上架或錯失了寶貴的曝光機會。不用擔心，我們將在這篇指南中引導您逐步完成將您的插件添加到 WordPress 插件目錄的每一步。
為什麼要將您的插件添加到 WordPress 插件目錄？
如果您創建了一個您認為對其他人有用的 WordPress 插件，那麼您應該考慮將其添加到官方的 WordPress 插件目錄。對於您這位開發者來說，這有很多好處。
WordPress 插件目錄是許多用戶尋找 WordPress 插件的首選。將您的插件添加到目錄中會使用戶更容易找到它，也會增加您作為開發者的可信度。此外，您不需要支付下載插件所需的帶寬費用。目錄還會自動跟踪下載人數，並在有升級時通知他們。
目錄還有助於您支持插件。用戶可以評分您的插件，留下反饋和錯誤報告，並利用支持論壇。
當然，也有一些要求和限制。
首先是您的插件必須具有與 WordPress 兼容的許可證。建議使用 GPLv2 或更高版本。還有一些道德考量要注意。插件不得執行任何非法或道德上令人反感的操作，並且不得在未經使用者許可的情況下包含連結到外部網站。提交插件後，將由人工審查常見錯誤和是否符合插件目錄的指南。這個過程可能需要 1 到 10 天不等。
添加您的插件到 WordPress 插件目錄的步驟
步驟 1：為您的插件創建 readme.txt 文件
首先需要創建一個 ‘Read Me’ 文件。這將顯示在插件目錄中的插件頁面上，需要使用正確的格式。以下是一個可以用作起點的範本文件：
=== 您的插件名稱 ===
Contributors: 您的 WordPress.org 用戶名
Tags: wpressize-me, plugin tutorial
Requires at least: 6.0
Tested up to: 6.2
Stable tag: 1.0
License: GPLv2 或更高版本
License URI: http://www.gnu.org/licenses/gpl-2.0.html
一個教初學者如何撰寫 WordPress 插件的插件。
== 描述 ==
這個簡單的插件是我們初學者學習撰寫 WordPress 插件指南的一部分。
== 安裝 ==
1. 將插件文件夾上傳到您的 /wp-content/plugins/ 文件夾。
2. 進入 **插件** 頁面並激活插件。
== 常見問題 ==
= 如何使用這個插件？ =
問題的答案
= 如何卸載插件？ =
簡單地停用並刪除插件。
== 截圖 ==
1. 第一張截圖的描述。
2. 第二張截圖的描述。
== 更新記錄 ==
= 1.0 =
* 插件發布。
步驟 2：將您的插件提交到目錄進行審核
現在，您的插件已經準備好讓 WordPress.org 的插件團隊審核。訪問添加您的插件頁面。如果您還沒登錄，請點擊屏幕右上角的“登錄”按鈕。一旦登錄，您將能夠上傳並提交您的插件進行審核。點擊“選擇文件”按鈕來選擇您的插件壓縮包文件，然後勾選所有適用的框並點擊‘上傳’按鈕。
步驟 3：使用 Subversion (SVN) 上傳您的插件
您的插件獲準後，需要使用 Subversion (SVN) 上傳插件。Subversion 是一個開源版本控制系統，它允許用戶對文件和目錄進行更改，同時記錄更改，管理不同版本，並與其他用戶協作。
在您的計算機上安裝 SVN 客戶端。Windows 用戶可以使用 SilkSVN 或 TortoiseSVN（免費），Mac 用戶可以安裝 SmartSVN 或 Versions 應用。在這篇文章中，我們將使用 Mac 的 Versions 應用，但上述所有 SVN 應用的過程非常相似。
安裝後，打開 Versions 應用並檢出您的 WordPress 插件的版本庫副本。這將帶來一個彈出窗口，您首先需要為此書簽提供一個名稱，可以以您的插件命名，並添加您的 WordPress 插件的 SVN 儲存庫 URL，然後點擊“創建”按鈕。
Versions 會連接到您的版本庫，並將版本庫副本下載到您的計算機。接下來，右鍵點擊瀏覽器視圖中的儲存庫名稱，然後選擇“檢出”。
會要求您提供文件夾名稱，並選擇在計算機上存儲的位置。完成後，Versions 應用會在您的計算機上創建所需的文件夾。您需要將插件文件複製並粘貼到本地版本庫的 trunk 文件夾中。確定使用相同的文件夾名稱並點擊“檢出”按鈕繼續。
現在，您的插件文件已添加到 Subversion，您可以通過同步本地文件夾和 Subversion 目錄來上傳。如果想要標記一個版本，需要將 trunk 文件夾內的文件複製到 tags 文件夾內的新文件夾中，並確保文件夾名稱和您的插件標頭中的版本號匹配。
步驟 4：將藝術作品添加到 WordPress 插件目錄
現在，我們可以將一些藝術作品和截圖添加到 WordPress 插件目錄。這些項目需要遵循標準命名規則，並應使用 Subversion 上傳。
插件標題橫幅：橫幅是顯示在插件頁面頂部的大圖像，尺寸應為 772×250 或 1544×500 像素，格式應為 JPEG 或 PNG。
插件圖標：圖標是一個較小的方形圖像，將顯示在搜索結果和插件列表中，尺寸應為 125×125 或 250×250 像素，格式應為 JPEG 或 PNG。
準備好所有藝術品後，將其放入插件本地副本的 assets 文件夾中。注意，應點擊‘添加’按鈕將新藝術品文件添加到儲存庫中。
希望這個教程幫助您學會如何將插件添加到 WordPress 插件目錄，並檢查我們的最佳 WordPress 開發機構推薦和使用 iPhone、iPad 和 Android 版 WordPress 應用的指南。如果您喜歡這篇文章，請訂閱我們的 YouTube 頻道獲取 WordPress 視頻教程，也可以在 Twitter 和 Facebook 上找到我們。