このプラグインは、MySQLの他のデータベースのデータをMTタグを通じて取得し、MTテンプレートの中で利用できるようにします。
インストール
事前準備
cpanもしくは、cpanmでDBIx::Class、DBIx::Class::Schema::Loaderをインストールしてください。
$ cpanm DBIx::Class
$ cpanm DBIx::Class::Schema::Loader
インストール
本パッケージに含まれる「plugins」ディレクトリ内のディレクトリ「AnotherDatabase」を、Movable Typeインストールディレクトリの「plugins」ディレクトリの下にコピーしてください。
作業後、Movable Typeのシステム・メニューのプラグイン管理画面を表示し、プラグインの一覧に「AnotherDatabase」が表示されていることを確認してください。
使い方
初期設定
mt-config.cgiに下記の項目を追記します。
ADBObjectDriver dbi:mysql
ADBDatabase database name
ADBDBUser database username
ADBDBPassword database password
ADBDBHost hostname
MTタグ
AnotherDatabase (ブロックタグ)
データベースへのアクセスを初期化します。オプションを定義することで、複数のデータベースを利用することが可能です。
モディファイヤ
objectdriver_key (default: adbobjectdriver)
- mt-config.cgiに記述した変数名を指定します。
database_key (default: adbdatabase)
- mt-config.cgiに記述した変数名を指定します。
dbhost_key (default: adbdbuser)
- mt-config.cgiに記述した変数名を指定します。
dbuser_key (default: adbdbpassword)
- mt-config.cgiに記述した変数名を指定します。
dbpassword_key (default: adbdbhost)
- mt-config.cgiに記述した変数名を指定します。
dbencode (default: adbdbencode)
- mt-config.cgiに記述した変数名を指定します。
AnotherDatabaseTable (ブロックタグ)
AnotherDatabaseタグのブロック内でのみ利用できます。データベースのテーブルの各行を呼び出します。
モディファイヤ
- column
- フィルタの対象とするcolumnを指定します。
- method
- フィルタのメソッドを定義します。一般的なsql文のwhere句で利用される比較演算子が利用できます。
- 演算子の例
- =
- !=
- >
- <
- >=
- <=
- like
- between
- values
- methodで使用する値を定義します。
- 数値、文字列、配列が利用できます。(配列の場合は、”,”(カンマ)で区切ります。)
- like演算子の場合は、sql文で使用される文字列の定義の方法が利用できます。
- 例えば、文中に語句がある場合は、”%語句%”というような形になります。
- between演算子の場合は、必ず2要素からなる配列を設定します。
- sort_by
- ソートに使用するcolumn名を指定します。
- sortorder = “{ascend | descend}”
- sort
- 表示するページを指定します。
- 1ページ当たりの行数を指定します。
AnotherDatabaseColumn (ファンクションタグ)
AnotherDatabaseTableタグのブロック内でのみ利用できます。AnotherDatabaseTableで呼び出されたデータベースの各行の各カラムを出力します。
モディファイヤ
- column
- 出力するカラム名を指定します。
- encode
- latin1のデータベースにutf8で保存されてしまっている場合、このモディファイヤにbinaryと指定します。
例
<mt:Anotherdatabase>
<mt:AnotherDatabaseTable table="tablename"
column = "id"
method = "="
value = "1,3,5"
sort_by="modified_datetime"
sort_order="descend"
page="1"
rows="4">
<$mt:AnotherDatabaseColumn column="id"$>
<$mt:AnotherDatabaseColumn column="name"$><br />
</mt:AnotherDatabaseTable>
</mt:Anotherdatabase>
必要条件
DBIx::Class DBIx::Class::Schema::Loader
互換性
MT5.0,MT5.1,MT5.2,MT6.0,MT6.1,MT6.2,MT6.3
License
MIT
MTを一緒にもっと便利にしませんか?
Movable Type は多機能で柔軟性の高い CMS として 10 年以上親しまれています。このシステムを活用して多くの開発者やデザイナーがプラグインやテーマを設計・共有しています。
ぜひあなたの力作をディレクトリに登録してみませんか?