如何新增外掛到 WordPress 儲存庫？

問題描述

我剛剛做了我的第一個外掛，它被 WordPress 批准。對我來說好訊息，但現在呢？食品法典中的”instructions” 對我而言都是清楚的。我找到一篇關於 Dig WP 的文章，我設法得到第 3 行程式碼。之後沒有快樂。

有沒有人在這裡有一個明確的說明，如何做到這一點，而不需要閱讀整本書？我相信這裡有非常有經驗的人一直在做這些事情…

提前致謝！

最佳解決方案

步驟 1 – 確保事物的格式正確

WordPress 本身取決於您的主要外掛檔案頂部的標題。在許多情況下，如果你的外掛是「我的酷外掛」，這個檔案是 my-cool-plugin.php 在你的資料夾的主目錄。確保檔案的頂部遵循以下格式：

<?php
/*
=== [Plugin Name] ===

Plugin Name: [Plugin name]
Plugin URI: [Website where plugin information can be found - your blog, maybe]
Description: [Short description of your plugin]
Author URI: [Your website]
Author: [Your name]
Version: [This version number]
*/

WordPress.org 儲存庫取決於您的 readme.txt 檔案來建立描述和下載頁面。所以確保您的 readme.txt 檔案符合以下格式：

=== [Plugin Name] ===
Contributors: [Your WordPress.org username]
Donate link: [A site people can go to to give you money]
Tags: [Search terms related to your plugin]
Requires at least: [Minimum version of WordPress required]
Tested up to: [Newest version of WordPress you've tested with]
Stable tag: [This version number]

[Short, one-sentence description of your plugin]

== Description ==

[Long description of your plugin]

== Installation ==

[Steps required to install the plugin]

== Frequently Asked Questions ==

= [A question] =

[An answer]

= [Another question] =

[Another answer]

== Screenshots ==

== Changelog ==

== Upgrade Notice ==

在 WordPress.org 上有一個方便的 readme validator，您可以使用它來確保您的自述檔案具有所需的一切。只是 copy-paste，它會檢查，以確保所有的部分在那裡，你準備好了。

步驟 2 – 檢視 SVN 資訊庫

將開發版本與 WordPress.org 外掛儲存庫分開是個好主意。是的，SVN 用於版本控制，但 WordPress 更多地用於釋出管理。如果您開始提交儲存庫中的每個更改集，您都可能遇到問題。許多開發人員做的一件事是使用 Git 在本地開發，然後當您準備好釋出時，將檔案傳輸到 Subversion 儲存庫。

These instructions assume you’re using a Windows computer. If you’re on a Mac, you can use SCPlugin instead of TortoiseSVN. The steps you’ll need to follow will be the same, only the contextual menus and screenshots will differ slightly because of the UI. I don’t have a Mac, so I can’t create screenshots to walk you through a tutorial … but trust me, it’s the same process.

如果您還沒有安裝 TortoiseSVN 。

TortoiseSVN 是 Windows 的開源 Subversion GUI 。相信我，使用 GUI 比從命令列做起的事情要容易得多。你也會遇到更少的問題。

檢視您的 WordPress-hosted SVN 資訊庫

找到您要儲存 WordPress-hosted 版本的外掛的地方。預設情況下，我使用/My Documents/WordPress/進行我所有的託管開發工作。資料夾中的 Right-click，並從下拉選單中選擇”SVN Checkout” 。

在彈出的對話方塊視窗中，輸入您的 WordPress.org 外掛儲存庫 URL(我正在使用我的一個演示目的)，並選擇要建立的子資料夾。

烏龜會考慮一下，然後它將從 WordPress.org 下載儲存庫。新建立的資料夾將為您設定所有必需的資料夾。現在你只是 copy-paste 並提交… 一步一步。

將您的最新版本複製到`/tags`

這是我從大多數教程中向後退的地方。其他人都會告訴你提交/trunk，但是請記住，WordPress 在/trunk 中不使用任何東西，除了 readme 檔案，看看外掛。所以如果你把你的外掛放到/trunk 中，並在你提交標籤之前丟失你的網路連線 (或其它的一些問題)，你會有問題。

在/tags 資料夾中，建立一個名稱與您為外掛釋出的版本相同的資料夾。所以如果你釋出版本 0.1，建立一個/tags/0.1 資料夾。

將整個外掛複製到此資料夾中。

現在 right-click 在資料夾內，從下拉選單中選擇”SVN Commit” 。

您將看到一個彈出視窗，顯示所有更改 (您應該看到所有新檔案標記為”non-versioned”) 。

選中所有外掛檔案旁邊的框 (或單擊”Select All” 選擇所有的檔案) 。

在頂部的框中，輸入提交訊息。由於您提交標籤，您應該使用以下內容：

Tagging version 0.1 of [My Plugin].

單擊確定。

再次，龜龜會想幾分鐘，那麼它會要求你的 WordPress 使用者名稱和密碼來提交伺服器。提供他們，等待事情透過，並說”Success,” 然後繼續下一步。

將您的最新版本複製到`/trunk`

現在導航到儲存庫的/trunk 資料夾，再次將 copy-paste 插入該資料夾。透過上述相同步驟選擇您的檔案並準備提交。但是對於一個訊息，請使用一些解釋新版本的內容：

Version 0.1 of [My Plugin] – adds support for OpenID.

一旦一切順利，您只需等一下 WordPress.org 的伺服器趕上。他們可能比其他人慢幾天，但在一個小時左右，您應該在儲存庫中看到您的新版本。

將外掛更新到新版本

一旦您的外掛在野外，準備更新是相對容易的。

首先，使用 SVN 更新命令確保擁有儲存庫的最新版本。如果你是唯一的開發人員，那麼你應該已經有了，但是在做任何事情之前都要進行更新。

然後，透過上述過程，在/tags 中為您的新版本建立一個新的 sub-folder 。說，/tags/0.2 。不要觸控舊的/0.1 資料夾。這是一個理由，你永遠不會再碰到它。

提交您的新標籤，然後轉到/trunk 資料夾。使用新版本替換/trunk 中的所有內容，並按上述提交。一旦伺服器更新，他們將開始談論新版本而不是舊版本。

參考文獻

How to add plugin to WordPress Repository?

注：本文內容整合自 Google/Baidu/Bing 輔助翻譯的英文資料結果。如果您對結果不滿意，可以加入我們改善翻譯效果：薇曉朵技術論壇。

如何新增外掛到 WordPress 儲存庫？