My Maps location документация

Вступление

Пусть ваши пользователи ищут местоположения и настраивают отображение так, как вы хотите. My maps location - это просто самая продвинутая интеграция с Google Maps для Joomla.

Основные характеристики:

  • Поиск мест, которые вы создали
  • Авто геолокация
  • Источник карты может быть Google Maps, Bing maps или Mapbox
  • Добавить дизайн карты
  • Получить информацию из мест Google
  • Импорт / Экспорт / Синхронизация местоположений из CSV-файла
  • Представление внешнего интерфейса
  • Много сторонних расширений интеграции

I. MY MAPS LOCATION УСТАНОВИТЬ И ОБНОВИТЬ

1.1 Установить

Наш компонент совместим с Joomla 3.x. Все функции и сторонние интеграции включены во все членства.
Чтобы установить наш компонент, вам нужно скачать расширение .zip и использовать стандартный установщик Joomla.

Затем нажмите кнопку «Обзор»> «Загрузить и установить», компоненты, модули и плагины будут установлены по умолчанию.

1.2 Обновление и автоматическое обновление

Чтобы обновить My Maps location, вы можете установить новую версию поверх старой, загрузив ZIP-файл из JoomUnited или воспользовавшись автоматическим средством обновления (рекомендуется).

MML-обновление

 

Автоматическое средство обновления, которое отправляет уведомление об обновлении, встроено в установленное расширение Joomla. Таким образом, вы получите уведомление, как и любое другое расширение на панели инструментов или с помощью меню: Расширение> Управление> Обновить меню.

 

Войдите в свой аккаунт, чтобы обновить

Вам необходимо войти в свою учетную запись JoomUnited, чтобы обновить все свои расширения JoomUnited Joomla. Чтобы войти, войдите в основную конфигурацию компонента, затем нажмите на Вкладка живого обновления, Внизу вы найдете кнопку входа.

Введите свои учетные данные JoomUnited, которые вы используете для входа здесь @ www.joomunited.com

 

Кнопка станет оранжевой, поздравляю! Теперь вы можете обновить все расширения JoomUnited на этом сайте! Если срок вашего членства истек, вы получите обновленную ссылку и текст, объясняющий это.

Примечание: один логин позволит вам обновить все расширения JoomUnited (относительно вашего членства). Срок действия логина не истечет, если вы не отключите его.

II. РАСПОЛОЖЕНИЕ И КАТЕГОРИИ

2.1 Получить ключ Google Maps API

Каждый раз, когда вы используете API Карт Google, если ваш домен был создан после 22 июня 2016 года, вы должны указывать ключ для проверки вашего запроса.
Получить ключ и включить API: https://developers.google.com/maps/documentation/javascript/get-api-key

Дополнительная информация: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Первый шаг - создать проект и

Затем введите название проекта. Если я хочу разрешить все запросы от mydomain, то шаблон для подражания будет * .joomunited.com / *
Если вы хотите просто разрешить один домен, например mydomain.com, то шаблон будет joomunited.com/*


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


Затем генерируется ключ API, этот ключ необходимо скопировать для добавления в My Maps location.

Добавьте ключ к My Maps Location.

От Компоненты> My Maps Location> Опция просмотраВы можете добавить ключ в конфигурации.

 

Вставьте ключ.

 

Пошаговое резюме:


Итак, шаги, которым я следую,

  • Перейдите в консоль API Google.
  • Создать или выбрать проект
  • Нажмите на Продолжить включить API и любые связанные сервисы
  • На странице «Учетные данные» получите Клавиша браузера (и установите учетные данные API)
  • Чтобы предотвратить кражу квот, защитите свой ключ API следующим эти лучшие практики

2.2 Управление категориями местоположения

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

 

Если у вас много локаций, рекомендуется использовать категории. Вы можете создавать категории и подкатегории.
Чтобы создать категорию, пожалуйста, войдите в My Maps location> Категория и нажмите New


 

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

Вы также можете определить маркер по умолчанию для местоположения в ctaegory, используя вкладку Выбор маркера

 

Примечание: категория создается по умолчанию с именем "Моя категория" позволяет начинать добавлять местоположения сразу после установки

2.3 Создать местоположение

Для того, чтобы создать местоположение, пожалуйста, войдите в My Maps location> Места> Новый

Есть 3 обязательных поля:

  • Название места
  • Категория места
  • Расположение детали (адрес)

 

Для адреса вы получили 3 решения, чтобы добавить его:

  • Используйте поле поиска (рекомендуется)
  • Перейдите на карту и используйте курсор, чтобы указать местоположение
  • Введите адрес (должен быть действительным Google Maps)

 

Чтобы добавить местоположение с помощью поисковой системы, введите название места, которое вы хотите добавить.

добавить местоположение

 

При выборе поля широты и долготы будут заполнены автоматически. Мои карты также интегрированы с местами Google! Это означает, что вы можете искать магазин или что-либо еще, зарегистрированное в Картах Google, наш компонент получит всю информацию о месте.

Google место

 

 

 

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

 

Будьте внимательны с полем адреса и почтовым индексом, если вы заполните его вручную, он должен совпадать с известным адресом Google Maps.

 

Вся другая информация о местоположении (описание, часы, ...) отображаются в подробном представлении о местоположении.

Контактная ссылка в подробном издании местоположения - это возможность добавить контактную ссылку, mailto или URL для каждого местоположения. На веб-интерфейсе это будет кнопка контакта, которая откроет URL или выполнит действие mailto.

2.4 Другая информация о местоположении

На каждом месте вы можете добавить изображение и маркер.

  • Изображение будет отображаться в виде эскиза во всплывающей подсказке о местоположении и в большем размере на странице сведений о местоположении.
  • Маркеры будут отображаться на карте в виде значка маркера местоположения. Вы также получили несколько хороших наборов маркеров для ваших местоположений, включенных в расширение My Maps Location.
  • Использование настраиваемой ссылки переопределяет ссылку на сведения о местоположении с помощью настраиваемого URL-адреса.

 

Маркер-изображения местоположение

 

My Maps location использует многоязычную функцию Joomla. Вы можете определить язык в категориях местоположения и в местах. При переключении языка местоположения будут фильтроваться, как и любой другой контент Joomla, чтобы отображать одобренный языком контент.

Поле описания местоположения является одним из наиболее важных.
Он будет отображаться на странице сведений о местоположении и, в зависимости от темы, в виде вводного текста местоположения в результатах поиска. Что еще более важно, описание представляет собой WYSIWYG-редактор со всеми загружаемыми плагинами внутри, это означает, что вы можете делать с ним все, что захотите (изображения, видео ...).

 

Вот вступительный текст, отображаемый в результатах поиска местоположения.

 

Поле тегов - это та же система тегов, что и в Joomla. Вы можете добавить теги и вложенные теги, а затем загрузить их в веб-интерфейс в качестве фильтра. Чтобы управлять всеми тегами, просто загрузите компонент тегов Joomla: Компонент меню> Теги
На веб-интерфейсе, в зависимости от конфигурации, теги могут отображаться в виде флажков (как показано ниже) или в виде раскрывающегося списка.

 

My Maps Location получил дополнительные поля для заполнения метаинформации (для поисковых систем). Эти поля загружаются на странице сведений о местоположении.

2.5 Отображение мест на веб-интерфейсе

Для отображения вашего местоположения на веб-интерфейсе вы можете использовать:

  • Меню для отображения поисковой системы местоположения, отдельного местоположения или категории местоположений
  • Модуль для отображения поля поиска или выбора набора мест
  • Кнопка редактора для отображения одного или нескольких мест в любом редакторе

Загрузить местоположения из меню

В менеджере меню Joomla добавьте элемент и выберите тип «Поиск и отображение местоположения». Он отобразит поисковую систему с фильтрами.
Выбрать «Подробный вид местоположения» для отображения одного предопределенного местоположения.

 

Если вы выберете «Поиск и отображение местоположения» у вас есть некоторые параметры дисплея. Некоторые могут переопределить параметры компонента по умолчанию.

 

На главной вкладке меню вы можете настроить:

  • Введите адрес: Вы можете заставить адрес по умолчанию отображаться при загрузке страницы. Можно оставить пустым
  • Расстояние: расстояние для блокировки поиска, ссылаясь на адрес выше. Можно оставить как -1 (по умолчанию)
  • Категория: загрузить определенную категорию местоположения
  • Предел поиска: ограничить количество результатов поиска. 10 вернет только 10 первых результатов поиска местоположения
  • Сортировка: упорядочить результаты поиска по дате, названию, расстоянию (по умолчанию)

 

MML-меню расширенный

Тогда на My Maps Location вкладка менюВы можете настроить:

  • Выберите компонент: My Maps Location или все сторонние интеграции, такие как K2, Jomsocial ...
  • ID категории по умолчанию (Сторонние расширения): категория по умолчанию для загрузки, когда используется стороннее расширение, например K2, Hikashop или Adsmanager, идентификатор списка CB для компоновщика сообщества
  • Расположение детской категории: Отображать также в качестве результатов поиска местоположения из подкатегорий, а не только выбранное выше
  • тема: выберите одну из 3 тем по умолчанию, полную ширину и боковую панель поиска и тему отображения результатов, доступную для пункта меню
  • Карта провайдера: Выберите Google Maps, Bing Maps, Mapbox, OpenStreetMap или Mapquest для стилизации ваших карт
  • Включить теги поиска: Позволяет выполнять поисковые запросы с использованием имен тегов местоположения
  • Проекты: В зависимости от источника карты у вас есть несколько типов карт и цветов
  • Слой карты: Добавьте некоторые данные (слой) на ваши карты. Есть слой KML, слой Traffic, слой Transit и слой Bicycling.
  • URL-адрес слоя карты Google: Используйте слой данных для хранения пользовательских данных или для отображения данных GeoJSON на карте Google
  • Тип карт Bing: Если Bing Maps является поставщиком карт, выберите внешний вид и данные Bing Maps.
  • Тип OpenStreetMap: Если OpenStreetMap является вашим провайдером карт, вы можете добавить некоторые данные (слой) к своим картам
  • Всплывающая подсказка: При загрузке карты автоматически открывать всплывающую подсказку о местоположении после поиска местоположения
  • Увеличение карты: Определить уровень масштабирования по умолчанию на карте
  • Параметры ширины и высоты карты и результатов поиска

 

Отображение интерфейса в зависимости от темы

 

Результат для поиска по одному местоположению:


Отображать местоположения с помощью модуля

My maps location поставляется с 2 модулями для родных локаций + другой для интеграции сторонних производителей (например, модуль для отображения местоположений элементов K2)

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

Карта-модуль

My Maps Location - Модуль поиска отобразит поисковую систему с некоторыми фильтрами в качестве опции, такой как ширина карты или компонент, в котором будет производиться поиск местоположения (поиск местоположения K2 только для axample).

 

Показать модуль на веб-интерфейсе:

 

 

Отображение местоположений с помощью кнопки редактора


Кнопка редактора будет загружена в ваш редактор Joomla (обычно в статьях или пользовательских модулях HTML). Вы увидите кнопку внизу вашего редактора.
При нажатии вы увидите лайтбокс, который позволяет вам выбрать одно или несколько мест, которые вы добавили ранее.

 

Затем вы можете выбрать одно или несколько мест и нажать кнопку, чтобы добавить их в вашу статью. Если вы не укажете какой-либо уровень масштабирования, он будет автоматически загружен в соответствии с вашим местоположением.
Код тега, который вы увидите в вашем редакторе WYSIWYG, будет похож на эту модель: {mymaplocations mapid width height}

Пример: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} этот код отобразит карту с идентификатором местоположения = 1, шириной 58%, высотой 400px, 10-кратным увеличением и типом Google. Использование запятой, чтобы добавить более одного места на карте. Пример: {mymaplocation id = 1 ширина = 58% высота = 400px zoom = 10 type = google} идентификатор местоположения = 1, 2, 3.

 

III. ПРЕДСТАВИТЕЛЬСТВО ПЕРЕДНЕГО МЕСТА

3.1 Добавить и управлять местоположениями

My maps location предлагает возможность отправлять и управлять своими местоположениями из внешнего интерфейса. Сначала вам нужно создать меню, которое позволяет отправлять интерфейс.

В менеджере меню Joomla добавьте элемент и выберите тип «Добавить места». Затем, нажав на него, пользователи будут перенаправлены, после входа в систему, к форме отправки местоположения.
Меню «Мои местоположения» позволяет пользователю редактировать свои ранее представленные местоположения.

 

Обзор формы меню внешнего интерфейса:

 

3.2 Ограничение доступа

Процесс подачи и редактирования внешнего интерфейса контролируется Joomla ACL. Чтобы редактировать кому разрешено отправлять и редактировать местоположение, нажмите на Компоненты> My Maps Location> Параметры> Разрешения.
Оттуда вы можете контролировать группу пользователей Joomla, которая может:

  • Создать локации
  • Удалить местоположения
  • Изменить местоположения
  • Изменить состояние публикации
  • Редактировать собственные локации

 

Внутривенно ИМПОРТ - ЭКСПОРТНЫЕ МЕСТА

My Maps location получил инструмент Импорт - Экспорт - Синхронизация для определения местоположения из файла .csv или .kml (файл Google Earth). Нажми на меню My Maps Location> Импорт / Экспорт получить доступ к интерфейсу.

 

Из этого интерфейса вы можете:

  • Импорт местоположений из файла .csv или .kml
  • Экспорт местоположений из файла .csv или .kml
  • Выполните обновление (синхронизацию) местоположений из файла .csv или .kml.

 

Примечание: кнопка синхронизации также работает, когда вы добавили местоположение непосредственно в базу данных

V. ПОИСКОВАЯ СТАТИСТИКА

Вы можете просмотреть статистику поиска местоположения, включив параметр Включить статистику в Настройки> вкладка «Общая конфигурация».

статистика-месяцев

И вы можете увидеть список лучших мест ниже, вы можете экспорт это с типом файла .csv также.

экспорт статистики

VI. ПАРАМЕТРЫ

6.1 Настройки

Компонент имеет много опций, некоторые из которых могут быть переопределены в представлении меню, как мы видели ранее. Нажми на меню: My Maps Location> Опции получить доступ к интерфейсу (вверху справа на экране)

Tab1: общая конфигурация

Parameters1

 

  • Включить статистику: Включить статистику местоположения
  • AJAX поиск: Включите поисковые запросы в AJAX, выполните поиск без перезагрузки страницы
  • Расстояние дисплея: Отображение расстояния местоположения от пользовательской позиции
  • Единица расстояния: Мили или Километры
  • Карта провайдера: выберите между картами Google, картами Microsoft Bing, Mapbox, Openstreetmap + Leaflet или Mapquest
  • Автозаполнение поиска: Предложения автозаполнения при поиске местоположения. Предложения автозаполнения могут поступать из Карт Google, Карт Bing или Openstreetmap, независимо от выбранной вами системы карт.
  • Каждый раз, когда вы используете API Карт Google, если ваш домен был создан после 22 июня 2016 года, вы должны включить ключ, чтобы подтвердить ваш запрос.
    Дополнительная информация: https://developers.google.com/maps/documentation/javascript/usage?hl=en
    Получить ключ: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Тип карт Google: тип карты: дорожная карта, спутниковая, гибридная или рельефная
  • Дизайн карты: Выберите дизайн по умолчанию для ваших карт
  • Прокрутите карту мыши: Включите увеличение / уменьшение масштаба с помощью мыши, когда вы наводите карту
  • Перетащите карту: Включить перетаскивание карты, чтобы перемещаться по ней, используя мышь
  • Маркер открытого события: Как открывается деталь местоположения при нажатии или наведении курсора
  • Включить маркерный кластер: Каждый кластер, имеющий более одного маркера, показывает количество маркеров внутри кластера.
  • Функция автоматического масштабирования: автоматически настроить масштаб для отображения всех маркеров карты
  • Тип карт Bing: Тип карты: Антенна, Птичий глаз или Дорога
  • Ключ API карт Bing: поставить ключ API, чтобы он работал;)

 

Parameters2

 

  • Поиск в любом месте: добавить опцию в радиус поиска, чтобы искать в любой точке мира
  • Поиск в любом месте по умолчанию: по умолчанию селектор радиуса в окне поиска будет установлен на Anywhere
  • Формат тега в поиске: отображать фильтры тегов как флажки или выпадающий список
  • Просмотр улиц: Добавить вид улицы в поиске в качестве опции
  • Показать маршрут: Показать ссылку для расчета маршрута с позиции пользователя
  • Формат маршрута: показать маршрут на My Maps location или перенаправить в Google
  • Контактная ссылка в локации: Добавить ссылку на страницу контактов
  • Контактная кнопка: отобразить контактную кнопку
  • Цель контактной ссылки: Режим открытой контактной ссылки
  • Масштаб карты по умолчанию: Уровень масштабирования по умолчанию на карте при первой загрузке (установите автоматический масштаб на нет)
  • Размер карты: карта и результаты поиска ширина и высота
  • Расстояние для поиска радиуса: определить значения выпадающего списка поиска радиуса
    Ex. Пользователь может выбрать для поиска 10 миль вокруг Нью-Йорка.
  • Показать список выбора расстояния: опция для отображения списка выбора расстояния поиска redius

 

Parameters3

 

  • Обрезать слово в результатах поиска: обрезать описание местоположения на определенное количество слов в результатах поиска
  • Боковая панель JQuery: изменить боковую панель по умолчанию на JQuery (меньший и плавный эффект прокрутки)
  • Отключить геолокацию: отключить геолокацию на не https сайте.
  • Отключить фильтр категорий: эта опция включит фильтр выпадающего списка категории
  • Отключить фильтр состояния страны: отобразить раскрывающееся меню состояния страны в окне поиска
  • Поиск по почтовому индексу: Поиск по полю Zipcode
  • Цвет кнопки ИЛИ: Цвет кнопки «ИЛИ» в теме по умолчанию
  • Цвет кнопки: Цвет кнопки «Geolocate me» в теме по умолчанию
  • Глобальный цвет шрифта: используйте эту опцию, чтобы установить глобальный цвет шрифта для местоположений «Моя карта»
  • Изображение на заднем плане: изображение на заднем плане поиска по теме по умолчанию
  • Вы маркер: добавить свою позицию на карте и выбрать изображение в качестве маркера
  • Изображение значка по умолчанию: использовать изображение значка по умолчанию, если значок недоступен
  • Переопределение помощника: создать файл переопределения стандартного макета Joomla, на который не будут влиять обновления расширений (в папке / html)

 

6.2 Bing как источник карты

Чтобы использовать Bing Maps от Microsoft в качестве источника карты, вам необходимо заполнить ключ API в глобальной конфигурации My Maps location. Страница Bing находится здесь: https://www.bingmapsportal.com/

 

Вы должны создать бесплатную учетную запись отсюда и скопировать код ключа API из своей учетной записи.

 

Затем вы сможете использовать карту Bing в качестве источника карты из глобальной конфигурации (чтобы включить ее по умолчанию) или из пункта меню.

 

 

6.3 Mapbox как источник карты

Чтобы использовать Mapbox, пользовательскую платформу сопоставления для разработчиков, в качестве источника карты необходимо заполнить API Mapbox в поле Конфигурация My Maps location> Провайдеры карт.
Домашняя страница Mapbox находится здесь, вам нужно создать бесплатную учетную запись оттуда: https://www.mapbox.com/

MapBox-дом

 

Оттуда вы можете создать новый дизайн страницы или использовать рекомендованный и сохранить его в своей учетной записи.

карта стиль

 

Чтобы получить свои учетные данные, используйте Меню Аккаунт (в правом верхнем углу):

  • Mapbox API: используйте меню Аккаунт> Токены доступа

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

 

MapBox-apikey

 

Затем просто скопируйте его в конфигурацию My Maps location, чтобы использовать его.

 

MapBox-конфигурации