Документация компонента Joomla Яндекс Карты

Данная документация предназначена для разработчиков, которые будут использовать компонент Joomla Яндекс Карты. Компонент написан руководствуясь идеей расширяемости и интеграции с другими компонентами. Делается это при помощи плагинов. В этой документации вы узнаете как написать собственные плагины, под свои системы.

Скачать компонент

Разделение на версии PRO и Medium

До того, как компонент был разделен на 3 версии - его лицензия была Medium. Т.е. если вы купили компонент давно, то у вас Medium версия.

Код активации

Новая система обновлений появится в 5-ой версии компонента. Т.е. начиная с 5.0.0. До этого беспокоится о нем не нужно. Каждому, кто купил PRO или Medium версию компонента, будет выслан отдельный ключ активации. Бесплатная версия начиная с 5.0.0 автоматически обновляться не будет.

Список изменений

Версия 4.0.14

Обновлена версия Jodit в плагине Яндекс Карты Арендатор

Исправлены ряд ошибок

Версия 4.0.13

Устранены ошибки в Joomla 2.5.8. Теперь все опции показываются точно также как и в Joomla 3.x

Версия 4.0.12

В плагине K2 Источник данных теперь можно переопределять файл шаблона. По умолчанию это файл plugins/yandexmapssource/k2/tmpl/item.php, но его лучше не менять. При следующем обновлении он затрется. Поэтому, лучше создайте файл
templates/{template_name}/html/com_yandex_maps/plugins/yandexmapssource/k2/tmpl/item.php и все изменения вносите в него.

Версия 4.0.11

В плагине K2 Источник данных в Настройку Использовать изображение метки из изображения категории добавлена опция - Да, но если если нет собственного. Т.е. теперь для метки можно задать собственное изображение.

Новая настройка в K2

В этом же плагине добавлена опция - Шаблон иконки, которая (на данный момент) может принять два значения Белый круг с иконкой и Белый круг.
В зависимости от выбранного режима может иметь вид:

Белый круг с иконкой

Белый круг

Настройка - Цвет метки по умолчанию меняет цвет кружочка

Версия 4.0.10

Головная боль - <base href=""> когда включены SEF ссылки, то страница http://www.rusalochka.asia/poleznaya-informatsiya-i-pamyatki-dlya-turistov-v-pattaje/ воспринимается браузером как папка /poleznaya-informatsiya-i-pamyatki-dlya-turistov-v-pattaje/ на сайте http://www.rusalochka.asia/ и если где-то в описании вставить изображение <img src="images/logo.png"> то браузер будет загружать его так http://www.rusalochka.asia/poleznaya-informatsiya-i-pamyatki-dlya-turistov-v-pattaje/images/logo.png именно поэтому у многих не показывались на сайте изображения в балуне.

В версии 4.0.10 описание дополнительно обрабатывается и к таким ссылка приписывается ROOT_URL. Это хак, правильное решение добавлять в шаблон указанный тег base, но из-за множества жалоб проще было сделать так.

Версия 4.0.9

В плагине K2 источник данных добавлена возможность выводить точки из нескольких категорий. Раньше плагин отдавал только элементы одной категории. Исправлен баг, когда в объекте по каким-либо причинам отсутствовала часть информации, он не отображался. Теперь будет отоюражена метка дефолтного вида.

Версия 4.0.8

Исправлена ошибка в K2 плагине, когда нельзя было использовать поле с одним и тем же названием в нескольких категориях

Испралвена ошибка для HTTPS сайтов, когда поиск в геокодере Яндекса выдавал ошибку

Версия 4.0.7

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

Версия 4.0.4

Добавлены новые иконки для точек на карте

Добавлены новые иконки для точек на карте

Добавлены ссылка на новую документацию на главную в админке

Повысились цены на PRO и MEDIUM версии

Версия 4.0.3

  • Исправлена проблема в фильтре, когда объектов было мало при пеермещении карты они не фильтровались
  • В менеджере категорий добавлена возможность задать родительскую категорию. В фильтре пока это никак не отражено. Но в дальнейшем будет использовано. Вы уже сейчас можете это использовать.

Версия 4.0.2

  • Улучшена производительность плагина K2 источник данных
  • Добавлено кеширование в момент инициализации карты. Значительный прирост скорости на большом количестве объектов
  • Устранена проблема в Joomla 2.5 когда выводилась ошибка про JDispatcher
  • В плагины добавлен метод getCountObject для того чтобы знать сколько объектов содержит плагин

Версия 4.0.1

Для тех кто додумался скачать PRO и Medium версию с канала обновления, посмотрев ссылку в XML файле, лавочка закрыта. Обновления для этих версий только по закрытому ключу, который будет разослан всем, кто купил компонент и указал свой ящик. Дело не касается функционирования компонента. Ограничение будет только на обновление.

Те, кто купил компонент законно, получат код на почту.

Активация Яндекс Карт

Если вы по каким то причинам не получили код, на пишите по адресе chupurnov@gmail.com и вам будет выслан серийный номер продукта.

Версия 3.9.9

Быстрофикс

Версия 3.9.8

По просьбам программистов, добавил несколько опций в настройки Компоненты -> Яндекс Карты -> Настройки -> Объекты -> Всплывающее окно либо в настройках самой карты Общие настройки -> Всплывающее окно

Настройки ширины всплывающего окна(балуна) в Яндекс Картых

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

Исправлена ошибка в выводе описания объекта в отдельный виджет. Эта настройка также вынесена в раздел Всплывающее окно

Версия 3.9.7

Небольшой фикс о котором много просили. Когда вы устанавливаете нестандартное изображение для метки, путь для него устанавливает примерно таким images/sampledata/parks/animals/180px_koala_ag1.jpg. Т.е. это относительный путь от корня сайта. Но если у сайта не выставлен тег <base href=&qt;&qt;> и включен ЧПУ, то ссылка вида http://sitename.ru/blog/animals/ будет означать, что корень сайта находится в папке /blog/animals/ и то изображение будет иметь адрес уже /blog/animals/images/sampledata/parks/animals/180px_koala_ag1.jpg. Лечить это по идее нужно было самим, указав тег base. Но, делать это на существующих сайтах чревато, поэтому в новой версии добалена обработка таких случаев, когда картинка указана с относительным путем.

Версия 3.9.5

В фильтр добавлен элемент Скрыть/Показать все. Включаеся в плагине Расширение-> Менеджер плагинов -> Яндекс Карты - вставка карты куда угодно -> Вкладка Фильтр -> Показывать переключать Скрыть/Показать все

Версия 3.9.4

Устранены рад ошибкок в K2 плагине.

Файлы plugins/yandexmapssource/k2/tmpl/item.php теперь также как и все файлы представлений компонента, можно переопределить создав templates/{templatename}/html/com_yandex_maps/plugins/yandexmapssource/k2/tmpl/item.php

Версия 3.9.0

Теперь в карте, там где отображаются метки и может быть отображен фильтр есть моудльная позиция yandex_maps_sidebar. Просто указывайте ее при создании модуля и модуль будет отображен в этой панели. Это может быть нужно тогда, когда карта расположена на весь экран а вам нужно внести какие-то другие элементы своего сайта. К примеру меню или авторизацию

Версия 3.8.9

В PRO версии появился плагин Яндекс Карты Арендатор, с помощью которого можно сделать из Joomla сайта, площадку Арендатор-Арендодател. Со следующими возможностями:

  • Пользователь регистрируется на сайте и выбирает какую роль он хочет выполнять: Арендатор или Арендодатель
  • Арендодатель в своем профиле (на самом сайте) имеет возможность создавать объекты(метки) добавлять к ним описание и набор фотографий. Назначить режим сдачи/работы объекта и цену одного часа(периода) съема.
  • Возможна, как премодерация объектов так и постмодерация. Либо режим без модерации, тогда объекты будут создваться автоматически.
  • Арендатор видит общую карту со всеми метками, всех арендаторов. Имеет возможность в один клик забронировать объект, на определенное время
  • Для арендатора на карте есть фильтр по времени, по дате и по цене

Исправена ошибка в фильтре по категориям, когда линии и остальные объеты(кроме меток) не скрывались

В настройки карты добавлена опция: Использовать Название объекта как подсказку на объекте

Версия 3.8.8

В настрйоки во вкладку Категории, в опцию Что делать при смене категории добавлен вариант Скрывать все объекты, показать только из выбранной категории

Версия 3.8.6

При добавлении объектов была ошибка в выставлении шаблона номера телефона. Для РФ было все в порядке по умолчанию, а для для других стран нет. Исправлено

Версия 3.8.5

В некоторых вариациях шаблонов joomla диалоговое окно добавления собственных объектов не показывалось над сайтом. Исправлено

Версия 3.8.4

В некоторых вариациях настроек не вовремя подключается jQuery, из-за этого компонент не запускается. Устранена эта ошибка

Версия 3.8.3

В PRO версии по просьбам разработчиков добавил опцию Ширина виджета для Виджета ближайшие объекты

Версия 3.8.2

Фикс для предыдущего обновления

Версия 3.8.1

Для виджета Ближайшие объекты (PRO версия) добавлена возможность выбора выбора местоположения (Лево, Право, Верх, Низ).

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

Вот пример карты с использованием новых опций

Улучшение для тех, кто переделывал шаблоны компонента. Там многие файлы в шаблоне подключались по прямому указанию пути. При обновлении компонента все файлы затирались. Теперь файлы загружаются через отдельную функцию. И, к примеру, если создать файл /templates/beez3/html/com_yandex_maps/helpers/html/customballooon.php то место упомянутого выше кастомного балуна будет загружаться этот файл. Со всеми остальными файлами также.

Начаты работы по интернационализации компонента

Версия 3.8.0

В плагин и элемент Zoo добавлена опция вывода лишь одного объекта на карте. Когда карта выводится на странице материала.

Zoo добавлена опция вывода лишь одного объекта на карте

Версия 3.7.9

Исправлена ошибка, при которой при редактировании объектов на карте, у них могли произвольно появляться надписи из поля Название. Это поведение будет работать, если опция Настройки->Объекты->Использовать Название объекта как надпись на метке стоит в положении Если пусто или Да. Если же данная опция установлена на Нет то данное поведение было не правельным. Исправлено

Версия 3.7.8

В этой версии на основной канал загрузки объектов на карту добавлено кеширование Joomla. В ускорении можно обедиться на официальной странице. Раньше она немного притормаживала.

Версия 3.7.7

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

Показывать анимацию загрузки

В changelog теперь показывается дата обновления

Версия 3.7.6

В компонент вернулся плагин интеграции с Zoo. После двух недель доработок, в PRO версию вернулся плагин Яндекс Карты - ZOO - Источник данных который добавляет в Элементы ZOO дополнительный тип Яндекс Карты (xdan.ru)

Яндекс Карты - ZOO - Источник данных

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

Яндекс Карты - ZOO - Источник данных

После чего, при создании/редактировании Материала ZOO такого типа у него появятся дополнительные поля

Яндекс Карты - ZOO - Источник данных

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

Яндекс Карты - ZOO - Источник данных

Тогда карта, и метка на ней будут выведены прямо в материале ZOO, так как это будет предусмотрено в шаблоне

Но при этом и стандартный механизм вывода Яндекс Карты с элементами ZOO также будет работать. Для этого в источнике необходимо будет выбрать ZOO материалы

Яндекс Карты - ZOO - Источник данных

Важно Плагин Яндекс Карты - ZOO - Источник данных должен быть включен. И в нем должно быть выбрано нужное приложение.

Версия 3.7.3

Мало кто знает, но у всех менеджеров (Менеджер объектов, Менеджер Категорий и Менеджер Карт) есть корзина для удаления. Все элементы при удалении сперва попадают туда. В этой версии в каждый менеджер была добавлена кнопка Корзина, нажав на которую вы сразу жке перейдете в корзину. Чтобы полностью удалить элемент его еще раз необходимо выделить и снова нажать удалить.

Версия 3.7.2

Исправлена проблема кодировки при создании объектов в Менеджере объектов. Из-за нее на некоторых хостингах место кирилических символов появлялись знаки вопроса(?????)

Версия 3.7.1

Исправлена ошибка, когда на странице объекта подгружались постаронние объекты

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

Версия 3.6.9

В PRO версию компонента добавлен виджет - Ближайшие объекты, который вывожит в колонке справа столбиком описания блжайших объектов и картинки к ним

виджет - Ближайшие объекты

Версия 3.6.8

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

Версия 3.6.1

Пока карта не загрузилась показывается анимированное изображение

Версия 3.6.0

В настройки фильтра добавлены 2 настройки: какие категории выводить, и вымота фильтра в px

Версия 3.5.9

Исправлена ошибка добавления объекта, если на странице выведено несколько карт

Версия 3.5.8

Устранена ошибка работы пустого фильтра

Версия 3.5.7

Устранена ошибка при выводе нескольких карт на одной странице

Версия 3.5.6

Устранена ошибка импорта для компонента работающего на Joomla 3.4.4. В этой версии Joomla введена новая система фильтрации нежелательных файлов.

Если вы в своем коде где-то используете конструкцию JFile::upload($tmp, $dest) то замените ее на JFile::upload($tmp, $dest, false, true)

Версия 3.5.5

У плагина Яндекс Карты - вставка карты куда угодно устранена ошибка ведущая к конфликту с плагинов Modules Anywhere

Версия 3.5.4

Исправлена ошибка в сохранении настроек карты

Версия 3.5.3

Исправлена работа административной части компонента на сайте работающем через https соединение

Версия 3.5.1

В описании объектов в файле components/com_yandex_maps/views/object/description.php закралась очепятка new stdObject() место new stdClass

Версия 3.5.0

Фикс предыдущих правок. Был ряд ошибок. Устранено

Версия 3.4.9

Исправлены ошибки в работе фильтров в адмиинстративной части. Также устранена проблема с пагинацией

Версия 3.4.8

Исправлен Импорт/экспорт

Версия 3.4.7

Доработан фильтр

Версия 3.4.6

Устранена ошибка в Joomla 2.5 в которой не был подключен jQuery

Добавлена кнопка: Редактирование карты без загрузки объектов. Будет очень удобна в тех случаях, когда на карте большое количество объектов, а нужно изменить лишь одну настройку карты или добавить лишь один объект

Редактирование карты без загрузки объектов

Версия 3.4.2

Changelog добавлен в сам компонент на главную

Версия 3.4.1

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

Добавлена опция в фильтр в настройках карты: Активные категории фильтра. Убирает первоначальную подгрузку всех категорий на выбранной карте. Подгружаются только выбранные категории, а остальные показыватся путем установки checked в фильтре категорий. P.S.

 Активные категории фильтра

Исправлена ошибка в сортировке Категорий. Теперь в фильтре они выводятся по той сортировке которая задана в первом столбце в Менеджере категорий

В настройки карты добавлена опция: Искать только среди своих объектов. Т.е. поиск строки в контроллере на самой карте будет не глобальным, а по своим объектам

Версия 3.4.0

Добавлена опция - Показывать описание карты на странице карты

В плагин вставки карты добавлена опция - Обрабатывать AJAX запросы

Версия 3.3.9

Исправлена ошибка в работе компонента при вставке карты через плагин

Версия 3.3.8

Исправлена ошибка в работе компонента на сервере с MariaDB

Версия 3.3.4

В настройках появилось две опции: подключать Яндекс API в режиме отладки и количество объектов, которые будут грузится по AJAX за один раз

Настройки - Объекты - Колиечство загруженных объектов за 1 AJAX запрос

Настройки - Основные настройки - Загружать Яндекс Maps API в режиме debug

Версия 3.3.2

Исправлена ошибка в JavaScript, когда вывод объектов срабатывал чуть раньше чем генерация карты

Версия 3.3.0

Добавлена поддержка Open Street Maps. теперь эти карты можно выводить отдельным слоем на карте

Добавлена опция - Центрирование карты на положение пользователя. Т.е. карта будет перемещена туда, где вероятно находится в данный момент пользователь.

Версия 3.1.1

Для кластеризатора теперь можно задавать собственные иконки: Настройки - Настройки кластера - Собственные иконки кластеров. Результат настройки можно посмотреть на этом примере

Настройки - Настройки кластера - Собственные иконки кластеров

Версия 3.0.9

Строго по заявкам

Одна категория - много карта

Один объект - много категорий

Версия 3.0.4

В объектах и картах теперь можно выводить название объекта(карты) как title страницы. В настройки карты добавлены метаданные: ключевые слова и описание

Версия 3.0.2

Исправлен неприятный баг при редактировании карты, описание объектов в области видимости затиралось. Устранено

Версия 2.9.5

Полная интеграция с компонентом K2. Появились два плагина: первый - добавляет в редактирование материала поле ввода адреса и миникарту, второй: создает новый источник для карты. K2 может выводить на карту не только свои материалы но и свои категории. Смотрите видео

Также, как и в K2 в источник Материалы joomla добавлена возможность вывода стандартных категорий на карту

У модуля появилась опция, Передвигать карту на текущий объект. Теперь, если модуль будет выведен на странице материала, и при этом источником у карты выбраны: Материла Joomla, то карта автоматически перейдет на то место где находиться этот материал.

Теперь при интеграции K2 или материалов Joomla можно использовать иконкой изображение, которое поставлено для категории(k2 или Joomla)

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

Цена повышена до 400 рублей

Версия 2.9.1

Устранены проблемы при обновлении отдельных плагинов

Версия 2.8.8

Устранены проблемы связанные с работой на сервере в котором в php.ini запрещена короткая нотация <?, из-за этого у некоторых пользователей компонент не работал.

Версия 2.8.5

Добавлены два плагина которые позволяют по аналогии с плагинами материалов (смотрите второе видео) сделать вывод текущего местоположения зарегистрированных пользователей. Притом сами пользователи в своей профиле с помощью миникарты смогут менять свое местоположение.

Версия 2.8.0

Добавлен виджет - Фильтр, теперь можно фильтровать объекты по категории, к примеру оставить на экране только магазины одежды и кафетерии, а убрать все другие. Достаточно сделать соответствующие категории

Добавлена опция - карта на весь экран.

Версия 2.7.8

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

Добавлены опции: изображение, электронный ящик, телефон и вебсайт во вкладку публикация. Это опции нужны для большей кастомизации компонента программистами. Если выбрано изображение, то оно удет выведено в балуне и в описании объекта

Устранены ошибки с визуальным конструктором объектов

Версия 2.6.6

Теперь объекты можно добавлять прямо на странице редактирования карты. Прямо как в старом добром бесплатном модуле. Но более удобно

Версия 2.6.0

Появилась настройка - Вид объекта по умолчанию - Показывать текст метки когда выбрано собственное изображение, аналогичная настройка есть в плагине plg_yandexmapssource_content(этот плагин делает из материалов метки для карты) - во вкладке - Вид объекта. Для меток у которых место стандартной, стоит кастомная иконка, не всегда нужно выводить текст на ней

Появилась опция - Объекты - Как открывать ссылки, аналогичная опция есть у плагина plg_yandexmapssource_content. Ссылки подробнее могут открываться, как на той же странице, так и в новой

Версия 2.5.5

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

Плюс глупо было обновлять целый компонент из-за одной правки в плагине или модуле. теперь этого можно избежать

Версия 2.5.4

Добавлена возможность выводить на карте список материалов Joomla, как метки.

Вот карта http://joomla.xdan.ru/yandeks-karty/karta-dlya-materialov.html

При редактировании материала http://joomla.xdan.ru/administrator/index.php?option=com_content&view=article&layout=edit&id=6 во вкладке Публикация появилась строка Адрес. При создании карты http://joomla.xdan.ru/administrator/index.php?option=com_yandex_maps&task=maps.edit&id=12 во вкладке Общие настройки, появилась опция - Источник. При указании что источником являются материалы, на карте помимо ее меток будут выводится и все материалы у которых проставлен адрес. + у каждого объекта можно в настройках указать привязанный материал. Тогда по ссылке подробнее будет ссылка на материал.

Версия 2.5.1

Добавлен кнопка - Добавить объект.

Версия 2.4.5

Добавлен элемент управления - Добавить объект. Теперь можно добавить его прямо на карту и эту кнопку Ваши пользователи заметят.

Все настройки карты и настройки добавления нового объекта продублированы в карты. Теперь можно установить собственные настройки для отдельно взятой карты

Версия 2.3.4

Добавлен функционал добавления точек простыми пользователями. Есть набор отключаемых полей - организаций. С закачкой фото и другой информации

Добавлена опция выключения ссылки - Открыть в Яндекс Картах

Добавлена опция - показывать объекты в виджете объектов

Устранена проблема c работой в Joomla 3.1.x

Версия 2.3.3

Устранена проблема при работе с компонентом K2

В настройки вынесены - сворачивать/разворачивать объекты категории, при клике на категорию в списке объектов

При выводе карты при помощи плагина, добавлена возможность прямо из место описания, задавать адрес для карты. К примеру: {­map 1 &address=г.Уфа ул.ленина д.34&zoom=12}

Версия 2.3.2

Устранена проблема с magic quotes для старых серверов

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

Устранена проблема при создании метки с пользовательским изображением

Версия 2.3.0

Поддержка Joomla 2.5.14

Устранены ошибки при создании карты с кластером и не метками

Версия 2.1.9

Поддержка Joomla 2.5

Версия 2.1.6

Плагин помимо {map map_id} вывода карты поддерживает еще {mapmodule module_id} вывод карты через модуль Яндекс карты в любом месте сайта

Версия 1.0.29

Добавлены два файла стилей во frontend сайта. Первый - custom.css - он создается автоматически и не затирается при обновлении системы, второй frontend2.css - не создается, но если вы его создали, то он будет подключаться место frontend.css и не будет затерт во время обновления

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