WordPress.orgの自作プラグインをApache Subversionを使って公式ディレクトリに公開する

順序は大まかに

0. 概要:Wordpressの自作プラグインを公式ページに登録・公開して、プラグイン追加からインストールできるようにする方法

1．WordPress.orgのアカウントに登録し、公式ディレクトリにプラグインを申請する

2．プラグインの公式ディレクトリへのアップロードに必要なSubversionのダウンロードとインストール

3．Subversionを使ってWorpdress.orgの公式ディレクトリにアップロード＆バージョン管理
↑いまここ↑

4．.potファイルから .mo ファイルを作ってプラグインの多言語化(国際化)
 
 

という感じ。
公開後もSubversion (Apache Subversion / アパッチ・サブバージョン) を使い、バージョンアップを行っていくことになるので、その基本的な使い方のメモ。

Subversionは、コマンドプロンプトに新たなコマンドを追加するソフトウェアなので、操作はコマンドプロンプトから行う。
 
まだSubversionのインストールがまだの場合は → Subversionのダウンロードとインストール を参照。
 
 

Subversionの使い方(WordPressの自作プラグインのアップロード・公開編)

 
コマンドプロンプトを起動。

Windows7以前のバージョンの場合は、「左下のスタートボタン」→「全てのプログラム」→「アクセサリ」→「コマンドプロンプト」。

 
 
まず、Wordpress.orgの公式ディレクトリから作業スペースを自分のPC内にコピーする。
コマンドは

svn co http://plugins.svn.wordpress.org/レポジトリへのパス/

←coとレポジトリへのパスの間に半角スペース。

上の画像の場合、自分のPCの「Cドライブ→Users→userpc」内に作業スペース(フォルダ)をコピーする。
作業スペースの場所はどこでもいいので、デスクトップなどで作業したい場合は、

cd (フォルダへのパス)

←cdとフォルダへのパスの間に半角スペース。
で移動してから、「svn co」コマンドでコピーすること。

コマンドプロンプト内に「cd 」と

ちなみに、レポジトリへのパスは、Wordpress.orgへのプラグイン登録申請の承認メールに SVN repository へのリンクとして記載されている。

コピー完了すると、下の画像のように表示される。
これで、指定した場所に「tags、assets、trunk、branches」の4つのフォルダがコピーされている。

※エラーでコマンドが通らない場合はSubversionのインストールがうまくいっていない可能性があるので、Subversionのダウンロードとインストール を再度チェック。

コピー先を見てみると、確かにフォルダができている。
今回の場合は、「Cドライブ→Users→userpc」

作業スペースの 「trunk」 フォルダに入れたプラグインを、Wordpress.orgのディレクトリへアップロードすることになるので、自作のプラグイン.php と、readme.txt を「trunk」内に移動しておく。

作業スペース(フォルダ)に移動するので「cd (trunkフォルダへのパス)」とコマンドを叩く。

画像の場合では「cd C:\Users\userpc\add-featuredimage-to-all-posts\trunk」
 
 

作業フォルダ trunk の中の、自作プラグイン.php と readme.txt をWordpressの公式ディレクトリ(レジストリ)にアップロードする。
コマンドは「svn add (自作プラグイン名).php readme.txt」。

A (自作プラグイン名).php
A readme.txt

と表示されたら、アップロード成功。1分程度必要な場合もある。
 
 

次にコミット(作業を更新を実行すること)する。
コマンドは「svn commit -m “first release.”」とする。

この際、PCへのログインパスワードと、Wordpress.orgへのログインパスワードの入力が必要。PCへのログインパスワードが設定されていない場合は、空欄(または0000など適当)でもOK。

追加しています xxxx.php
追加しています readme.txt
ファイルのデータを送信しています ..done

と表示されれば、コミット(更新の実行)が完了している。
こちらも1分程度必要な場合もある。

以上で、自作プラグインのWordpress.org公式ディレクトリへのアップロード・公開は完了。

作業としては必要ないが、Wordpress.orgのレジストリを覗いてみると、ちゃんとアップロードされていることが分かる。なお、サーバー反映までに10分程度必要。

これで、管理画面のプラグインの新規追加からも検索で表示され、インストールも可能になった。

Subversionの使い方(WordPressの自作プラグインのバージョンアップ編)

バージョンアップも基本的にはやることは同じ。
trunk フォルダ内の 自作プラグイン.php に修正を加えたりした後、レジストリにアップロードしてコミットする。

バージョンアップの際のコミットは「svn commit -m “1.2(数字はバージョン数)”」という形で、バージョンアップしていく。
「commit」でファイルの送信上書きもされるので、「svn add」や「svn copy」は必要ない。バージョンアップだけなら、

下画像では「first release」となっている部分をバージョン数にする。
「cd」コマンドで、trunk フォルダに移動してからコミットすること。

追加しています xxxx.php
追加しています readme.txt
ファイルのデータを送信しています ..done

と表示されれば、コミット(更新の実行)が完了している。

バージョンを変化させずに修正する場合（誤字訂正などの簡易な変更など）の場合も、同じ方法で、
「svn commit -m “1.2(数字はバージョン数)”」
でバージョン数を変化させずにコミットすることで対応可能。

ただし、この場合既にインストールしている人には、プラグインのバージョンアップが通知されないので、修正されないままになる。

更新後にも、過去のバージョンを、残したい場合は、タグ付けが必要になる。
タグ付けのコマンドは
「svn copy (http://wordpress内のディレクトリ/trunkのURL) (http://wordpress内のディレクトリ/tags/現バージョン) -m “tagging (現バージョン) release.”」
URLとURLの間などは半角スペースを入れて。

これで、現バージョンを、1.8としてタグ付けして残すことになる。

例えば1.9にバージョンアップした場合、1.8は1.8のまま残せるし、1.9のタグ付けをすれば、1.9も1.9のまま残すことができる。

ディレクトリに公開されているので、wordpress.orgでプラグインの検索をすると、出てくるようになる。

また、管理画面の プラグイン ＞ 新規追加 からも検索で追加できるようになる。

この公式ディレクトリに、ヘッダー画像を追加することもできる。

作業スペースの assetsフォルダ に、 banner-772×250.jpg という名前の、サイズ 772px 250px の画像を入れる。
画像のファイル名は、必ずこの名前にすること。

cd コマンドで、 作業スペースの assets フォルダに移動し、
「svn add banner-772×250.jpg」 とコマンドを叩いて、画像をアップロードする。

上の画像では、「screenshot-1.jpg」 になっているが、 banner-772×250.jpg でも同じ方法でアップロードできる。

以上で、プラグインのバージョン管理と、ヘッダー画像のアップロードも完了。

次は、プラグインの翻訳の方法を見ていこう。

————-
関連記事：

0. 概要:Wordpressの自作プラグインを公式ページに登録・公開して、プラグイン追加からインストールできるようにする方法

1．WordPress.orgのアカウントに登録し、公式ディレクトリにプラグインを申請する

2．プラグインの公式ディレクトリへのアップロードに必要なSubversionのダウンロードとインストール

3．Subversionを使ってWorpdress.orgの公式ディレクトリにアップロード＆バージョン管理

4．.potファイルから .mo ファイルを作ってプラグインの多言語化(国際化)
↑次ここ↑