Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 12.2.1Начало работы с модулем 12.2.2Язык запросов 12.2.3Способы хранения индекса 12.2.4Интерфейс модуля в панели управления сайтом 12.2.5Области индексирования 12.2.6Области HTML-страниц 12.2.7Области поиска на сайте 12.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 12.2.9Правила индексирования 12.2.10Постановка задачи переиндексирования в очередь 12.2.11Интеграция модуля в макеты дизайна сайта 12.2.12Простая форма поиска 12.2.13Расширенная форма поиска 12.2.14Вывод результатов поиска 12.2.15Стилизация списка подсказок 12.2.16Расширенные настройки 12.2.17Разработка расширений модуля 12.2.18Обзор архитектуры модуля 12.2.19Обработчики документов различных типов 12.2.20Текстовые фильтры 12.2.21Анализаторы текста 12.2.22Корректировщики запросов 12.2.23Подключение других поисковых систем 12.2.24Решение проблем с поиском 12.2.25Решение проблем с индексированием 12.2.26Справочник API

Коллекции объектов

nc_netshop_item_collection

В корзине ($netshop->get_cart_contents() или $netshop->cart->get_items()) и в заказе ($order->get_items()) список товаров представлен в виде коллекции nc_netshop_item_collection.

Коллекция (наследуется от nc_record_collection) реализует интерфейсы Iterator, ArrayAccess, Countable:

$collection = $order->get_items();
$number_of_items = count($collection);
foreach ($collection as $item) {
    echo $item['Name'];
}
$index = "300:11"; // по умолчанию ключом в коллекции является строка, составленная из ID компонента и ID объекта
echo $collection[$index]['ItemPrice'];

Некоторые методы коллекции, которые могут быть полезны:

Метод Описание
$coll->get_field_sum($property) Сумма значений по указанному свойству товаров с учётом количества (∑ Field × Qty)
Следующие методы доступны для всех коллекций nc_record_collection:
$coll->where($option_or_method, $value, 
$comparison_operator = '==', 
array $method_arguments = null)

Создаст новую коллекцию, в которой у всех элементов:
(а) offset $option_or_method равен $value (вместо сравнения можно указать другой оператор), или
(б) результат выполнения метода $option_or_method с указанными аргументами совпадает с указанным значением

$coll->where_all(array $conditions)

Вернёт новую коллекцию, в которой элементы удовлетворяют всем условиям $conditions.
$conditions — многомерный массив с условиями в том же порядке, что и для where(), например:

$collection->where_all(array(
    array('site_id', 1), 
    array('comment_count', 1, '>=')
));
$coll->first($option_or_method = null, $value = null, $comparison_operator = '==', array $method_arguments = null)

Если вызван без параметров — вернёт первый элемент.

Если вызван с параметрами — аналогично методу where()

$coll->any($option_or_method, $value, 
$comparison_operator = '==', array $method_arguments = null)
Вернёт истину, если хоть у одного элемента коллекции значение или результат выполнения метода совпадает с указанным значением
$coll->all($option_or_method, $value, 
$comparison_operator = '==', array $method_arguments = null)
Вернёт истину, если у всех элементов коллекции значение или результат выполнения метода совпадает с указанным значением
$coll->sum($property)

Сумма значений по указанному свойству элементов коллекции. Например:

$cart->get_items()->sum('TotalPrice')  — стоимость всех товаров в корзине (со скидкой)

$coll->min($property), $coll->max($property) Минимальное / максимальное значение свойства
$coll->set_index_option($property) Переиндексировать коллекцию по указанному свойству (должно быть уникальным, иначе элементы коллекции могут быть потеряны).

Комментарии 4

Уточните, пожалуйста, какое маркетинговое применение может быть у коллекций объектов?
Может ли этот функционал пригодиться, например, для реализации комплементарных товаров (покупают кофеварку - продаем заодно еще кофе или фильтры), или же данный функционал не подойдет для этого?
   
Кирилл Хряпин NetCat 23 июня 2014, 20:24:33
Информация о коллекциях объектов приведена в документации для «продвинутых» пользователей, чтобы показать дополнительные возможности по работе с корзиной, составом заказа и списком вариантов товара (это те места, где коллекции объектов используются в модуле «Интернет-магазин»).

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

В целом коллекции по большому счёту заменяют собой массивы с записями об объектах, предоставляя дополнительные возможности для работы с такими списками. Для конкретного приведённого вами примера (список «покупают также») эта функциональность вряд ли будет центральной. Использовать nc_netshop_item_collection будет целесообразно, если вам нужны дополнительные возможности по работе со списком товаров.
   
Спасибо за Ваш ответ! Теперь внимательно почитал - и понял, что коллекции объектов - это просто "запчасть" от штаногого функционала ИМ (в частности, системы скидок), предназначенная для работы с содержимым корзины и с содержимым заказа, но не для комплектов товаров.

p.s. Было бы здорово реализовать также функционал для работы с комплектами товаров :)
   
Nexwich  Панасин Александр 21 июля 2014, 15:51:28
Как собрать коллекцию по параметрам "OrderParameters"?
   
Описание проекта