プラグインのリポジトリ登録について2012.8.19（第７回 WordBench 京都勉強会）

京都大学東南アジア研究所・木谷公哉（ kimipooh ）

2

プラグインと本体のアップデートが管理パネルから簡単にできる

WordPress との出会い0オープンソースカンファレンス 2010 Kansai@Kyoto

0 「世界標準ブログ WordPress とそのコミュニティの魅力」0日時： 2010/7/9 ( 金 )0担当： WordBench 京都・滋賀0場所：京都コンピュータ学院0http://kyoto.wordbench.org/2010/06/30/osc2010-kyoto/

ぶらっと寄ってみたら WordPress の機能に魅せられ

11 月より 5 サイト同時に立ちあげ！？

3 月納品直前にWordPress 3.1 がアップグレード！いろいろ問題勃発＆多言語プラグイン「 WPML 」が有料に！

7/20 に実験サイト立ちあげ

10 月に多言語化を中心に実験し、 11 月にPHP5.3 問題に苦慮していたら

http://kitaney.jp/~kitani/manual/php/php53.html#2

3

プラグイン「 WP DS FAQ Plus 」

0 カスタム投稿を使えばよかった・・・0 当時、その存在を知らず

0 掲示板と FAQ プラグインを探したが・・・0 しっくりくる物が無かったので作成してみようと

0 WP DS FAQ プラグインがよさそうだったが0 セキュリティ問題が数多く内包されているというコメント

があったので（ CSRF 対策とか、 SQL Injection とか多数）

0 そのあたりを中心に拡張してみたら0 いろいろカスタムしたくなってきて・・・

レポジトリ： http://wordpress.org/extend/plugins/wp-ds-faq-plus/当初公開： http://kitaney.jp/~kitani/tools/wordpress/紹介： http://www.cseas.kyoto-u.ac.jp/info/links-ja/plugin-ja/wp-ds-faq-plus-ja

4

リポジトリ登録するには1. WordPress.org のアカウント取得2. プラグインの登録申請3. プラグインの承認4. リポジトリ登録（ Subversion ）

a. プラグイン公開情報（所定の書式で）b. SVN 利用環境整備c. SVN の仕組みd. SVN の操作説明（プラグイン公開、閲覧のみ）

5

WordPress.org のアカウント取得

0http://wordpress.org

6

プラグイン登録申請（１）1. グローバルメニュー「 Plugins 」の

左サイドメニュー「 Developer Center 」へアクセス

2. 「 ask us to host it for you 」のリンクをクリック

7

プラグイン登録申請（２）

8

プラグインの承認

9

リポジトリ登録1. プラグイン情報ファイル「 readme.txt 」の確認

- http://wordpress.org/extend/plugins/about/validator/ サンプル： http://wordpress.org/extend/plugins/about/readme.txt

2. SVN の準備方法 - http://wordpress.org/extend/plugins/about/svn/

10

プラグイン情報ファイル「プログラム本体」

<?php/*Plugin Name: WP DS FAQ PlusPlugin URI: http://kitaney.jp/~kitani/tools/wordpress/wp-ds-faq-plus_en.htmlDescription: WP DS FAQ Plus is the expand of WP DS FAQ plugin. The plugin bases on WP DS FAQ 1.3.3. This plugin includes the fixed some issues (Quotation and Security, such as SQL Injection and CSRF. ) , Japanese translation, improvement of interface, and SSL Admin setting.Version: 1.0.14 (September 22, 2011)Author: Kimiya KitaniAuthor URI: http://kitaney.jp/~kitani/*/

11

プラグイン情報ファイル「 readme.txt 」

SVN: http://plugins.svn.wordpress.org/wp-ds-faq-plus/tags/1.0.14/readme.txt

http://wordpress.org/extend/plugins/wp-ds-faq-plus

12

SVN 環境の準備（ Macintosh ）

010.5/10.6 ：標準搭載010.7/10.8 ：要インストール

1. Mac App Store から Xcode をインストール2. Xcode を起動時し、上部「 Xcode 」メニューから

「 Preferences 」を選択 「 Command Line Tools 」をインストール

※ 自前で入れたい！ <SCPlugin> http://scplugin.tigris.org/

13

SVN 環境の準備（ Windows ）

0TortoiseSVN http://sourceforge.jp/projects/tortoisesvn/ など

0 インストール方法・設定・利用方法は - http://www.gside.org/Gentoo/subversion/subversion_client.html が分かりやすい？

公式リポジトリ登録するスキルがあるなら、環境は自前で整えるレベルのはず・・・

14

SVN の仕組み- WordPress 公開リポジトリ（１） -

/wp-ds-faq-plus/ （フォルダ）

SVN サーバ 自分の PC

wp-ds-faq-plus/ （フォルダ）Checkout

紐付け（認証）

tags を更新すると、公開リポジトリに自動反映される（数分後）

┣ tags/ 公開 version/ ┣ trunk/ ┗ branches/

┣ tags/ 公開 version/ ┣ trunk/ （開発版） ┗ branches/

update

commit

※ 公開 version = readme.txt の stable tag

addファイルの紐付

紐付済ファイル更新

SVN サーバ側と同期

15

SVN の仕組み- WordPress 公開リポジトリ（２） -

コメント（ Commit 時）

http://wordpress.org/extend/plugins/wp-ds-faq-plus/developers/

16

SVN の操作説明1. Checkout （ svn サーバと紐付け：開設）

0 svn checkout SVN URL PC フォルダ --username ユーザ名

0 svn checkout http://plugins.svn.wordpress.org/wp-ds-faq-plus/ ~/Desktop/wordpress/wp-ds-faq-plus --username kimipooh （一行で書く）

2. Add （ svn ファイルとして登録）0 svn add PC ファイル（複数可）

0 svn add ~/Desktop/wordpress/wp-ds-faq-plus/trunk/*

3. Commit （更新）0 svn commit PC フォルダ（省略可） -m “ コメント”

0 cd ~/Desktop/wordpress/wp-ds-faq-plus/ （ PC フォルダ指定省略のため）0 svn commit -m “fixed readme.txt”

4. Update （ SVN サーバデータと同期）0 svn update PC フォルダ（省略可）

0 cd ~/Desktop/wordpress/wp-ds-faq-plus/0 svn update

5. Remove （削除）0 svn delete ファイル（フォルダ or URL ）

0 svn delete ~/Desktop/wordpress/wp-ds-faq-plus/trunk/* （開発中のコードを削除例） 0 svn commit –m “Deleted file ‘hogehoge’.”

17

SVN の操作説明- プラグイン更新編 -

「デスクトップ→wordpress→wp-ds-faq-plus 」フォルダにプラグインフォルダがあると仮定

cd ~/Desktop/wordpress/wp-ds-faq-plus （フォルダへ移動）

1. Add （ svn ファイルとして登録）0 svn add PC ファイル（複数可）

0 svn add trunk/*

2. Commit （更新）0 svn commit PC フォルダ（省略可） -m “ コメント”

0 svn commit -m “updated.” （サブフォルダ以下更新データのアップデート）

3. Copy （各バージョンごとの公開）0 svn copy コピー元　コピー先 –m “ コメント”

0 svn copy trunk tags/1.0.140 svn commit -m “1.0.14 released”.あるいは0 svn copy http://plugins.svn.wordpress.org/wp-ds-faq-plus/trunk

http://plugins.svn.wordpress.org/wp-ds-faq-plus/tags/1.0.14 -m “tagging 1.0.14.”

18

SVN の操作説明- 閲覧のみ -

「 WP DS FAQ Plus 」の開発コードを PC へダウンロードしてみましょう

1. フォルダ作成0 mkdir wp-ds-faq-plus

2. Checkout （ svn サーバと紐付け：開設）0 svn checkout http://plugins.svn.wordpress.org/wp-ds-faq-plus/

※ 公開されているので、ダウンロードだけは認証なしで出来る

3. Update （同期）0 cd wp-ds-faq-plus0 svn update