Menu

#624 Map Module

Parent Category:
DPCalendar
Category:
Modules
Last Updated:
Allon Moritz, Thursday, 28 November 2024 08:53
Created:
Friday, 14 September 2012 22:23
Hits:
8676

DownloadPHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5

Introduction

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.

Map module

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 settings of module will be inherited. The search criteria is saved in the session, when the visitor comes back, then the settings are remembered.

Map module filter

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. 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.

Map module filter location

Initial date values

In the advanced parameters the admin can set some initial date values for the start and end date form field of the module.

Options

Select calendar [Type: Dpcalendar]
The calendars which should be pre selected. All subcalendars will be included as well also when deselected.
Expand Events [Type: Radio] [Default: Yes]
Show the instances of a series or only the original event.
The following options are available:
  1. Yes
  2. No
Include Ongoing Events [Type: Radio] [Default: No]
Should ongoing events be included.
The following options are available:
  1. Yes
  2. No
Map Zoom [Type: Text] [Default: 4]
The initial zoom level of the map.
Map Width [Type: Text] [Default: 100%]
The width of the map.
Map Height [Type: Text] [Default: 300px]
The height of the map.
Radius [Type: List] [Default: All]
Radius
The following options are available:
  1. 5
  2. 10
  3. 20
  4. 50
  5. 100
  6. 500
  7. 1000
  8. All
Length type [Type: List] [Default: Kilometre]
The length type of the radius.
The following options are available:
  1. Kilometre
  2. Mile
Map Mode [Type: List] [Default: Roadmap]
The map mode.
The following options are available:
  1. Roadmap
  2. Sattelite
  3. Hybrid
  4. Terrain
Map Latitude [Type: Text] [Default: 47]
The initial latitude of the map.
Map Longitude [Type: Text] [Default: 4]
The initial longitude of the map.
Date Format [Type: Text] [Default: d.m.Y]
The date format.
Open in popup [Type: Radio] [Default: No]
Should the events be opened as a modal popup.
The following options are available:
  1. Yes
  2. No
Filter Author [Type: Dpauthor] [Default: None]
Filters events by author. If my is set, then only events from the currently logged in user are shown.
The following options are available:
  1. My
  2. None
Filter Tags [Type: Tag]
Only show events for the given tags. If empty, the filter has no influence.
Show Filter Form [Type: List] [Default: Show]
Should the filter form be shown.
The following options are available:
  1. Show
  2. Hide
Hidden Filter Form Fields [Type: Dpcfields]
The fields to hide in the search form.
Enable Location Autocomplete [Type: Radio] [Default: Yes]
Should location autocomplete be enabled? A request to the configured geolocation provider is done.
The following options are available:
  1. No
  2. Yes

Options

Date Start [Type: Text]
The start date, can be relative to now like '+1 day'. If you set 'start of day' then it will set the time to the beginning of the current day.
Date End [Type: Text]
The end date, can be relative to now like '+1 day'. If you set 'same day' then it will set the time to the end of the start day.
Layout [Type: Modulelayout]
Use a layout from the supplied module or overrides in the templates.
Module Class [Type: Text]
Custom CSS [Type: Textarea]
Custom CSS code which will be added to the HTML document.

Comments (0)

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.