hiromasa.zone : o)

wp-hatena にみるプラグインの作成方 – 後編 – です。

前回はこちら。

wp-hatena にみるプラグインの作成方 – 前編 –

おっとここで、kohaku さん、chameleon さんから入電。 同じソーシャルブックマークの del.icio.us への対応要望をいただきました。（←ということにしてください（笑）

次回は、このプラグインを del.icio.us 対応に改造してみます。　そしていよいよ Masayan さんも登場しますのでおたのしみに…

今回は WP というより PHP 寄りの話題になりそうです。プログラムを書くときの “共通項のまとめ方” のイメージだけつかんで頂ければ･･･、、と思って書いてみました。　この辺の言語の仕組みが分かると、既存のプラグインの流れも追いやすくなるとおもいます。　良ければ読んでみてください。

ということで、wp-hatena の del.icio.us 対応をいよいよやってみます。（遅くなってごめんなさい..)

まずは、del.icio.us の仕様を調べてみます。

• 「http://del.icio.us/post?url=[ブックマーク登録URL]」という形式でリンクすればブックマーク登録画面になる

となっているようです。 はてなが「http://b.hatena.ne.jp/append?[ブックマーク登録URL]」とすれば良いのと同じイメージですね。はてな用のコード（関数）を転用すればすぐできそうです。あと違うのは画像ファイルの URL くらいです。

では、既にある、はてなをうけもつ addHatena() 関数のコードをみてみましょう。

こんな感じになっています。これを元に同じような adddelicious 関数を追加しちゃえば良さそうです。 コード中 “$this->haneta_url” と “$this->hatena_gifname”の部分が del.icio.us 用になりますので、変数の新設や初期化コードも追加します。とりあえず初期化コードはここでは省略して、adddelicious 関数だけつくってみましょう。

このような adddelicious() 関数を addHatena() 関数の下に”追加”してみました。addHatena() のほぼデットコピーで、URL の変数とリンクタグの alt/title 属性の日本語だけ書き換えたものです。簡単にできちゃいました。

あとはこの関数を使う方のテーマ内から「<?php $wph->adddelicious(); ?>」と呼び出してもらえば del.icio.us 用のリンクが追加できるようになりました。やぁめでたい。

この調子でどんどん同じような関数を増やしていけばいろいろなソーシャルブックマークに対応できます。しかし、なにか釈然としない部分がありますね。ちょっとしか違わない同じようなコードが大量にある･･･。

プログラムの神様はこういったところを見逃さず天罰を与えてきます。 😛

ここで Masayan さんより不具合の報告を頂きます。

wp-hatena.phpの87行目
$title .= ‘”>’;→”がダブり、target=”_blank””のようになる。

wp-hatena.phpの95行目
$title .= ‘>’; → $title .= ‘ />’; /で閉じないと怒られる。

はうぁ。。（大汗

た、たしかに･･･。どうもありがとうございます。

直さなきゃ!、と思ったときに修正する部分が大きく２ヶ所あることに気がつきます。addHatena() 関数と adddelicious() 関数 です。この２つはデットコピーで作ってしまったために不具合も増殖させてしまったわけです。もし、２つではなくもっとたくさんのソーシャルブックマークに対応していたら･･･と思うとガクガクブルブルです。

プログラムを書くときには いろいろなところに存在する”共通項”の部分をなるべく”まとめて”書くようにすると、このような時に修正するのが簡単になり、また不都合も減らすことが出来ます。

今回は”まとめる” ための手法として”関数”を使って、共通項をくくってみます。

はてなも del.icio.us も、そしておそらく他のソーシャルブックマークも同じようなタグを作成するので、ここの部分をまとめるために makeBookmarkURL という関数を新設します。各ブックマークでタグが変る部分、

• alt/title の名称 – $sitename
• URL – $url
• 画像アイコンファイル名 – $iconfile
• 画像の大きさ。- $width、$height

を、関数の”引数” として渡すようにします。引数というのはワードプロセッサなんかの差し込み印字に近いイメージです。では、makeBookmarkURL 関数のコードをみてみます。

最初の “makeBookmarkURL($sitename, $url, $iconfile, $width, $height)” 部分が “引数” を受け取る部分です。

最後の “return $tag;” というのはこの関数が呼ばれたら $tag の内容を呼び元に返しなさいという表記です。この場合、$sitename や $url 等々が差し込まれたブックマーク用の画像タグが戻ります。

では呼び元である addHatena()、adddelicious() 関数を心機一転、makeBookmarkURL() 関数を呼び出す形に変更します。　呼び出すときは、$sitename や $url 等々の情報を埋め込んだ書き方にします。

ずいぶんすっきりしました。　呼び出し元と呼び出し先を見比べると “差し込み印字” のイメージが分かると思います。

では、Masayan さんからいただいたタグのミスを修正します。 makeBookmarkURL関数”だけ” 直せば はてなも del.icio.us も直るわけです。

また、たとえばタグが気に入らなかった場合もこの関数だけ修正すればすべてに反映できますね。

wp-hatena に限らず “関数” についてはほぼ全てのプログラムで使われる手法です。　このように共通部分をくくりだすことができる他、コードを処理単位に分けて書くことが出来るようになります。

プログラムはあっちこっちの関数を呼び出して動くことになるので、慣れないうちは流れを追うのが大変かもしれませんが、逆になれてしまえば必要のない関数は読む必要がない（何をする関数なのか予測がつく）ので非常に楽になると思います。　是非活用してみてください。

—

以上で長きにわたりましたプラグインノウハウシリーズは終了です。　今回サンプルにしていました wp-hatena をもう少し修正したものを下記で配布していますのでよければ参考にソースをどうぞ。

実は今回のエントリの del.icio.us 対応ソースだと、ブックマーク時に del.icio.us にタイトルが渡りません。この辺の対応もあわせてしています。

WordPress エントリをはてなブックマークに登録 – wp-hatena プラグイン正式版 – リリース

最後に。　とりとめのない文章を終わりまで読んで頂きましてありがとうございました。