さて、いろいろ書きたいのは山々なんですが・・・時間がなくてだな。。。

書きたいことをまるっとさくっと書きます。WordCampの中でも紹介されていたコメント欄拡張プラグイン「IntenseDebate」の威力が半端ないです。何故知らなかったのか!!!!（眼にしたような記憶があるけど)

その威力は、私のコメント欄を見ていただければ分かるかと思います。素晴らしいほどの連携。

TwitterやFacebookとの連携、IntenseDebate自身のプラグインによる機能拡張と、もうこれは！使うしか！ない！！！！

という、威力です。（見込み。）

インストール方法に関しては、IntenseDebateサイトでアカウントを作成、プラグインファイルのアップロード、IntenseDebateでの設定だけです。

WordPressのプラグインでコメント欄、というとテンプレートを書き直すものだと思っていましたが、テンプレート自身は何1ついじっていません。この点も驚きつつ、最終的に出来上がったものがまが（驚）

日本語にも対応していますが、どうやらIntenseDebateの設定画面は英語onlyらしいですが、どうにかなるレベルです。つまずくとすれば、FacebookのAPI設定に関して、Facebook上でアプリケーション登録→API Keyとか入力という作業が発生します。（大きな声では言えないが、日本国内のサイトなら設定しなくてイイと思う）

（これ、mixiにも対応したら、日本国内では恐ろしいことになるんだろうな…しないと思うけど（ﾎﾞｿｯ）

PS.お願い

効果のほどを知りたいので、お暇な方は使ってみて貰えると嬉しいです。

つい先日、WordPressのテーマファイルのカスタマイズ案件としてwp.vicunaを使用しました。事前認識としては「使いやすいんだろうなぁ～」程度のゆるふわな評価でしたが、凄かったのです。

使用したwp.vicunaはver.2.03。ライセンスはWordPressの場合MITライセンスとのことです。スキンとして、5種類が用意されています。管理画面から横幅についても変更可能という恐ろしさ。

• Style-vega
• Style-mono
• Style-galaxy
• Style-flat
• Style-future

さらに！カラムレイアウトを管理画面から変更することが可能です。管理画面のサイドバー下部「Vicuna」より、各種プロパティの設定が可能です。2カラム3カラムはもちろん、それぞれの左右カラムの入れ替えや変則的な構成までサポート。カラムレイアウトに関してはこちらに詳細が紹介されています。このリンク先のページでは、「bodyタグのクラス名を変更することでカラムレイアウトを変更する」と書かれていますが、どうやら古い情報のようです。

現在のバージョンでは、管理画面からそれぞれのページに対して、それぞれのページのカラムレイアウトを変更することが可能です。

body.class=”Name”それぞれに対してカラムレイアウトを作成し適用させています。サーバー環境に不満がある方は、直接書くファイルのbodyタグのclass名を変更した方が高速に動作すると思われます。何故かというと、管理画面からカラムレイアウトを設定すると、データベースのうちwp-optionsテーブルに値を格納し、表示の度に呼び出すからです。

カスタマイズ性に関しても申し分ないですが、初心者の方にとっては少々難があるかもしれません。CSSファイルを分割して記述しているため、どこに何が書いてあるのか分からない！と言う事態が考えられます。（firebug使えばいいと思うよ）

サイドバーについては、ウィジェットにも対応しているので、普通に表示したいものについては問題ないと思います。どのテーマファイルを選べばいいのか迷った際には、wp.vicunaはオススメです！

早速参加登録してみました。できれば懇親会にも参加したいところなのですが、ちょっとスケジュールの調整が必要そう。誰か一緒に行きませんか？

e2esound.com:WordPressで外部RSSを取得して表示させる

書いたのは2008年ということで、これはまだWordPressをいじり始めて3ヶ月くらいのヘッポコもヘッポコな頃のものでございます。その後、PHPも勉強していることですし、今回は別の方法として、PEARライブラリを使用した方法を紹介します。

PEARライブラリのうち、XML_RSSを使用します。lolipopではデフォルトでインストールされていますが、他のサーバーの方はPEARライブラリのインストールと使用方法を確認して下さい。

サクッと作るとこのようになります。流れているRSSのタイトル＋リンクを表示しています。

[php]

<?php
//文字コード指定
//header(“Content-Type: text/html; charset=UTF-8″);

//対象のRSS
$url = “http://feeds.feedburner.jp/e2esound/Izak”;
require_once(‘XML/RSS.php’);

//インスタンス化
$rss = new XML_RSS($url);
$rss->parse();

echo “<h1>外部サイトのRSSを取得し表示する</h1>”;

$items = $rss->getItems();

echo “<ul>”;
//$itemsの配列が空ではない場合
if(!empty($items)){
    foreach($items as $item){
      echo “<li><a href=\”".$item['link'].”\”>”.$item['title'].
      ”</a></li>”;
    }
}else{
//$itemsの配列が空の場合
echo “<li>No Contents</li>”;
}

echo “</ul>”;

//End of File.
[/php]

あれ？以前のものよりも分かりやすいような。

1. PEARをrequire_once（）
2. インスタンス化
3. $rss->parse()
4. $rss->getItems()で結果を取得
5. 表示させる

尚、表示する内容を変更する場合には、$itemsの中身をvar_dump()し表示項目を追加してあげれば問題ありません。例えばdescriptionなら$item[‘description’]など。

以上のコードも、使用頻度が高いならWordPressのfunctions.phpに書いて関数かした方がイイかも。

[追記]
タイトルにWordPressと書きましたが、普通にPHPで動きます。

URL:http://github.com/e2esoundcom

今のところ、このblogでも紹介しているCodeIgniter等々のファイルを上げておきました。以前紹介したMY_helperについても内容を更新しています。

その他には、CodeIgniterやWordPressのVim用辞書ファイルもあります。

WordPressの辞書ファイルについては、現在作り直しを行っています。WordPress 3.0へのバージョンアップや内容の充実を目指しています。例えば、これまでテンプレートタグのみを辞書に登録していましたが、WordPress専用の関数やそれぞれの引数についても入れ込む予定です。

・・・誰か手伝ってくれる人、いないだろうか。ふぅ。

1.ページテンプレートをWordPressに認識させる

archive.phpやcategory.phpは必ず作るべきファイルです。さらに、WordPressのページ機能を使う為にはページテンプレートを書く必要があります。

ページテンプレートをWordPressの管理画面で認識させ、使用するにはページテンプレート冒頭に以下のように書きます。テンプレートがTemplateNameと認識されます。

[php]
<?php
/*
Template Name: TemplateName
*/
?>
[/php]

2.ページテンプレートで<!–more–>タグを機能させる

実は、index.php以外のページでは、投稿を表示させて<!–more–>を使っても記事の折り畳みができません。折り畳みさせるにはテンプレート冒頭に以下を記述することでクリアできます。

[php]
<?php
global $more;
$more = false;
?>
[/php]

3.query_posts関数でアレコレ表示させる

テンプレートタグ/query posts – WordPress Codex 日本語版

見て貰うのが一番手っとり早いですが、この関数と条件分岐を使えば、以下のようなことができます。

• 特定カテゴリーの投稿だけ表示
• 特定の投稿者の記事だけ表示
• 最新20件のみ表示
• 上記の組み亜合わせで表示

企業サイトであれば、informationページを作成して、最新のinformationカテゴリの投稿のタイトルとページリンクを表示→リンクをクリックするとそれぞれのsingleページに飛ばす、ということができます。

今日はまず、WordPress日本語版2.92.にバンドルされているHello Dollyの構造と機能を分析しながら、WordPressプラグインの作り方を考えてみたいと思います。

Ⅰ.Hello Dollyって何だろ？

これについては、WordPress Codexに詳しく書いてありました。

Hello Dolly（ハロー・ドリー）
これはただのプラグインではありません。ルイ・アームストロングによって歌われた最も有名な二つの単語に要約される、同一世代のすべての人々の希望と情熱を象徴するものです。これは世界で最初の WordPress 公式プラグインです。このプラグインが有効にされると、プラグイン管理画面以外の管理パネルの右上に「ハロー・ドリー」からの歌詞がランダムに表示されます。

プラグイン – WordPress Codex 日本語版:パッケージに含まれているデフォルトプラグイン

よく分からないYouTubeに行ってみると、「あぁ、これか!!」と思われる楽曲に出会えると思います。

Ⅱ．解析に必要なもの

ここから先を読み解くには以下のものを使用します。

• Hello Dollyプラグイン…WordPress日本語版をDLして取り出す。(hello.php)
• WordPress Codex日本語版：http://wpdocs.sourceforge.jp/
• シンタックス・ハイライトできるテキスト・エディタ又はIDE（私はKaoriYa版Vim）

Ⅲ．Hello Dollyの構造

早速、ファイルを開いてみましょう。全体で84行と短いので、その構造はシンプルです。順にその内容を確認してみます。

1. コメント
2. 2つのadd_action
3. 3つのユーザー定義関数

1.コメント

プラグインの中に記述されるコメントは、もちろん開発用に記録されたものもありますが、WordPress管理画面でプラグインの情報として認識されるものです。Hello Dollyでは以下のようになっています。

[php]
/*
Plugin Name: Hello Dolly
Plugin URI: http://wordpress.org/#
Description: これはただのプラグインではありません。Louis Armstrong によって歌われた最も有名な二つの単語、Hello, Dolly に要約された同一世代のすべての人々の希望と情熱を象徴するものです。このプラグインが有効にされると、すべての管理画面の右上に <cite>Hello, Dolly</cite> からの歌詞がランダムに表示されます。
Author: Matt Mullenweg
Version: 1.5.1
Author URI: http://ma.tt/
*/
[/php]

以上の情報は、管理画面でのプラグイン名称や概要、バージョン情報等として扱われます。この辺りの詳細については、WordPress Codexのプラグインの作成にまとめられています。

2．2つのadd_action

プラグインの動作にはWordPressに内包されるプラグインAPIのフックへの関連付けが必要となります。例えば、index.phpのheaderが呼び出されるタイミングで実行、ログイン。フォームが読み込まれた終盤で実行等です。

フックには2種類あり、1つがHello Dollyの中でも使用されるアクションフック、もう1つがフィルターフックです。それぞれの詳細については、リンク先をご参照ください。

今回使用されているフックは、admin_footerとadmin_headです。

admin_footer
管理画面各ページの<body>要素の終盤で実行する。

admin_head
管理画面各ページの<head>要素内で実行する。

プラグイン API/アクションフック一覧 – WordPress Codex 日本語版

Hello Dollyでは、admin_footerはHello Dollyの菓子を表示する為、admin_headはCSSを読み込む為に使用されています。

3.3つのユーザー定義関数

関数それぞれを確認してみます。

• hello_dolly_get_lyric()
• hello_dolly()
• dolly_css()

まずは、hello_dolly_get_lyric関数から。関数名の通り、歌詞をランダムに取り出す為の関数です。コメントのうち、「//e」と書かれているものは私が加筆した部分です。

[php]
function hello_dolly_get_lyric() {
/** These are the lyrics to Hello Dolly */
//e 歌詞を変数に格納
$lyrics = “Hello, Dolly
Well, hello, Dolly
It’s so nice to have you back where you belong
You’re lookin’ swell, Dolly
I can tell, Dolly
You’re still glowin’, you’re still crowin’
You’re still goin’ strong
//e ———-中略———-
Dolly’ll never go away
Dolly’ll never go away
Dolly’ll never go away again”;
// Here we split it into lines
//e 文字列を改行までで区切り、配列に格納
$lyrics = explode(“\n”, $lyrics);
// And then randomly choose a line
//e 配列の添え字によってランダムに出力
return wptexturize( $lyrics[ mt_rand(0, count($lyrics) - 1) ] );
}
[/php]

難しい処理はありませんが、注意すべき点としてwptexturize関数が使用されています。この関数はWordPress標準の文字列出力を修正する為の関数です。ランダムに得た文字列をWordPressのルールに則って整形して返しています。

次に、hello_dolly関数です。hello_dolly_get_lyric関数で得られた文字列をpタグで囲って表示させます。

[php]
// This just echoes the chosen line, we’ll position it later
function hello_dolly() {
$chosen = hello_dolly_get_lyric();
echo “<p id=’dolly’>$chosen</p>”;
}
[/php]

この関数は、アクションフックのadmin_footerと関連付けられている為、管理画面の</body>タグ終盤で実行されます。

[php]
// Now we set that function up to execute when the admin_footer action is called
add_action(‘admin_footer’, ‘hello_dolly’);
[/php]

最後に、dolly_css関数です。管理画面のhead要素の中にCSSを記述します。コメントのうち、「//e」と書かれているものは私が加筆した部分です。

[php]
// We need some CSS to position the paragraph
function dolly_css() {
// This makes sure that the posinioning is also good for right-to-left languages
//e $xは文字列の表示方向によってleftまたはrightになる
$x = ( ‘rtl’ == get_bloginfo( ‘text_direction’ ) ) ? ‘left’ : ‘right’;
//e head要素内に記述するCSSの内容
echo ”
<style type=’text/css’>
#dolly {
position: absolute;
top: 4.5em;
margin: 0;
padding: 0;
$x: 215px;
font-size: 11px;
}
</style>
“;
}
[/php]

get_bloginf(‘text_direction’)は、文字列の表示方向を返します。日本語環境の場合にはもちろんrtl(R to L)です。言語環境に於いて、表示位置を切り替える配慮がされています。

この関数は、アクションフックのadmin_headと関連付けられている為、管理画面のhead要素内で実行されます。つまり、head要素にCSSを追記する形になります。

以上のように、2つの関数がフックによって適時実行されることで管理画面にHello Dollyの歌詞を表示しています。ポイントは、フックです。

Ⅳ.最後に

プラグイン開発の方法として、関数の定義とフックの関連付けができれば開発が可能！ということがわかります。

Hello Dollyはとてもシンプルなプラグインです。より複雑なものだと、管理画面にプラグイン専用のページを追加したり、データベースにテーブルを作成したり、JavaScriptを絡めたりと限りなくあります。

もちろん、自分で○○をしよう！と思った場合には、車輪の再開発を防止する為にも、求めている機能が実装されたプラグインが無いのか調べる方がbetterです。しかし、該当するプラグインが無い時、機能が惜しいプラグインがある時には、開発やカスタマイズが必要になります。フックとPHPについて理解できれば、大抵の機能は実装できそうです。

Ⅴ.次回

• A案：何かプラグインを解析してみる
• B案：何か思いついたらプラグインを作り始めてみる

おまけ

早速、書いてみるテスト。
使うコードは以下のもの。

$str = “Hiliter Test”;
echo $str;
?>

[php]
$str = "Hiliter Test";
echo $str;
?>
[/php]

言語名を表示する為に「lang_name=”true”」を追加。
[php lang_name="true"]
$str = "Hiliter Test";
echo $str;
?>
[/php]

簡易表示機能もあるらしいので「light=”true”」をテスト。
[php light="true"]
$str = "Hiliter Test";
echo $str;
?>
[/php]

これはプログラム・コードを紹介するには必須な気がしてまいりました。早く採用するべきでしたね。このところjQueryにも手を出しているので、紹介していきたいと思っています。

おまけ：
コマンドラインから「php -s 対象ファイル.php」をするとHTML用にハイライトされた結果が帰ってきます。
上記のファイルだとこんな感じ。（codeタグで囲まれています）


      $str = "Hiliter Test";
      echo $str;
?>




これは参った！パースエラー！！
しかも、海外ユーザーの様子を見る限り、動いているらしいので日本語版のみ？のエラーかと思われました。

そして、なす術なく放置していましたが先ほど見つけましたよ、解決方法。
Firefox更新情報Wikiブログ:ScribeFire 3.5のエラー解消法

早速適用してみたところ、無事に起動しました。

ただ、気になる点としてWordPressのカスタムフィールドを扱えるようになったらしいのですが、方法がよく分からんのです。
むーん。

・・・と思ったら投稿時に設定することが判明しました。これは！！イイ！！

環境：WinXP sp3,Firefox3.6

1.ｌolipop管理画面からDBバージョンアップ（テスト）を行う。
新しいデータベースをver.5で作ってくれます。
全く異なるDBサーバーです。

2.問題ないかテストしてみる。
本来ならテスト用の環境を作るべきところを、そのまま本番環境で（ぇ
WordPressをインストールしたディレクトリ直下の「config.php」のデータベース名、データベースサーバー名等変更します。
→そして保存。

この段階で、ver.5のMySQLを使用したWordPressに早変わり。

3.最後に正式適用。
このままだと、作られたDBは削除されてしまいます。テスト環境として一時的に作成されている為です。
そこで、再度管理画面に入り、DBを正式適用します。

これであなたのlolipopもver.5のMySQLでサックサクですね。
作業自体は簡単です。是非是非。

*よい子はテスト環境を作ってやりましょう。