Menu

#619 Menu item map

Parent Category:
DPCalendar
Category:
Menu items
Last Updated:
Allon Moritz, Thursday, 28 November 2024 08:53 (2 weeks ago.)
Created:
Wednesday, 22 February 2012 10:15
Hits:
7672

DownloadPHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5

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.

Map menu item

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.

Map menu item 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. 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.

Map menu item filter location

Author filter

In the map menu item the admin can filter for an author, then only events of a given user are shown within the calendar. There is a special "My" option available which displays only events of the current logged in user.

Options

The settings can be configured globally in the DPCalendar options or per menu item. If the value is empty in the menu item, then it will be inherited from the global options.

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
Date Format [Type: Text] [Default: d.m.Y]
The format of the date in a form (check http://www.php.net/date for details).
Map Zoom [Type: Text] [Default: 4]
The initial zoom level of the map.
Map Latitude [Type: Text] [Default: 47]
The initial latitude of the map.
Map Longitude [Type: Text] [Default: 4]
The initial longitude of the map.
Map Width [Type: Text] [Default: 100%]
The width of the map.
Map Height [Type: Text] [Default: 600px]
The height of the map.
Radius [Type: List] [Default: 20]
The default radius to search the events within.
The following options are available:
  1. 5
  2. 10
  3. 15
  4. 20
  5. 30
  6. 50
  7. 100
  8. 500
  9. 1000
  10. All
Length type [Type: Radio] [Default: Kilometres]
The length type of the radius.
The following options are available:
  1. Kilometres
  2. Miles
Open Event [Type: List] [Default: Full Page]
How the event should be opened.
The following options are available:
  1. Full Page
  2. Modal
  3. Disabled
Modal Width [Type: Text]
If the event is shown in a modal the width can be defined here.
Modal Height [Type: Text]
If the event is shown in a modal the height can be defined here.
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.
Default View [Type: Dpcfields]
The view which is shown when clicking the first time on a link.
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
Content Before [Type: Textarea]
This text will be displayed before the component output (can contain HTML and supports content plugins).
Content After [Type: Textarea]
This text will be displayed after the component output (can contain HTML and supports content plugins).

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.