Подсказка адресов

Подсказка адресов

Геолокация и подсказки мест при вводе адреса на любом текстовом поле

Системный плагин для CMS Joomla может использоваться как с HikaShop, так и без него. Добавляет к любому текстовому полю (по идентификатору) на всех страницах сайта подсказки мест в виде выпадающего списка при вводе адреса, при этом плагин может отслеживать и динамически добавленные с помощью AJAX или JavaScript на страницу поля. Так же плагин позволяет добавить функцию автоматического определения адреса по местоположению (геолокация). Плагин использует официальные API Яндекс и Google (при бесплатном использовании действует ограничение на количество запросов - не более 25 000 в сутки для яндекса и 1000 или 150 000 для Google). Для работы плагина требуется Google API key (получить его можно быстро и бесплатно, смотрите инструкцию в подробном описании плагина). Внимание! Функция геолокации работает только на защищённых соединениях, то есть только при использовании протокола HTTPS (такова современная политика веб-безопасности).

Более подробное описание работы плагина смотрите ниже

Ещё чуть ниже смотрите пошаговую инструкцию по установке и настройке плагина

  • Лицензия на два сайта
  • Бесплатные обновления
  • Пожизненная техническая поддержка
  • Цена: 400

Текущая версия: 1.0.2 от 17.01.2018.


Описание работы плагина

Геолокация

Если в настройках плагина включена опция "Геолокация", то при загрузке любой страницы сайта (в том числе backend-части), если на странице обнаруживается элемент с заданным идентификатором, срабатывает функция определения адреса по местоположению, при этом появляется запрос браузера на согласие пользователя на определение его местоположения и, при положительном ответе, происходит автоматическое заполнение поля для ввода адреса.

Для функции "Геолокация" требуется обязательное использование на сайте HTTPS-соединения, а так же в настройках браузера не должно быть явных запретов на геолокацию для данного узла или для всех узлов.

Подсказки мест

Так же как и функция "Геолокация", функция "Подсказки мест" срабатывает на любой странице сайта (в том числе backend-части), если на странице обнаруживается элемент с заданным идентификатором. При вводе текста в заданное поле или поля (в настройках плагина можно указать несколько отслеживаемых полей) функция подсказки мест производит поиск по базе Яндекс или Google (в зависимости от настроек плагина), предлагает подходящие варианты в виде выпадающего списка и завершает ввод адреса.

Важной особенностью плагина является возможность отслеживать динамически появляющиеся на странице блоки, загружаемые с помощью AJAX или JavaScript, и применять к ним функцию "Подсказки мест".


Установка и настройка плагина

Шаг 1: Привязка доменов вашего сайта

После покупки плагина перейдите в раздел Личный кабинет и укажите к каким доменам вашего сайта следует привязать плагин, например: artpostel-shop.ru, www.artpostel-shop.ru. Вы можете указать до двух доменных имён для одной покупки плагина.

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

Шаг 2: Настройка Google APIs

  1. Перейдите в Google API Console. Нажмите кнопку "Выбрать проект" ("Select a project") и выберите проект или создайте новый.
  2. На странице "Панель управления" ("Dashboard") сверху выберите "ВКЛЮЧИТЬ API И СЕРВИСЫ" ("ENABLE API"), чтобы открыть вкладку "Библиотека" ("Library"). Альтернативный вариант - можно выбрать пункт "Библиотека" ("Library") в меню слева.
  3. Последовательно найдите и включите следующий набор API:
    • Google Maps JavaScript API;
    • Google Places API Web Service;
    • Google Maps Geocoding API.
    Для того, чтобы включить API, необходимо найти его и выбрать из списка результатов поиска. Затем нажмите сверху "ВКЛЮЧИТЬ" ("ENABLE"). Когда процесс завершится, добавленный API появится в списке на панели "Панель управления" ("Dashboard").
  4. На странице "Панель управления" ("Dashboard") из списка добавленных API выберите Google Maps JavaScript API и затем выполните следующие действия:
    • нажмите кнопку "Создать" ("Create"), чтобы перейти к процедуре создания учётных данных;
    • на странице "Добавление учётных данных" нажмите кнопку "Выбрать тип учётных данных";
    • сохраните где-нибудь в текстовом редакторе созданный ключ Google API key и нажмите кнопку "Готово".

Шаг 3: Установка плагина

  1. Скачайте архив плагина в разделе Личный кабинет.
  2. Скачанный архив plg_tipsaddresses.zip распаковывать не нужно!
  3. Откройте панель управления Joomla на вашем сайте и перейдите в подраздел Расширения Менеджер расширений Установить (Extensions Manage Install).
  4. Переключитесь на закладку Загрузить файл пакета (Upload Package File), выберите скачанный файл с архивом пакета plg_tipsaddresses.zip и нажмите кнопку Загрузить и установить (Upload & Install).

Шаг 4: Настройка плагина

  1. Откройте панель управления Joomla на вашем сайте и перейдите в раздел Расширения Плагины (Extensions Plugins).
  2. Найдите в списке плагин «Geolocation and Tips when entering an address plugin». Для быстрого поиска рекомендую воспользоваться поиском по слову "tips".
  3. Щёлкните по иконке «» в столбце "Состояние". Иконка сменится на «».
  4. Щёлкните по ссылке "Geolocation and Tips when entering an address plugin", в ответ откроется окно настроек плагина.
  5. Настройте параметры плагина:
    Лицензия
    Лицензионный ключ вашего плагина (смотрите в Личном кабинете).
    Ключ Google API
    Ключ, который был получен при выполнении пункта 4 на "Шаге 2: Настройка Google APIs".
    ID поля с адресом
    Идентификатор текстового поля для ввода адреса, к которому применятся функции геолокации и подсказок адреса. Допускается указывать несколько идентификаторов полей через запятую.
    Используется ли AJAX?
    Выберите "Да", если на сайте используется AJAX или JavaScript для динамического добавления на страницу форм с полями для ввода адреса. Например, в компоненте интернет-магазина HikaShop с помощью AJAX загружается форма для редактирвоания адреса доставки.
    Отслеживаемый DOM-узел
    CSS-селектор DOM-узла (#id, .class, tag), в котором необходимо отслеживать изменения и ждать появления поля с адресом. Если хотите отслеживать всю страницу, то можете указать - body, но это может негативно сказаться на производительности, лучше указывать более конкретный узел, например, для интернет-магазина HikaShop - #hikashop_checkout_form. Допускается указывать несколько селекторов через запятую.
    Геолокация
    Выберите "Да" для активации функции автоматического определения адреса по местоположению и заполнения поля для ввода адреса или "Нет" для отключения данной функции. Работает только на HTTPS-соединениях.
    Подсказки мест
    Выберите поставщика сервиса (Google или Яндекс) для активации функции подсказки мест в виде выпадающего списка по мере ввода адреса в текстовом поле. Или выберите "Нет" для отключения данной функции.
    Отладка плагина
    При включенной опции на странице сайта выводятся диагностические сообщения плагина. Рекомендую включить только на этапе отладки плагина, но затем не забудьте её отключить!
  6. Нажмите кнопку « Сохранить и закрыть»

Шаг 5: Проверьте работу плагина

...и наслаждайтесь ;)