- Быстрый старт
- Особенности
- Установка
- Описание
- Сниппет UserLocation.initialize
- Параметры
- Сниппет UserLocation.location
- Параметры
- Модификаторы феном
- getUserLocation
- detectUserLocation
- Пример вызова
- Управление локациями в админке
- Импорт / Экспорт локаций
- Геолокация пользователя
- Примечание
- [UserLocation] — Геолокация и выбор города пользователя
- cityFields. Города, информация и цены для каждого
- Список городов и управление им
- Уникальная информация для каждого города
- Управление ценами товаров
- UserLocation
- mspPayAnyWay
- mspPayin
- msJDE
- CitySelect
- msFavorites
- msOptionsColor
- msCategoryOptions
Быстрый старт
Компонент реализует выбор города пользователя.
Попробовать пакет перед покупкой можно на modhost.pro.
Особенности
- определение локации пользователя по ip
- готовая база городов и регионов России, возможность импорта/ экспорта своих локаций
Установка
- [Подключите наш репозиторий][002]
- Установите UserLocation
- Импортируйте файл локаций
Попробовать пакет перед покупкой можно на modhost.pro, на нём эти дополнения можно выбрать прямо при создании сайта.
Описание
Компонент UserLocation позволяет определить локацию пользователя и вывести список доступных локаций
Сниппет UserLocation.initialize
Подключает необходимые скрипты и стили. Вызвать в любом удобном месте.
Параметры
Параметр | По умолчанию | Описание |
---|---|---|
frontCss | Файл с css стилями для подключения на фронтенде | |
frontJs | Файл с javascript для подключения на фронтенде | |
actionUrl | [[+assetsUrl]]action.php | Коннектор для обработки ajax запросов |
Сниппет UserLocation.location
Получает список локаций
Параметры
Параметр | По умолчанию | Описание |
---|---|---|
tpl | UserLocation.locations | Имя чанка для оформления |
sortby | name | Поле для сортировки |
sortdir | ASC | Направление сортировки |
limit | 300 | Лимит выборки |
toPlaceholder | Не выводить результат работы сниппета, а поместить в плейсхолдер toPlaceholder | |
type | city | Тип объекта |
Модификаторы феном
getUserLocation
Получает текущую локацию пользователя
detectUserLocation
Получает текущую локацию пользователя по его ip
Пример вызова
Текущая локация пользователя
Поповер с выбором локации
Инпут с выбором локации
Вывод соседних локаци
Управление локациями в админке
Таблица управления локациями представлена в виде виджета
Импорт / Экспорт локаций
Доступен импорт/ экспорт локаций в формате csv
Геолокация пользователя
Из коробки доступны следующие классы определения локации пользователя по ip
- ulDetectLocationByIpGeoBase — включен по умолчанию
- ulDetectLocationBySypexGeo
- ulDetectLocationByDaData
Используемый класс геолокации можно указать в настройке ulMethodDetectLocation
Наиболее точный класс ulDetectLocationByDaData , однако он требует указания токена сервиса ДаДата
Примечание
После установки пакета необходимо импортировать файл локаций. Локации городов и регионов Росии находится в папке core/components/userlocation/elements/locations/locations.csv
По умолчанию активны крупные города России, вы можете активировать/ деактивировать нужные вам города
Источник
[UserLocation] — Геолокация и выбор города пользователя
Компонент [UserLocation] позволяет определить локацию пользователя и вывести список доступных локаций.
Особенности
— определение локации пользователя по ip
— готовая база городов и регионов России, возможность импорта/ экспорта своих локаций
— в отличие от CitySelect оперирует локациями созданными в базе данных. Позволяет добавить/ изменить нужную локацию под себя.
Установка
— Подключите наш репозиторий
— Установите UserLocation
— Импортируйте файл локаций
Сниппет UserLocation.initialize
Подключает необходимые скрипты и стили. Вызвать в любом удобном месте.
Сниппет UserLocation.location
Получает список локаций
Модификаторы феном
— getUserLocation — получает текущую локацию пользователя
— detectUserLocation — получает текущую локацию пользователя по его ip
Пример вызова, текущая локация пользователя
Пример вызова, поповер с выбором локации
Пример вызова, инпут с выбором локации
Вывод соседних локаций
Управление локациями в админке
Таблица управления локациями представлена в виде виджета
Доступен импорт/ экспорт локаций в формате csv
Из коробки доступны следующие классы определения локации пользователя по ip
— ulDetectLocationByIpGeoBase — включен по умолчанию
— ulDetectLocationBySypexGeo
— ulDetectLocationByDaData
Используемый класс геолокации можно указать в настройке ulMethodDetectLocation
Наиболее точный класс ulDetectLocationByDaData, однако он требует регистрации и указания токена сервиса ДаДата
Примечание
По умолчанию активны крупные города России, вы можете активировать/ деактивировать нужные вам города
Файл локации городов и регионов Росии находится в папке
Источник
cityFields. Города, информация и цены для каждого
Список городов и управление им
У компонента имеется страница, на которой вы можете управлять списком городов, добавлять, изменять и удалять их, а также включать и отключать города.
Для вывода списка городов с возможностью переключаться между ними достаточно просто вызвать сниппет:
Уникальная информация для каждого города
На той же странице находится вкладка «Данные» для управления информацией для каждого города. Для вывода уникальной информации в компоненте используются несколько методов.
Во-первых, по умолчанию включена запись полей в плейсхолдеры, которые имеют префикс. И для вывода информации достаточно добавить в ваши чанки или шаблоны необходимый плейсходер, но главное — вызвать его не кешируемым. Например, так:
Во-вторых, плейсхолдеры записываются при загрузке страницы, что может тормозить систему в некоторых случаях. Поэтому я добавил возможность отключить запись полей в плейсхолдеры. В этом случае для вывода информации для каждого города нужно вызвать сниппет cfField с нужным ключом:
Управление ценами товаров
Для управления ценами на странице редактирования товара добавляется новая вкладка «Город — Цена». В ней вы найдете таблицу, где сможете указывать цену товара в зависимости от города. Если для какого-то города цена не указана, то будет браться его цена по умолчанию.
После того, как вы добавите цену для города, и обновите кеш, вы увидите новую цену, а рядом с ней старую, если вывод старых цен у вас настроен. Дополнительно ничего настраивать и выводить не нужно.
Источник
UserLocation
mspPayAnyWay
Интеграция с платежным сервисом PayAnyWay
mspPayin
Интеграция с платежным сервисом Payin-Payout.net
msJDE
Расчет доставки ТК «ЖелДорЭкспедиция».
Компонент UserLocation позволяет определить локацию пользователя и вывести список доступных локаций
— определение локации пользователя по ip
— готовая база городов и регионов России, возможность импорта/ экспорта своих локаций
— в отличие от CitySelect оперирует локациями созданными в базе данных. Позволяет добавить/ изменить нужную локацию под себя.
Установка
— Подключите наш репозиторий
— Установите UserLocation
— Импортируйте файл локаций
Подключает необходимые скрипты и стили. Вызвать в любом удобном месте.
Получает список локаций
— getUserLocation — получает текущую локацию пользователя
— detectUserLocation — получает текущую локацию пользователя по его ip
Пример вызова, текущая локация пользователя
Пример вызова, поповер с выбором локации
Пример вызова, инпут с выбором локации
Вывод соседних локаций
Управление локациями в админке
Таблица управления локациями представлена в виде виджета
Доступен импорт/ экспорт локаций в формате csv
Из коробки доступны следующие классы определения локации пользователя по ip
— ulDetectLocationByIpGeoBase — включен по умолчанию
— ulDetectLocationBySypexGeo
— ulDetectLocationByDaData
Используемый класс геолокации можно указать в настройке ulMethodDetectLocation
Наиболее точный класс ulDetectLocationByDaData, однако он требует регистрации и указания токена сервиса ДаДата
Примечание
По умолчанию активны крупные города России, вы можете активировать/ деактивировать нужные вам города
Файл локации городов и регионов Росии находится в папке
Источник
CitySelect
msFavorites
Создание списков избранного
msOptionsColor
Цвет или паттерн для опций товара
msCategoryOptions
функционал дополнительных опций в зависимости от категории товара
Геолокация пользователя с помощью DaData
Подсказки города во время набора организованны с помощью kladr-api.
Настройки пакета
После установки пакета необходимо прописать токены для DaData и kladr-api
default_settlement — Местоположение по умолчанию, применимо когда положение не определилось по ip
Для совместимости с другими пакетами где используется пакет GeoLocation добавлена настройка
cityselect_emulation_geolocation, при активной настройке пакет будет выставлять в сессии данные за
GeoLocation
Сниппет citySelect.Settlement
Служит для вывода текущей локации пользователя.
параметры:
tpl — Чанк оформления
frontCss — Файл с css стилями для подключения на фронтенд.
frontJs — Файл с javascript для подключения на фронтенде.
bootstrapModalJsCss — Подключить файлы bootstrap-modal.
bootstrapPopoverJsCss — Подключить файлы bootstrap-popover.
selectizeJsCss — Подключить файлы selectize.
bootstrapModalJs — Файл с bootstrap-modal.js для подключения на фронтенде.
bootstrapModalCss — Файл с bootstrap-modal.css для подключения на фронтенде.
bootstrapPopoverJs — Файл с bootstrap-popover.js для подключения на фронтенде.
bootstrapPopoverCss — Файл с bootstrap-popover.css для подключения на фронтенде.
selectizeJs — Файл с selectize.js для подключения на фронтенде.
selectizeCss — Файл с selectize.css для подключения на фронтенде.
Данные локации
Данные локации доступны в переменной $.settlement, посмотреть доступные переменные можно как
Источник