Welcome !! Now 2008.07.25 16:32 (JST)

テンプレート変数について(概要)

[ 基礎知識 ]

テンプレート変数には、あらかじめ定められた変数(ドキュメント変数)と、ユーザが独自に作成できるカスタムテンプレート変数の2つのタイプがあります。これらはドキュメントやテンプレートの中で「変数タグ([*変数名*])」を記述することによってそれらの値を呼び出したり、またはその値を直接プログラムの内部処理に利用したりできます。

ドキュメント変数

ドキュメント変数とは、ドキュメントが持つ様々な属性を指し、非常にたくさんの項目が存在します。それらのうちの多くはプログラムの中で利用されるものが多いのですが、以下にあげる項目のように直接ドキュメントやテンプレートの中で利用できるものも存在します。

  • pagetitle…ドキュメントのページタイトル
  • longtitle…ドキュメントの長いタイトル
  • description…ドキュメントの説明
  • introtext…ドキュメントの要約
  • content…ドキュメントの内容
  • alias…ドキュメントのエイリアス
  • id…ドキュメントのID
  • createdon…ドキュメントの作成日
  • pub_date…ドキュメントの公開日
  • editedon…ドキュメントの最終更新日

※その他は本家ドキュメント:ドキュメント変数のページを参照※

※尚、上記のうち「createdon」「pub_date」「editedon」で出力されるデータは、日付連番?なので、ちゃんとした日付の形式として出力する場合には、DateTemeJPなどを利用します※

カスタムテンプレート変数

管理画面でユーザが独自に作成できるテンプレート変数のことをカスタムテンプレート変数と呼びます。

※MODxでは、カスタムテンプレート変数のことを単に「テンプレート変数」と呼ぶこともあります※

作成したカスタムテンプレート変数は、テンプレートごとにアサインして利用します。ドキュメントで、カスタムテンプレート変数がアサインされたテンプレートを選択すると、カスタムテンプレート変数を利用することができます。

カスタムテンプレート変数を使うと、実に様々なことが可能になります。作り方も含め、いずれ解説していきます(←いつ?(笑))。

△ページトップ