Общие настройки и виджет
Обновлено
Вкладка «Общие»
Путь: Магазин → Плагины → Регионы → Общие. После изменений нажмите «Сохранить».
| Настройка | Что делает | Значения |
|---|---|---|
| API-ключ DaData | Даёт доступ к определению города по IP и адресным подсказкам | Строка токена; по умолчанию пусто |
| Отключить автоопределение | Отключает автоматический запрос определения по IP | Включено / выключено; по умолчанию выключено |
Ключ получите в личном кабинете DaData и вставьте в «API-ключ DaData». Поле принимает токен, отдельного поля секретного ключа в плагине нет.
Без токена работают список городов, регион по умолчанию, склады и остальные возможности плагина; определения по IP и подсказок DaData не будет. «Отключить автоопределение» отключает именно определение по IP, а не поиск в вашем списке и не все запросы адресных подсказок.
Вкладка «Виджет»
Путь: Магазин → Плагины → Регионы → Виджет. Общие настройки и настройки этой вкладки сохраняются кнопкой «Сохранить».
Раздел «Виджет»
| Настройка | Что делает | Значения |
|---|---|---|
| Вывод виджета | Выбирает место подключения кнопки | «Через хук (автоматически)» — по умолчанию, через frontend_header; «Вручную по хелперу» — вызов в теме |
| Показывать поиск | Показывает поле поиска в выборе региона | Включено / выключено; по умолчанию включено |
| Заголовок окна | Текст в центральном окне и мобильной панели | До 120 символов; пусто — «Укажите свой город» |
| Подзаголовок окна | Дополнительный текст там же | До 255 символов; пусто — «От этого зависят наличие товаров, доставка и способы оплаты» |
Поиск фильтрует настроенные регионы по вхождению текста без учёта регистра. При заданном токене ввод от двух символов дополнительно вызывает подсказки городов DaData. Выбор подсказки работает через привязанные к региону коды; при отсутствии соответствия плагин сообщает, что доставка для региона не настроена.
Раздел «Первый визит»
| Настройка | Что делает | Значения |
|---|---|---|
| Подсказка города | Предлагает город по IP либо ручной выбор при первом визите | Включено / выключено; по умолчанию включено |
| Вид выбора на компьютере | Выбирает форму списка городов | «Выпадающий список (мало городов)» — по умолчанию; «Окно по центру (много городов)» |
| Подсказка на телефоне | Выбирает вид предложения региона на мобильных устройствах | «Выпадающий список (мало городов)»; «Нижняя панель» — по умолчанию; «Не показывать» |
Подпись «Подсказка города» относится к флагу предложения города при первом визите. Выбор города по кнопке остаётся доступен, даже когда предложение выключено. Значение «Не показывать» относится к мобильной подсказке первого визита.
Подсказка не показывается, если уже есть явный выбор в cookie или отметка о показанной подсказке. Отметка easyregions_notifier_shown хранится 30 дней. При успешном IP-определении покупатель подтверждает город; при отсутствии результата получает предложение выбрать регион.
Раздел «Оформление заказа»
| Настройка | Что делает | Значения |
|---|---|---|
| Автозаполнение адреса | Подставляет страну, регион, город и индекс в Checkout 2; с токеном включает подсказки города и улицы | Включено / выключено; по умолчанию выключено |
| Логотип DaData | Флаг «Скрывать логотип DaData в подсказках адреса» скрывает логотип в подсказках оформления | Включено / выключено; по умолчанию выключено |
| Регион по адресу | Переключает регион магазина, если введённый адрес соответствует другому настроенному региону | Включено / выключено; по умолчанию включено |
Для автозаполнения используются сохранённый населённый пункт покупателя, а при его отсутствии — переменная city или название региона. Индекс берётся из сохранённого адреса либо переменной zip. Страна и административный регион связаны с кодами карточки. Ключи city и zip нужно создать на вкладке «Переменные», если хотите задавать их сами.
Переключение по адресу ищет регион среди доступных текущей витрине по стране и коду региона. При смене региона страница перезагружается, чтобы применить склад, цены и ограничения способов. Изменение населённого пункта внутри того же региона сохраняет адрес без такой перезагрузки. При отсутствии сопоставления переключение не выполняется.
Подсказки города и улицы в оформлении рассчитаны на адреса России. Для них нужны токен и «Автозаполнение адреса». Перед скрытием логотипа сверьтесь с условиями своего тарифа DaData, как предлагает подсказка в интерфейсе.
Запросы DaData и кеш
В плагине нет поля лимита запросов DaData. Доступность сервиса зависит от вашего токена и условий DaData; фиксированную квоту плагин не задаёт.
Серверный ответ определения по IP кешируется на 24 часа для сочетания токена и IP. Кешируются и неудачные ответы. Адресные подсказки вызываются отдельно из браузера, этот серверный кеш к ним не относится.
Настройки карточек регионов описаны в статье о городах, а подключение к теме — в статье для разработчика.