Regen Press

WordPress2.6へアップデートしました。

今回は WordPress を SVN 管理に移行しました。
SVN 管理についてはわーどぷれすっ！ » WordPress のアップグレードを簡単に: Subversion の巻に詳しく書かれてあります。

それに加えて、WordPress の日本語版 "非公式" リポジトリを使うと日本語版がストレートにインストールできるので便利です。

自分用もあって忘れないために WordPress.org へプラグインの公開の仕方をメモ。プラグインの作り方ではなく公開の仕方限定。

必要な知識

• PHP - WordPress 自体が PHP なのでこれは必須
• WordPress - WordPress のプラグインを書くためには WordPress の内部構造などを知っていないと難しい
• Subversion - WordPress.org は各種プラグインを SVN で管理している

プラグイン作った。次は？

1. WordPress.org のアカウントを持っていなければ取得
2. WordPress › Requests にて、プラグインの名前と説明と任意でプラグインのアドレスを書いてリクエスト送信
3. リクエストが承認されると Subversion のアドレスが送られてくるので、そのリポジトリにプラグインをインポート
4. 適切な readme.txt を作り、プラグインの本体ファイルに適切なコメントをつける（後述）
5. リリースバーションごとに readme.txt などを編集し、SVN のタグ付けをする（後述）
6. WordPress.org が15分毎に巡回してくれて、正しくコメントが付けられていればプラグインディレクトリーに掲載される

readme.txt とコメントとは？

WordPress.org はプラグインの更新のチェックに trunk/readme.txt と本体ファイルのコメントを使用する。
readme.txt は書式が決まっていて、readme.txt の例を参照。WordPress/BBPress Plugin readme.txt Validator を使用すればバリデートできる。
本体ファイルのコメントは、PHPファイルの先頭に次のようなコメントを書く。

他のプラグインを参考にすれば大体OK。

プラグインをリリースしたい

プラグインのリリースは SVN のタグ付けを使う。
readme.txt と 本体ファイルのコメントのそれぞれ Stable tag と Version の項目をリリースするバージョンにあわせる。
必要なファイルを編集したら SVN でタグ付け。タグ名は数字とピリオドのみを使ったほうが良いと公式のドキュメントには書いてある（1.2.3はOK、ver1.2RC1などはNG← 実際は可能）。
あとは巡回で更新が認識されればプラグインディレクトリーに載る。

参考になるドキュメント

• WordPress › WordPress Plugins 以下のドキュメント

大体は以下のサイトを参考にしてインストールしました。

• Dreamhostに trac + Subversion をインストールした。 - カサヒラボ
• TANAKA BLOG - DreamHost に Trac をインストール
• DreamHostにTracをインストール | Oddwit

インストール中に気づいたことは、自分で入れた Python と DreamHost に入っている Python を区別しなければいけないということ。

普通に python とタイプすると、DreamHost の Python が起動するので、意図したディレクトリに格納されない場合がありました。Python のインストールが終わった時点で自分の Python をエイリアスしておくといいと思います。「alias python="/home/*****/local/bin/python"」などです。

あと、上記サイトにあるように、Subversion のインストール時に APR と APR-Util をインストールしておかないと止まります。

trac をサブディレクトリに配置して運用する場合は、.htaccess の「RewriteEngine On」の後に「RewriteBase /projectid/」などを指定しておく必要があります。

trac入れるのって面倒くさいですね･･･