« 目次

Movable Type オブジェクト・リファレンス

MT::TemplateMap

概要


use MT::TemplateMap;
my $map = MT::TemplateMap->new;
$map->blog_id($tmpl->blog_id);
$map->template_id($tmpl->id);
$map->archive_type('Monthly');
$map->file_template('<$MTArchiveDate format="%Y/%m/index.html"$>');
$map->is_preferred(1);
$map->save
    or die $map->errstr;

解説

MT::TemplateMapは、あるブログにおける、アーカイブ・テンプレートとアーカイブの種類の1対1の対応を表します。たとえばDate-Basedという名前のテンプレートを作成し、これを月別アーカイブにマッピングする場合、このマッピングを1つのMT::TemplateMapオブジェクトで表します。

利用方法

MT::TemplateMapは、MT::Objectのサブクラスで、MT::Objectのデータ管理およびデータ保存用のメソッドをすべて継承しています。新規オブジェクトの生成、既存オブジェクトの読み込み、オブジェクトの保存などの詳細については、MT::Objectを参照してください。

データ・アクセス用メソッド

MT::TemplateMapオブジェクトは次のデータを格納します。これらのフィールドは、MT::Objectの標準的なデータ・アクセス用メソッドで参照あるいは設定できます。

id

テンプレート・マッピング・レコードのIDです。

blog_id

テンプレート・マッピング・レコードが関連付けられたブログのIDです。

template_id

テンプレートのIDです。

archive_type

アーカイブの種類です。"Individual"、"Daily"、"Weekly"、"Monthly"、"Category"のいずれかでなければなりません。

file_template

マッピングで指定されているアーカイブ・テンプレート・ファイルです。該当する種類のアーカイブのテンプレートから、テンプレート・タグを使って生成される出力ファイルを定義するものです。

is_preferred

このテンプレートが、同じ種類のアーカイブに登録されている他のテンプレートよりも優先するかどうかを指定するブーリアン・フラグです。これは、アーカイブへのリンクを作成するときに利用されます。アーカイブへのリンクは、必ずパーマリンク先として指定された種類のアーカイブに対して張られます。

データの検索

テンプレート・マップ・レコードの検索では、IDによる検索の他、次のフィールドの任意の組み合わせによる検索やソートを行うことができます。詳細は、MT::Objectloadメソッドを参照してください。

MT::TemplateMap::removeMT::TemplateMapオブジェクトを削除すると、削除する$mapis_preferredフラグがtrueにセットされていて、かつ同じブログで他にも同じ種類のアーカイブに割り当てられたMT::TemplateMapオブジェクトがある場合、他のオブジェクトの中の最初のものが優先オブジェクトになり、そのオブジェクトのis_preferredフラグがtrueになります。


Copyright © 2001-2006 Six Apart, Ltd. All Rights Reserved.