Menu

#5519 Menu item locations

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

DownloadPHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5

Introduction

The Locations menu item shows a map and the location details of the selected locations. Additionally can a resource panel being activated and a list of upcoming events which do belong to the selected locations.

On top of each location is a map and direction button shown. These buttons are direct links to the map provider's web site. Especially on smartphone's this is handy as it allows the visitor to quickly open the maps app and find the fastest route from their current location.

How to setup the map providers and more is documented in the maps Introduction article.

Locations view

Grouping

The locations menu item has a grouping parameter which allows to group the locations for cerrtain fields. For example when you want to group by countries, set it to country. Then the view lists the location below the criteria. If you set the "Show Locations" parameter to Yes (not expanded), then the locations will be listed with three columns.

Locations grouped

SEF urls

If you have a lot of locations and want to provide for them nice looking urls. Then you can create a menu item in a hidden menu and select the "All" option in the location select box. Then for all your locations are sef urls generated and you don't have to select them always in the menu item after creation.

Resource panel

The resource panel shows a timeline grid of events for the selected locations and rooms (when available). There are four different type views the visitor can choose between.

When you have the create event permission and are clicking in a date cell for a room, then the event form gets opened with the location and room preselected.

Column width

In the options you can define the column width globally for all views. Ff you want to change it per view, it becomes a bit more complicated as this needs to be done through CSS (the library we are using does not support it yet by parameter). Put the following CSS code into your template CSS file and change the width, according to your needs. Make sure that it gets loaded after the DPCalendar CSS files.

.com-dpcalendar-locations .fc-timelineYear-view .fc-time-area col {
    min-width: 100px !important;
}.com-dpcalendar-locations .fc-timelineMonth-view .fc-time-area col {
    min-width: 100px !important;
}.com-dpcalendar-locations .fc-timelineWeek-view .fc-time-area col {
    min-width: 100px !important;
}.com-dpcalendar-locations .fc-timelineDay-view .fc-time-area col {
    min-width: 100px !important;
}
Locations resource view

Filters

In the locations menu item the admin can set different filters for the events to display only what is needed.

Author filter

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

Tags filter

A filter to display only events from the selected tags. Tags can be set while editing an 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.

Locations grouping [Type: List] [Default: None]
The locations grouping criteria.
The following options are available:
  1. None
  2. Title
  3. Country
  4. County
  5. City
  6. Postcode
  7. Street
  8. Colour
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: 250px]
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.
Show Location [Type: List] [Default: Yes and expand]
Should the location of the event be shown?
The following options are available:
  1. No
  2. Yes
  3. Yes and expand
Show Upcoming Events [Type: Radio] [Default: Yes]
Should the upcoming events list be shown?
The following options are available:
  1. No
  2. Yes
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
Show Resource View [Type: Radio] [Default: Yes]
Should the resource view be shown?
The following options are available:
  1. No
  2. Yes
Default View [Type: List] [Default: Day]
The view which is shown when clicking the first time on a link.
The following options are available:
  1. Month
  2. Week
  3. Day
  4. Year
Show Datepicker Button [Type: Radio] [Default: Yes]
Should the datepicker button be shown.
The following options are available:
  1. No
  2. Yes
Show Today Button [Type: Radio] [Default: Yes]
Should the today button be shown.
The following options are available:
  1. No
  2. Yes
Show Title [Type: Radio] [Default: Yes]
Should the title in the header between the buttons be shown.
The following options are available:
  1. No
  2. Yes
Column Width [Type: Text]
The width of the columns. Value must be an integer.
Title Format Year [Type: Text] [Default: Y]
The format of the title in the year view (check http://www.php.net/date for details).
Title Format Month [Type: Text] [Default: F Y]
The format of the title in the month view (check http://www.php.net/date for details).
Title Format Week [Type: Text] [Default: M j Y]
The format of the title in the week view (check http://www.php.net/date for details).
Title Format Day [Type: Text] [Default: F j Y]
The format of the title in the day view (check http://www.php.net/date for details).
Time Format Year [Type: Text] [Default: H:i]
The format of the time in the year view (check http://www.php.net/date for details).
Time Format Month [Type: Text] [Default: H:i]
The format of the time in the month view (check http://www.php.net/date for details).
Time Format Week [Type: Text] [Default: H:i]
The format of the time in the week view (check http://www.php.net/date for details).
Time Format Day [Type: Text] [Default: H:i]
The format of the time in the day view (check http://www.php.net/date for details).
Axis Format Year [Type: Text] [Default: M j]
The format of the axis in year view.
Axis Format Month [Type: Text] [Default: l j]
The format of the axis in month view.
Axis Format Week [Type: Text] [Default: D j H:i]
The format of the axis in week view.
Axis Format Day [Type: Text] [Default: H:i]
The format of the axis in day view.
Min Time [Type: Text]
The first hour/time that will be displayed, even when the scroll bars have been scrolled all the way up. This can be a number like 5 (which means 5am), a string like '5:30' (which means 5:30am) or a string like '5:30am'.
Max Time [Type: Text] [Default: 24]
The last hour/time (exclusively) that will be displayed, even when the scroll bars have been scrolled all the way down. This can be a number like 22 (which means 10pm), a string like '22:30' (which means 10:30pm) or a string like '10:30pm'.
Filter Author [Type: Dpauthor] [Default: None]
Filters locations by author. If my is set, then only locations 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.
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.