Определение города — весь мир

«Определение города — весь мир» добавляет на витрину Shop-Script выбор города, определение по IP и геолокацию по запросу покупателя.

Новое в версии 1.2.2

8 настроек цвета: основной и второстепенный текст, акцент, наведение, границы, фон выбранного города, фон окна и текст кнопок.

55 поддерживаемых стран с отдельными флажками включения. По умолчанию включена Россия.

14 языков интерфейса с независимым включением в админке. По умолчанию русский. Переключатель языка в окне покупателя убран.

До 10 популярных городов разрешённых стран. Для России: Москва, Санкт-Петербург, Новосибирск, Екатеринбург, Казань, Нижний Новгород, Красноярск, Челябинск, Самара и Уфа.

Компактная кнопка города без стрелки и адаптивное окно для компьютера и телефона.

Ограничение стран учитывается в списке, поиске, сохранённом выборе и автоопределении.

Как работает выбор города

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

Настройки стран и языков

Откройте «Shop-Script → Плагины → Определение города — весь мир». Включите нужные страны и языки, задайте город по умолчанию и цвета. Страны и языки настраиваются независимо. При выключении всех стран или всех языков виджет скрывается. Язык интерфейса выбирается по языку витрины и настройке по умолчанию. Встроенные названия городов и стран отображаются на русском, ручной ввод не переводится. Существующие настройки языков сохраняются при обновлении.

Доступны русский, английский, итальянский, армянский, белорусский, казахский, кыргызский, таджикский, узбекский, азербайджанский, румынский, украинский, грузинский и туркменский языки интерфейса.

Подключение к теме

Вставьте в нужное место шаблона внутри body:

{shopFilaretecityPlugin::widget()}

Код сам подключает стили и скрипт. При отдельном мобильном шаблоне повторите вставку в нём. Отключите «Автоматический вывод», если при ручной вставке появились дополнительные кнопки. Альтернатива — автоматическое размещение по CSS-селекторам вашей темы. Перед удалением плагина удалите вызов из шаблонов. Список доменов позволяет ограничить работу определёнными витринами; пустое поле разрешает все витрины.

Геолокация и интеграции

Автоопределение по IP использует публичный HTTPS API BigDataCloud и отключается в настройках. Геолокация устройства запускается по нажатию покупателя, требует его разрешения и HTTPS. Доступность и точность зависят от браузера и внешнего сервиса.

JavaScript API FilareteCity и событие citychange предназначены для интеграции с доставкой, ценами и контентом. Такая интеграция настраивается отдельно: плагин сам не рассчитывает доставку и не меняет цены.

Совместимость: Shop-Script, Webasyst 2, PHP 7.4 и новее. Размещение блока зависит от шаблона темы.

Пошаговая настройка после установки

Установите плагин через «Инсталлер» Webasyst и откройте «Shop-Script → Плагины → Определение города — весь мир».

Включите плагин. Укажите домены витрин, на которых он должен работать; пустой список разрешает все витрины.

Выберите способ размещения: автоматический вывод по CSS-селекторам темы или ручная вставка кода {shopFilaretecityPlugin::widget()} внутри body шаблона. При ручной вставке отключите автоматический вывод, чтобы избежать повторных кнопок.

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

Отметьте поддерживаемые языки и выберите язык по умолчанию. Чтобы всегда показывать один язык, оставьте включённым только его. При нескольких языках учитывается язык витрины. Названия встроенных городов и стран остаются на русском.

Выберите цвета текста, акцента, наведения, границ, выбранного города, фона окна и текста кнопок — всего 8 параметров.

При необходимости включите определение по IP. Для геолокации устройства витрина должна работать по HTTPS; браузер запросит разрешение у покупателя.

Нажмите «Сохранить», обновите витрину и откройте окно выбора города. Проверьте список популярных городов, поиск и сохранение выбора на компьютере и телефоне.

Если кнопка не появилась, проверьте включение плагина, домен витрины, наличие хотя бы одной разрешённой страны и языка, а также место вставки виджета или CSS-селектор автоматического вывода. При сохранении старого оформления обновите страницу без кеша.

Примеры оформления на скриншотах: русский с синим акцентом, мобильное окно, английский с зелёным, итальянский с фиолетовым, армянский с золотистым, казахский с бирюзовым и русский с розовым. Все варианты настраиваются в плагине.