DownloadPHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5
The Map module shows a map of upcoming events for the selected calendars in the configuration. 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.
In the module settings you can control which initial search criteria should be taken for the radius and length type or various filters. 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 chapter below.
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 settings of module will be inherited. The search criteria is saved in the session, when the visitor comes back, then the settings are remembered.
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. Keep in mind that the coordinates from the module are used for initial load for a default radius search.
To prevent overuse of the geolookup 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.
In the advanced parameters the admin can set some initial date values for the start and end date form field of the module.
Comments (0)