Показ цен

Описание и список функций

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

GetCatalogGroups

CDBResult
GetCatalogGroups(
	string by,
	string order
);

Функция возвращает список типов цен, отсортированный по полю by в порядке order.

Параметры функции

Возвращаемые значения

Упорядоченный набор записей типа CDBResult, каждая из которых имеет следующую структуру:

GetCatalogGroup

array
GetCatalogGroup(
	int CATALOG_GROUP_ID
);

Функция возвращает тип цены кодом CATALOG_GROUP_ID.

Параметры функции

Возвращаемые значения

Массив той же структуры, что и каждая запись набора, возвращаемого функцией CDBResult GetCatalogGroups(string by, string order).

GetCatalogProductPrice

array
GetCatalogProductPrice(
	int PRODUCT_ID,
	int CATALOG_GROUP_ID
);

Функция возвращает цену типа CATALOG_GROUP_ID для товара с кодом PRODUCT_ID.

Параметры функции

Возвращаемые значения

Массив следующей структуры:

GetCatalogProductPriceList

array
GetCatalogProductPriceList(
	int PRODUCT_ID,
	string by,
	string order
);

Функция возвращает массив цен для товара PRODUCT_ID, отсортированый по полю by в порядке order.

Параметры функции

Возвращаемые значения

Массив, каждый элемент которого является массивом той же структуры, что и массив, возвращаемый функцией array GetCatalogProductPrice(int PRODUCT_ID,
 int CATALOG_GROUP_ID)

GetCatalogProduct

array
GetCatalogProduct(
	int PRODUCT_ID
);

Функция возвращает товар с кодом PRODUCT_ID.

Параметры функции

Возвращаемые значения

Массив следующей структуры:

FormatCurrency

string
FormatCurrency(
	double PRICE,
	string CURRENCY
);

Функция форматирует число (цену) PRICE в соответствии с форматом, заданным для валюты CURRENCY.

Параметры функции

Возвращаемое значение

Строка с числом (ценой), отформатированным в соответствии с форматом валюты.

Примеры использования функций торгового каталога

<?
// Вывод типов цен, доступных для просмотра 
// для данного посетителя
$db_res = GetCatalogGroups(($b="SORT"), ($o="ASC"));
while ($res = $db_res->Fetch())
{
	if ($res["CAN_ACCESS"]=="Y")
	{
		echo $res["NAME_LANG"];
	}
}
?>

<?
// Вывод цены типа $TYPE_ID для товара $PRODUCT_ID
$arProduct = GetCatalogProduct($PRODUCT_ID);
if ($res = GetCatalogProductPrice($PRODUCT_ID, $TYPE_ID))
{
	if ($res["CAN_ACCESS"]=="Y")
	{
		echo FormatCurrency($res["PRICE"], $res["CURRENCY"]);
		echo " (цена типа ".$res["CATALOG_GROUP_NAME"].") ";
		// Если данному посетителю товар $PRODUCT_ID доступен 
		// для покупки по цене типа $TYPE_ID и либо товар ещё
		// есть, либо его количество не отслеживается, то
		// можно вывести приглашение к покупке
		if ($res["CAN_BUY"]=="Y" && (IntVal($arProduct["QUANTITY"])>0 || $arProduct["QUANTITY_TRACE"]!="Y"))
		{
			echo "Можно купить";
		}
	}
}
?>

<?
// Вывод списка доступных для просмотра цен товара $PRODUCT_ID
$arProduct = GetCatalogProduct($PRODUCT_ID);
$arPrice = GetCatalogProductPriceList($PRODUCT_ID, "SORT", "ASC");
$bCanBuy = False;
for ($i = 0; $i<count($arPrice); $i++)
{
	if ($arPrice[$i]["CAN_ACCESS"]=="Y")
	{
		if ($arPrice[$i]["CAN_BUY"]=="Y" && (IntVal($arProduct["QUANTITY"])>0 || $arProduct["QUANTITY_TRACE"]!="Y"))
			$bCanBuy = True;
		echo $arPrice[$i]["CATALOG_GROUP_NAME"].": ";
		echo FormatCurrency($arPrice[$i]["PRICE"], $arPrice[$i]["CURRENCY"])."<br>";
	}
}
// Если среди цен данного товара были цены, которые доступны
// данному посетителю для покупки и либо товар ещё
// есть, либо его количество не отслеживается, то
// можно вывести приглашение к покупке
if ($bCanBuy)
{
	echo "Можно купить";
}
?>