getTemplateVar API Evolution CMS

Получение определенного дополнительного TV-параметра для документа

Замечание: Этот метод не работает при вызове из подключенного файла (include, include_once, require, require_once).

array getTemplateVar(string $idname[, string $fields[, int $docid[, int $published]]]);

$idname -TV-параметр
- название или идентификатор

$fields - список параметров, которые нужно возвращаться для дополнительных TV- параметров.
Список параметров через запятую * - возвращаться все параметры
По умолчанию: *

$docid - документ, для которого нужно получить TV-параметр
Идентификатор документа
По умолчанию: текущий дкоумент

$published - опубликованы ли документы
0 - документы не опубликованы
1 - документы опубликованы
По умолчанию: 1

Формат данных результата:

Array ( [id] => 4 
		[type] => text 
		[name] => МойПараметр 
		[caption] => Заголовок 
		[description] => Описание 
		[editor_type] => 0 
		[category] => 0 
		[locked] => 0 
		[elements] => Текст 
		[rank] => 0 
		[display] => 
		[display_params] => 
		[default_text] => 
		[value] => Это наша текущая страница 
	)

Пример

$txt = $modx->getTemplateVar('МойПараметр');
//вернет информацию по дополнительному параметру МойПараметр для текущего документа.

Источник Функции

Файл: manager/includes/document.parser.inc.php

Строка: 1812

function getTemplateVar($idname= "", $fields= "*", $docid= "", $published= 1) {
	if ($idname == "") {
		return false;
	} else {
		$result= $this->getTemplateVars(array ($idname), $fields, $docid, $published, "", ""); //remove sorting for speed
		return ($result != false) ? $result[0] : false;
	}
}