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

)

totop