Menu

#619 Menu item map

Parent Category:
DPCalendar
Category:
Menu items
Last Updated:
Allon Moritz, Tuesday, 07 November 2023 13:27
Created:
Wednesday, 22 February 2012 10:15
Hits:
7220

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

Radius search

If the user wants to search based on locations, then he 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.

Events list form 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
Enable Autocomplete [Type: Radio] [Default: Yes]
Should autocomplete be enabled?
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.