如何添加插件到 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 存儲庫？