API: Стандарты SE v.4

Формат даты

dd	день
mm	месяц
mt	месяц текстом
ms	месяц текстом в именительном падеже
yyyy	год полный
yy	год короткий
g	приставка к году

Формат времени

H	час
i	минута
s	секунда

Пагинация

В SE4 доступны 2 вида пагинации:

Кнопка "Показать еще"	при нажатии на нее, подгружаются еще новости
При прокрутке страницы	работает аналогично первому варианту, но срабатывает при достижении скроллом точки загрузки

Валюты

В SE4 доступно 3 валюты (currency):

rouble	Российский рубль
dollar	Доллар США
euro	Евро

Для всех валют предусмотрен специальный CSS класс, для удобного отображения на сайте. Чтобы вывести валюту, достаточно прописать следующий HTML-код:

<span class="currency-CURRENCY_VALUE"></span>, где CURRENCY_VALUE - значение валюты в системе SE4

currency_position отвечает за расположение знака валюты. Есть всего 2 варианта расположения: слева (left) и справа (right). Принято, что Российский рубль располагается справа от цены, а Доллар США и Евро - слева, но Вы вправе ставить знаки как угодно.

Формат названия

В SE4 предусмотрено 2 формата названия товара, в зависимости от того, подставлять ли название бренда перед товаром (brand_name) или нет (name). Важно помнить, что данная опция влияет как на вывод товаров, так и на сортировку и поиск.

Фильтрация в SE4

SE4 позволяет фильтровать товары 7 разными фильтрами:

select	выпадающий список, используется в том случае, когда вариант может быть только один
radio	переключатель, используется в том случае, когда вариант может быть только один, но вместо выпадающего списка выводится переключатель
checkbox	фильтр "галочка", используется для фильтрации по признаку "да/нет" и когда вариантов можно выбрать не один, а несколько
from	фильтр для задания цифровых рамок "от" какого-либо значения
to	фильтр для задания цифровых рамок "до" какого-либо значения
price_from	фильтр для задания цены товара "от" (только для товаров)
price_to	фильтр для задания цены товара "до" (только для товаров)

Пример вызова метода с фильтрацией по всем параметрам:

$this->smartriver->catalog(['filters' => ['select' => [10 => 5], 'radio' => [11 => 7], 'checkbox' => [12 => 1], 'from' => [13 => 15], 'to' => [13 => 450], 'price_from' => 2990, 'price_to' => 4550]]);

$this->smartriver->catalog_part(['filters' => ['select' => [10 => 5], 'radio' => [11 => 7], 'checkbox' => [12 => 1], 'from' => [13 => 15], 'to' => [13 => 450]]]);

Получение цены

Возвращает отформатированную цену согласно настройкам сайта, принимает в качестве аргумента число типа float (или int).

Пример использования:

$this->smartriver->get_price(540);

Получение фото-заглушки и превью

Параметры запроса:

module	модуль, для которого используется функция
Тип	string
Возможные значения	news (новости, только для получения заглушки, превью для данного модуля недоступны), catalog (каталог) и module (универсальный модуль)
Значение по умолчанию	catalog

url	адрес изображения, для которого необходимо получить превью, если не передано, то в результате передается заглушка для модуля
Тип	string
Возможные значения	корректный url
Значение по умолчанию	нет

Пример простейшего запроса:

$this->smartriver->get_image();

Пример ответа:

Array

(

[image] => /images/catalog/GrvurpezIKLupzj9jCdF.svg

[preview] => /images/catalog/GrvurpezIKLupzj9jCdF.svg

)