PowerCMS ブログ

管理画面を自由に設計でき、Movable Type (Power CMS for MT)の管理画面でオブジェクトのデータベース管理を行えるようにするプラグイン「カスタムオブジェクト」の紹介の続きです。

カスタムオブジェクトのテンプレート、個別ページの作成及びプラグインでの拡張についてご紹介します。カスタムオブジェクトについてはひとつ前のエントリをご覧ください。

カスタムオブジェクト関連のテンプレート・タグ

タグはすべてスタティック/ダイナミック(DynamicMTML)の両方に対応しています。

ブロックタグ

ファンクションタグ

ファンクションタグはMTCustomObjectLabelタグを除きMTCustomObjectsまたはMTCustomObjectタグの中でコンテクストにセットされたカスタムオブジェクトに関する情報を出力します。カスタムフィールドで指定した値についてはブログ記事等のカスタムフィールドと同様に出力可能です。日付け関係のタグでは日付けに関するモディファイアを利用可能です。

カスタムオブジェクトをページとして表示する

カスタムオブジェクトの一覧をインデックスアーカイブとして登録して出力することは可能ですが、個別のオブジェクトを表示させたいケースもあるかと思います。カスタムオブジェクトはアーカイブタイプに対応していないため個別ページを出力することはできませんが、Power CMS for MTのオプションプラグインViewerを利用することで動的に個別ページを出力させることができます。

Viewerプラグインの設置とテンプレートの作成

• OptionsディレクトリからダウンロードしたViewerディレクトリの直下のcgi-scriptsディレクトリにあるmt-viewer.cgiをMTのインストールディレクトリに設置して実行可能なパーミッションを付与する
• ViewerディレクトリをMTのpluginsディレクトリにコピー
• Viewerディレクトリ直下のtmplディレクトリ以下に表示用のテンプレートを設置(例:customobject.tmpl)

mt-viewer.cgi (*)はtemplateパラメタに指定したテンプレートを解釈してページを表示します。上記の例では http://example.com/cgi-bin/mt/mt-viewer.cgi?template=customobject&blog_id=1 のようにして呼び出すことができます。

* CGIスクリプト名はテンプレートタグでMTViewerScriptで呼び出すことができます。この値は環境変数ViewerScriptをmt-config.cgiに記述することで変更することができます

テンプレートの中ではCGIスクリプトに渡された値がmt:var (MTGetVar)タグで取り出すことができます。上記リクエストの場合<mt:var name="template" escape="html">で「customobject」を受け取ることができます。

customobject.tmplに下記のように記述することで各ブログのテンプレートモジュールを使うことができます。

<$mt:include module="$template" blog_id="$blog_id"$>

パラメタにid指定がある場合は個別のカスタムオブジェクトのページを、id指定がない場合はカスタムオブジェクトの一覧を表示する簡単なテンプレートの例を示します。

<MTUnless name="id">
<MTCustomObjects lastn="30">
    <MTCustomObjectsHeader><ul></MTCustomObjectsHeader>
        <li><a href="<MTViewerScript>?blog_id=<$MTBlogID$>&amp;id=<MTCustomObjectID>&amp;template=<mt:var name="template" escape="html">"><$MTCustomObjectName$></a></li>
    <MTCustomObjectsFooter><ul></MTCustomObjectsFooter>
</MTCustomObjects>
<MTElse>
    <h1><$MTCustomObjectName escape="html"$>(<MTCustomobjectMore>)</h1>
    <MTCustomobjectImageMain>
        <p><img src="<$MTAssetURL$>" /></p>
    </MTCustomobjectImageMain>
    <MTCustomobjectBody filters="__default__">
    <ul>
    <li><__trans phrase="Created On"> : <$MTCustomObjectAuthoredOn$></li>
    <li><__trans phrase="Created By"> : <$MTCustomObjectAuthorDisplayName$></li>
    </li>
    </ul>
</MTElse>
</MTUnless>

プラグインによる拡張

カスタムオブジェクトプラグインを外部プラグインで拡張することが可能です。カスタムオブジェクト自体はMT::Objectのサブクラスですので、MTのAPIを利用してオブジェクトをロードしたりデータベースのカラムを拡張したりtemplate_param, template_source等のコールバックに対応したプラグインを書くことができます。

コールバック

コールバックをトリガとして処理を行うプラグインを書くことが可能です。