Introduction

The Event map menu item shows a map of events. Users are able to search events in a certain radius for a specific location. Regular content search is also provided and even searching within a specific timeframe. How to setup the map providers and more is documented in the maps Introduction article.

The basic options are empty by default, which means the global settings of component options will be used, but you can override them in the menu link configuration. The search criteria are saved in the session, which means, when the visitor comes back, then the settings are remembered. The current location button asks for permission to request the current location of the visitor and will then search events near her/him.

Beside the search criteria, there are a lot of options to control the behavior of the map. The options are described in the chapters below.

Filter panel

Above the map is a panel with various different filter possibilities. The calendars can be deselected to show only events of the calendars the visitor wants. There is a search area available which allows to search between dates and in content.

For every calendar is an Ical Url available to download the calendar as .ics file. The Subscribe link offers the possibility to subscribe to the event through an application which supports the webcal protocol. If the visitor is logged in, then a private ical url will be shown (when the token is generated in the profile) and a CalDAV url to access the calendar from any CalDAV device.

The basic options are empty by default, which means the global settings of component options will be used, but you can override this in the menu link configuration. The search criteria is saved in the session, which means, when the visitor comes back, then the settings are remembered.

Radius search

If the user wants to search based on locations, then the visitor can start typing a name in the location field. Instantly a search is performed which delivers a list of locations to choose from. These locations are fetched from the defined maps provider in the DPCalendar options. A radius can be set within the events should be. Then a circle is rendered on the map to visually indicate the search area. To prevent overuse of the geo lookup service, the search results are cached in the cache directory for a year. This cache can easily be deleted in the Joomla back end cache manager when needed.