開発(PHP):リソースに設定してある複数のテンプレート変数の情報を取得
リソースに設定してある複数のテンプレート変数の情報を取得するには、$modx->getTemplateVarsメソッドを使用します。
構文
戻り値 = $modx->getTemplateVars(変数IDまたは変数名, 取得する情報, リソースID, 公開/非公開, 並び替える基準, 順序);| 引数名 | 型 | 初期値 | 説明 | |
|---|---|---|---|---|
| 第一引数 | 変数IDまたは変数名 | array | '*' | 取得したいテンプレート変数またはリソース変数のIDまたは名前。 ' *'を指定すると割り当てられている全てのテンプレート変数およびリソース変数を取得する。array(3, 11)のように指定。 | 
| 第二引数 | 取得する情報 | string | '*' | 取得する情報のキー。 ' *'を指定すると全てを取得する。valueは必ず返すのでそれ以外を指定する。 | 
| 第三引数 | リソースID | integer | テンプレート変数の情報を取得する対象のリソース。 空を指定すると現在のリソースを対象とする。 | |
| 第四引数 | 公開/非公開 | integer | 1 | 対象のリソースが公開か非公開のどちらかの場合のみ取得する。 指定可能な値は次の通り。 0... 非公開1... 公開 | 
| 第五引数 | 並び替える基準 | string | 'rank' | 戻り値の配列の順序を変更することが可能で、基準となるテンプレート変数またはリソース変数を指定する。 カンマ区切りで複数指定することが可能。 | 
| 第六引数 | 順序 | string | 'ASC' | 第五引数'並び替える基準'で指定したリソース変数を基準に順序方向を指定する。 指定可能な値は次の通り。 ASC... 昇順DESC... 降順第五引数'並び替える基準'に合わせてカンマ区切りで複数指定することが可能。 | 
戻り値
取得に成功した場合は2次元配列、失敗した場合はfalseを返します。
						テンプレート変数とリソース変数で取得可能な情報が違います。
| キー | 説明 | 
|---|---|
| id | テンプレート変数のID。 | 
| type | "入力フォーム"で選択した値。 | 
| name | テンプレート変数の名称。 | 
| caption | "投稿画面内の見出し"のテキスト。 | 
| description | 説明文章。 | 
| editor_type | ※ 不明 | 
| category | 選択したカテゴリーのインデックス番号。 | 
| locked | ロックしているかどうか。 0 ... ロックしていない 1 ... ロック中 | 
| elements | 選択フィールドの全選択肢。 | 
| rank | 並び順。 | 
| display | "プロセッサ"で選択した値。 | 
| display_params | "プロセッサ"のURLパラメータ。 | 
| default_text | 既定値。 | 
| value | リソースに設定されている値。 | 
| キー | 説明 | 
|---|---|
| name | リソース変数の名称。 | 
| value | リソースに設定されている値。 | 
サンプルコード
$results = $modx->getTemplateVars('tel', 'group'); 
						