#616 Menu Item List

Parent Category:
DPCalendar
Category:
Menu items
Last Updated:
Allon Moritz (laoneo), Monday, 22 July 2019 11:44 (Monday, 22 July 2019)
Created:
Wednesday, 22 February 2012 10:15 (Wednesday, 22 February 2012)
Hits:
5626

Introduction

The Event list menu item shows a list of upcoming events, similar to a Joomla articles category list, below a map. Initially is the list shown for a given timeframe, specified in the options. Through the navigation button, can the visitor browse the events in time.

Map

The map above the events list does show their locations. If there are multiple events on close locations or even on the same location, then a cluster is shown which shows an icon about how many events do appear on that spot. Clicking on the cluster icon will expand the events where the visitor can click on them to show their info popup.

Events list

Search form

There is a search area available which allows to search between dates and in content. Users are also able to search events in a certain radius for a specific location.

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.

Events list form

Location search autocomplete

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.

Events list form location

Important options

There are tons of settings for the list view in the global DPCalendar options. We would like to explain here the most important ones. Every option has a detailed explanation as tooltip when hoovering over the label in the Joomla configuration manager.

  • Start date
    The start date where the list should load initially.
  • List increment
    The list shows the events time based and with the increment setting the admin can define the time span of the shown events. This setting is also used when the user navigates in the list back and forth.
  • Expand events
    If expand events is set to yes, then the individual instances of a series are shown, otherwise only the original events beside the single events. If only the original events are shown, then a human readable string is displayed of the rrule attribute of the event.

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.

Start Date [Type: Text]
The start date, can be relative to now like +1 day.
Date Format [Type: Text] [Default: m.d.Y]
The date format in the header of the list.
List Increment [Type: Text] [Default: 1 month]
The increment value for the navigation. Accepts strings like 1 month, 2 weeks or 4 days.
Only My Events [Type: Radio] [Default: No]
Shows only the events which I'm the author of. If the user is a guest no events are shown.
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
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
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).
Description Limit [Type: Text]
Specify how much text will be be displayed from the event description. Empty means unlimited.
Search Form [Type: List] [Default: Show]
How should the state of the search form be.
The following options are available:
  1. Show
  2. Expand
  3. Hide
Show Hits [Type: Radio] [Default: Yes]
Should the hits value be shown.
The following options are available:
  1. Yes
  2. No
Show Booking Button [Type: Radio] [Default: Yes]
Show the booking button.
The following options are available:
  1. Yes
  2. No
Show Map [Type: Radio] [Default: Yes]
Should a map be shown.
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: 350px]
The height 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.
Featured [Type: Radio] [Default: No]
Show only featured events.
The following options are available:
  1. Yes
  2. No
Enable Autocomplete [Type: Radio] [Default: Yes]
Should autocomplete being enabled?
The following options are available:
  1. Yes
  2. No
Filter Locations [Type: Location]
Only show events for the given locations. If empty, the filter has no influence.
Filter Tags [Type: Tag]
Only show events for the given tags. If empty, the filter has no influence.

Comments (0)

Cookies make it easier for us to provide you with our services. With the usage of our services you permit us to use cookies.
More information Ok Decline