Компоненты товаров

В Интернет-магазине, разработанном с использованием системы управления сайтами NetCat, может быть представлено неограниченное количество различных типов товаров. Каждый компонент типа товара может иметь свой набор свойств, однако обязательно должен содержать следующие поля:

• Name: название товара
• Vendor: Производитель
• ItemID: внешний идентификатор товара
• Price: основная цена товара
• Currency: валюта основной цены товара (содержит значения из списка ShopCurrency)
• ImportSourceID: служебное поле, используется при импорте данных из внешних источников (например 1С)
• Units: Единицы измерения (содержит значения из списка ShopUnits)
• StockUnits: Количество товара на складе
• VAT: Ставка НДС

Использование существующего компонента

Создайте новый раздел и прикрепите к нему один из существующих в вашей системе компонентов

После прикрепления компонента раздел можно наполнять.

Если для ваших товаров нужен компонент с уникальными полями (характеристиками товара), создайте новый компонент на основе существующего компонента «Товар 2.0», при этом мы советуем не удалять поля, которые перечислены выше.

После копирования компонента можно добавить нужные поля.

Повторите операцию для нового типа товаров.

В любых компонентах или макетах дизайна, в которых используется модуль интернет-магазина, в первую очередь нужно получить объект магазина:

$netshop = nc_netshop::get_instance();

Это можно делать как в макете дизайна, так и в отдельных компонентах.

Отображение товара

Для доступа к свойствам товаров существует класс nc_netshop_item.

В списке товаров необходимо создать объект:

$item = new nc_netshop_item($res[$f_RowNum]);

На странице объекта:

$item = new nc_netshop_item($resMsg);

Также объект можно создать по ID записи в таблице Message.

Для создания объекта минимально должны быть заданы Class_ID (или Sub_Class_ID) и Message_ID, все остальные данные объект загрузит при необходимости из БД. В шаблонах, как правило, вся нужная информация уже загружена. Пример создания nc_netshop_item по ID компонента и ID объекта:

$item = new nc_netshop_item(array('Class_ID' => 300, 'Message_ID' => 5));
echo $item['ItemPrice']; // загрузит необходимые данные и выдаст значение

Свойства объекта nc_netshop_item

nc_netshop_item реализует интерфейс ArrayAccess, доступ к свойствам — как к обычному массиву.

Например:

• $item['ItemPrice'] — стоимость товара
• $item['Weight'] — вес товара и т. д.

Методы объекта nc_netshop_item

$item->get_field_total($field)

Возвращает произведение значения указанного свойства ($field) и количества (Qty)

nc_netshop_item и варианты товаров

Для вариантов товаров (т.е. для записей, у которых задан Parent_Message_ID) класс обеспечивает также «наследование» свойств: если какое-то свойство не задано у варианта, его значение будет равно значению этого свойства у родительского товара.

Некоторые детали внутренней реализации

При присвоении ранее существовавшего значения новой переменной PHP не копирует данные в памяти, а создаёт ссылку на значение. Старое значение копируется в памяти только после изменения новой переменной. Из этих соображений, чтобы избежать двойной копии данных в памяти (один — полученный в nc_object_list массив $res, второй — в nc_netshop_item) внутри объекта есть два свойства: $item_data (оригинальные данные) и $additional_data (дополнительные значения, такие как вычисленные значения).

Поэтому, если возникла необходимость добавить в nc_netshop_item какие-то данные помимо данных из $res, имеет смысл установить additional_data вместо модификации оригинальных данных:

$item = new nc_netshop_item($res[$f_RowNum], array('SomeExtraData' => 123));

Все вычисляемые свойства вычисляются при первом обращении и кэшируются в свойстве $additional_data. Все методы, вычисляющие значения (get_*) не кэшируют значения, поэтому внутри класса всегда стоит обращаться к свойствам через ArrayInterface (например, $item['ItemPrice']).

Добавить в корзину

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

<form method="post" action="<?= nc_modules("netshop")->get_add_to_cart_url() ?>">
    <input type="hidden" name="redirect_url" value="<?= nc_message_link($item['Message_ID'], $item['Class_ID']) ?>"/>
    <input type="hidden" name="cart_mode" value="add"/>
    <input type="hidden" name="cart<?= $item["RowID"] ?>" value="1"/>
    <button type="submit">В корзину</button>
</form>