К содержимому
Начало работы

Установка и первые шаги

Обновлено

Установка

Установите «Регионы без поддоменов для Shop-Script» из маркета Webasyst в свою установку магазина. Перед установкой сверьте требования.

Откройте Магазин → Плагины → Регионы. На странице есть вкладки «Общие», «Регионы», «Переменные», «Виджет», «Импорт», «Как подключить».

Подготовьте склады и города

  1. В Shop-Script заведите склады, которые будут обслуживать города, и заполните остатки артикулов. Плагин выбирает существующие склады, а не создаёт их.
  2. Откройте Магазин → Плагины → Регионы → Регионы и нажмите кнопку с плюсом «Добавить регион».
  3. Заполните «Название» и выберите «Склад». Для первого запуска достаточно двух регионов с разными складами и контрольного товара с разными остатками.
  4. При необходимости отметьте «Видимые склады». Пустой выбор означает только основной склад.
  5. В «Витрины действия» выберите витрины, на которых должен появиться регион. Пустой выбор означает все витрины.
  6. В «Коды регионов» начните вводить название российского региона или код КЛАДР и выберите подсказку. Это привязка для определения города и работы с адресом.
  7. У одного региона включите «Регион по умолчанию (для всех неперечисленных кодов)» и нажмите «Сохранить».

Регион по умолчанию используется, когда нет подходящего сохранённого выбора покупателя. Он должен быть доступен на проверяемой витрине. Флаг единственный для всего плагина: назначение нового региона по умолчанию снимает его с прежнего.

Выведите выбор города

На вкладке Магазин → Плагины → Регионы → Виджет настройка «Вывод виджета» по умолчанию имеет значение «Через хук (автоматически)». Тема должна выводить frontend_header.

Для вывода в выбранном месте установите «Вручную по хелперу» и используйте код для темы. В теме Seller 2 предусмотрен элемент шапки «Плагин: Регионы без поддоменов»: включите его в настройках шапки, а в плагине выберите ручной вывод.

API-ключ DaData для первого запуска не обязателен. Без него покупатель выбирает город из списка. При необходимости добавьте ключ на вкладке «Общие» и настройте первый визит на вкладке «Виджет».

Проверка на витрине

  1. Откройте нужную витрину в новом приватном окне браузера.
  2. Проверьте название региона по умолчанию и откройте список городов.
  3. Выберите другой город: после успешного выбора страница перезагружается.
  4. Откройте контрольный товар и корзину. Сравните доступность с остатками выбранного склада и правилами Shop-Script.
  5. В Премиум дополнительно проверьте цену артикула и доступные способы в оформлении.
  6. Для Checkout 2 включите нужные настройки адреса и проверьте подстановку города, региона и индекса.

Если кнопки нет или наличие выглядит неожиданно, воспользуйтесь ответами на частые вопросы.