目次

• 第1回：はじめに
  • プラグインの雛型
  • 変数タグの基礎
  • 変数タグの引数
  • ブログデータを扱う変数タグ
  • サンプルファイルのダウンロード
• 第2回：コンテナタグ
  • コンテナタグ
  • コンテナタグの引数
  • コンテナタグ中の変数タグ
  • 条件タグ
  • コンテナタグ中の条件タグ
  • サンプルファイルのダウンロード
• 第3回：フィルタ
  • グローバルフィルタ
  • グローバルフィルタの引数
  • コンテナタグによる実現
  • テキストフィルタ
  • サンプルファイルのダウンロード
• 第4回：その他の機能Ⅰ
  • エラー処理
  • プラグイン特有のデータを保持する
  • サンプルファイルのダウンロード
• 第5回：高度な処理を可能に
  • コールバック
  • BigPAPI 用プラグイン
• 第6回：その他の機能Ⅱ
  • プラグインの設定画面
  • ダイナミックパブリッシング用 PHP プラグイン

グローバルフィルタ

package MT::Plugin::myplugin_3_1; use MT::Template::Context; MT::Template::Context->add_global_filter (HG => ¥&HG); sub HG { my ($data, $arg, $ctx) = @_; $data =‾ s/。/ﾌｩｰｰｰ!!　/g; $data =‾ s/」/オッケ〜〜!!」/g; $data =‾ s/ｗ/ｾｲｾｲ/g; $data; } 1;

　このフィルタは次のように使用することができます。

<$MTEntryBody HG="1"$>

sample_3_1.pl は UTF-8 で書かれています。 ブログの文字コードに合わせて、プラグインを保存し直してください。

コードの詳細

MT::Template::Context->add_global_filter (HG => ¥&HG);

　HG という名前のグローバルフィルタを定義し、 その処理は HG に書かれている、ということ。

my ($data, $arg, $ctx) = @_;

　フィルタに入力された文字列、フィルタへの引数、現在のコンテクストを取得します。おまじない。

$data =‾ s/。/ﾌｩｰｰｰ!!　/g;

　入力された文字列中の読点"。"を全て"ﾌｩｰｰｰ!!"に置き換えます。

$data;

　処理された結果を出力します。

グローバルフィルタの引数

package MT::Plugin::myplugin_3_2; use MT::Template::Context; MT::Template::Context->add_global_filter (star => ¥&star); sub star { my ($data, $arg, $ctx) = @_; my $star = '☆彡' x $arg; $star. $data. $star; } 1;

コードの詳細

my $star = '☆彡' x $arg;

　$arg で指定された回数だけ、 '☆彡'を繰り返し、これを $star に代入します。

$star. $data. $star;

　入力された文字列の前後に $star で囲んで出力します。

コンテナタグによる実現

package MT::Plugin::myplugin_3_1a; use MT::Template::Context; MT::Template::Context->add_container_tag (MakeHG => ¥&HG); sub HG { my ($ctx, $args, $cond) = @_; my $builder = $ctx->stash('builder'); my $tokens = $ctx->stash('tokens'); my $out = $builder->build ($ctx, $tokens, $cond); return $ctx->error ($builder->errstr) if !defined $out; $out =‾ s/。/ﾌｩｰｰｰ!!　/g; $out =‾ s/」/オッケ〜〜!!」/g; $out =‾ s/ｗ/ｾｲｾｲ/g; $out; } 1;

　グローバルフィルタで済むところは、素直にグローバルフィルタを使っておくのが良いでしょう。

テキストフィルタ

package MT::Plugin::myplugin_3_3; MT->add_text_filter ('sakage', { label => '逆毛語', on_format => ¥&sakage, }); sub sakage { my ($data) = @_; $data =‾ s/、/ｗｗｗ/g; $data =‾ s/。/ｗｗっうぇｗっうぇｗ/g; $data =‾ s/！/！！！１！１１！/g; $data; } 1;

sample_3_3.pl は UTF-8 で書かれています。 ブログの文字コードに合わせて、プラグインを保存し直してください。

コードの詳細

MT->add_text_filter ('sakage'

　sakageという内部名でテキストフィルタを追加します。 グローバルフィルタfilter="..."で指定する場合に使用します。

label => '逆毛語'

　"改行設定"ドロップダウンリストに表示されるフィルタ名称です。

on_format => ¥&sakage

　フィルタが選択された時に、適用する処理は sakage に書かれている、と云うこと。

my ($data) = @_;

　入力された生のデータ。これに対してフィルタ処理を行います。 この辺りはグローバルフィルタと同じです。

サンプルファイルのダウンロード