API: Стандарты SE v.4
Формат даты
dd |
день |
mm |
месяц |
mt |
месяц текстом |
ms |
месяц текстом в именительном падеже |
yyyy |
год полный |
yy |
год короткий |
g |
приставка к году |
Формат времени
Пагинация
В SE4 доступны 2 вида пагинации:
Кнопка "Показать еще" |
при нажатии на нее, подгружаются еще новости |
При прокрутке страницы |
работает аналогично первому варианту, но срабатывает при достижении скроллом точки загрузки |
Валюты
В SE4 доступно 3 валюты:
rouble |
Российский рубль |
dollar |
Доллар США |
euro |
Евро |
Получение цены
Возвращает отформатированную цену в выбранной валюте согласно настройкам сайта, принимает в качестве аргумента число типа float (или int).
Пример использования:
$this->smartriver->get_price(540);
Формат названия
В 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]]]);
Получение фото-заглушки и превью
Параметры запроса:
module |
модуль, для которого используется функция |
Тип |
string |
Возможные значения
|
news (новости, только для получения заглушки, превью для данного модуля недоступны), catalog (каталог) и module (универсальный модуль) |
Значение по умолчанию |
catalog |
url |
адрес изображения, для которого необходимо получить превью, если не передано, то в результате передается заглушка для модуля |
Тип |
string |
Возможные значения
|
корректный url |
Значение по умолчанию |
нет |
Пример простейшего запроса:
$this->smartriver->get_image();
Пример ответа:
Array
(
[image] => /images/catalog/GrvurpezIKLupzj9jCdF.svg
[preview] => /images/catalog/GrvurpezIKLupzj9jCdF.svg
)