« 目次

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

MT::Placement

概要

use MT::Placement;
my $place = MT::Placement->new;
$place->entry_id($entry->id);
$place->blog_id($entry->blog_id);
$place->category_id($cat->id);
$place->is_primary(1);
$place->save
    or die $place->errstr;

解説

MT::Placementオブジェクトは、エントリーとカテゴリーの1対1の対応(プレースメント)を表します。つまり、MT::Placementオブジェクトはエントリーからカテゴリーへの登録情報を記述したものです。各エントリーは1つのメイン・カテゴリーと、他の2次カテゴリー(いくつでもよい)に登録されており、その各々についてMT::Placementが存在することになります。エントリーからメイン・カテゴリーへの登録情報は、メイン・プレースメントとして標示されます。

利用方法

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

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

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

id

プレースメントを表すIDです。

entry_id

エントリーのIDです。

category_id

カテゴリーのIDです。

is_primary

登録情報が「メイン」プレースメントかどうか、つまりそのカテゴリーがそのエントリーのメイン・カテゴリーかどうかを示すブーリアン・フラグです。

データの検索

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


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