8 вкладок настроек
| Вкладка | Что на ней настраивается |
|---|---|
| Основное | «Витрина и доступ из браузера» (адрес основной витрины, сайты, которым разрешены запросы); «Документация API и журнал» (кому открыт Swagger, журнал запросов); «SMS-коды»; «Картинки и файлы»; «Поиск»; «Фронтенд» (JSON-конфигурация витрины) |
| Пользователи | «Поля пользователя» (что можно менять в профиле, что принимать при регистрации, что отдавать в GET /api/user, группы при регистрации, срок хранения «просмотренных»); «Регистрация и удаление аккаунта» |
| Ключи и токены | «Карты и адреса» (Яндекс.Карты, DaData), «Защита форм» (reCAPTCHA), «Вход через Яндекс ID», «Вход через VK ID», «Loymax», «Битрикс24» |
| Магазин | «Каталог», «Цены и склады», «Скрытие товаров», «Оформление заказа» |
| Инфоблоки | состав ответа API по каждому инфоблоку: табы «Элементы», «Секции и фильтр», «Запись», «Кеш»; экспорт и импорт настроек в JSON |
| Местоположения | «Заполнение координат» через Геокодер Яндекса: язык, пауза, длительность порции, запуск с прогрессом |
| Кеширование | сроки 5 слоёв кеша, кнопки «Сбросить кеш API» и «Сбросить кеш инфоблока» |
| Модули | включение подмодулей |
На общих вкладках — 53 опции (без вкладки «Инфоблоки» и подмодулей). Секреты на вкладке «Ключи и токены» в форму не выводятся, а пустое поле не затирает сохранённое значение. Как выбрать поля ответа на вкладке «Инфоблоки» — в теме Состав ответа.
Вкладка «Магазин»
Перед тем как пользоваться методами магазина (раздел «Магазин» в документации Swagger), заполните вкладку «Магазин». Её разделы и опции:
- «Каталог» — «ID инфоблока каталога товаров» и «Восстанавливать фасетный индекс (после выгрузки из 1С и по крону)»;
- «Цены и склады» — «Типы цен каталога» и «Тип цены для фильтра и сортировки по цене»;
- «Скрытие товаров» — «Скрывать товары без цены», «Скрывать товары с нулевой ценой»;
- «Оформление заказа» — «Требовать авторизацию, если телефон уже зарегистрирован», «Минимальная сумма заказа», «Минимальная сумма для бесплатной доставки», «Максимальный вес заказа», «Плата за превышение веса заказа», «Город по умолчанию».
Вкладка «Кеширование»
Кеш REST API устроен слоями, у каждого свой срок в секундах (0 отключает слой): данные элементов, секции и количество, умный фильтр, цены и остатки, справочники. Кеш сбрасывается сам при изменении элементов, цен, остатков, свойств, секций и настроек. Для отдельного инфоблока слой можно отключить или задать свой срок — на вкладке «Инфоблоки», таб «Кеш» инфоблока; под каждым сроком на вкладке «Кеширование» перечислены такие инфоблоки.
Кнопки внизу вкладки: «Сбросить кеш API» (весь) и «Сбросить кеш инфоблока». Кеш компонентов сайта они не затрагивают. Подробно о слоях — в теме Кеш.
Маски хостов картинок
В списках сайтов можно использовать маски со звёздочкой.
Хосты для ресайза картинок (вкладка «Основное», «Сайты, с которых /api/image может брать внешние картинки», по хосту на строку, без схемы):
| Запись | Что разрешает |
|---|---|
cdn.example.ru | ровно этот хост |
*.example.ru | любой поддомен, но не сам example.ru |
Звёздочка — только целой меткой в начале хоста. Маски *, *.ru и *.com.ru настройки не сохранят. Хост сайта и хост папки UPLOAD разрешены всегда, адреса локальной сети запрещены всегда. Маски разрешённых сайтов для запросов из браузера (с указанием схемы и порта) — в теме Сессия и авторизация.
Подмодули на вкладке «Модули»
В модуль входят 5 подмодулей. Каждый включается и выключается по необходимости; после включения подмодуля его методы появляются в документации Swagger.
| Подмодуль | Что делает |
|---|---|
| Интеграция с Bitrix 24 | создаёт лиды в CRM Битрикс24 из форм обратной связи, в том числе с названием формы и кодом Roistat |
| Обратная связь | принимает формы обратной связи в инфоблок, отправляет почтовые уведомления |
| Программа лояльности Loymax | синхронизирует баллы внутреннего счёта с Loymax |
| Бонусная программа | начисляет и списывает бонусы на внутренний счёт по сумме заказа и условиям: тип и процент начисления, минимальная сумма, исключение категорий и товаров |
| Вход через соцсети | вход через Яндекс ID и VK ID |
Доступы Loymax и client_id приложений Яндекс ID и VK ID задаются на вкладке «Ключи и токены». Свой подмодуль проект добавляет без правки модуля — см. тему Подмодули.