Эта функция возвращает набор объектов модуля mod в виде массива. Каждый его элемент в свою очередь представляет собой ассоциативный массив полей конкретного объекта. Ключами этого массива являются названия полей запрошенного типа NType. Объекты отбираются по записанному в синтаксисе SQL условию condition. Набор полей определяется параметром fields, а сортировка всего набора задается параметром sort. При вызове из шаблона Smarty результат оказывается в переменной с именем, которое задано в параметре var.

Параметры

string NType

Название типа возвращаемых объектов

string condition

Дополнительное условие отбора объектов (синтаксис SQL)

Значение по умолчанию: пустое условие.

mixed fields

Какие поля объектов возвращать

Значение по умолчанию: 3.

Варианты параметра:

int = 1

только общие поля объектов

int = 2

только дополнительные поля

int = 3

все поля

Значение по умолчанию.

string

список названий полей через запятую

array

массив названий полей

mixed linkDetail

Какие поля связанных объектов возвращать

Значение по умолчанию: 3.

Варианты параметра:

int = 1

только общие поля объектов

int = 2

только дополнительные поля

int = 3

все поля

Значение по умолчанию.

string

список названий полей через запятую

array

массив названий полей

string sort

Список полей, по которым сортируется набор.

string mod

Название модуля. См. также http://lib.solutecs.com/api/concept/show/438.htm

Значение по умолчанию: текущий модуль.

int limit

Ограничивает количество возвращаемых узлов.

string var

Название переменной, в которую возвращается результат

Используется только в шаблоне.

Примеры

Пример 2

Допустим, имеется модуль "магазин" (store), в котором определен список производителей (producer). Необходимо получить список всех производителей:

<?php
$producers = xs2GetNodes(array('NType' => 'producer'));
?>

Пример 3

Теперь получим тот же список, отсортированный по названию и усеченный до пяти первых элементов.

<?php
    $producers =
                  xs2GetNodes(array(
                                  'NType' => 'producer',
                                  'sort' => 'NName asc',
                                  'limit'=> 5));
?>

Пример 4

{xs2GetNodes
     var = "producers"
     NType = "producer"
     sort = "CDate desc"
     condition = "NName LIKE '%Бобруйск%'"}

Такой вызов в шаблоне Smarty вернет в переменную $producers все объекты типа "producer", которые содержат подстроку "Бобруйск" в поле NName. Результат отсортируется по дате создания в порядке убывания.

Пример 5

{xs2GetNodes
    var = "producers"
    NType = "producer"
    sort = "MDate"
    fields = "NName, Country"
    linkDetail = "NName"
    mod = "store"}

Такой вызов в шаблоне Smarty вернет в переменную $producers все объекты типа "producer", отсортированные по дате последнего изменения (MDate). При этом для каждого объекта в наборе вернутся только поля NodId, NName и Country, а для каждого объекта типа "страна" из поля Country вернутся только значения поля NodId и NName.

Следующий код отображает страну для каждого производителя:

{foreach from=$producers item="producer"}
{$producer.NName} - {$producer.Country[0].NName}
<br />
{/foreach}