#621 Upcoming Module

Parent Category:
DPCalendar
Category:
Modules
Last Updated:
Allon Moritz (laoneo), Saturday, 08 June 2019 16:19 (2 weeks ago.)
Created:
Friday, 14 September 2012 22:23 (Friday, 14 September 2012)
Hits:
21679

Introduction

The Upcoming Module shows the upcoming events within your DPCalendar Joomla calendars. It comes with different layouts to perfectly fit to your needs of your Joomla site. Each layout will be explained in the next chapters.

Default layout

The default layout does show a vertical list of events with a CSS based calendar icon beside each event.

Upcoming module default layout

Icon layout

The icon layout does show a vertical list of events with an SVG icon beside each event.

Upcoming module icon layout

Simple layout

The simple layout does show a list of events with the event color as identifier. It is the most compact layout and can be used when very little space is available.

Upcoming module simple layout

Blog layout

The blog layout does show a vertical list of events in blog style. It renders similar to the blog menu item.

Upcoming module blog layout

Horizontal layout

The blog layout does show a horizontal list of events with a CSS based calendar icon beside each event.

Upcoming module horizontal layout

Panel layout

The panel layout does show a list of events as panels. This makes mostly sense to use when each event has an image.

Upcoming module panel layout

Timeline layout

The timeline layout does show a list of events as a timeline. It renders similar to the timeline menu item.

Upcoming module timeline layout

Useful hints

  • How to remove the date or time?
    If you don't want to display the date or/and time, put a space into the date or/and time option in the module.

Troubleshooting

  • Slowing down the site
    If you use the upcoming module and you have selected external calendars with a lot of events, then it is advisable that you set the End Date in the advanced module options to "+1 week" or so, otherwise it will fetch to many external events initially and slow your loading times.

Options

Select calendar [Type: Dpcalendar]
The calendars which should be pre selected. All subcalendars will be included as well also when deselected.
The following options are available:
  1. All
Date format [Type: Text]
The format of the date for an event (check http://www.php.net/date for details). If empty the date format in the component configuration is taken.
Time format [Type: Text]
The format of the time for an event (check http://www.php.net/date for details). If empty the date format in the component configuration is taken.
Max events [Type: Text] [Default: 5]
The maximum count of events should be displayed.
Sort Order [Type: Radio] [Default: Ascending]
The order strategy of the events.
The following options are available:
  1. Ascending
  2. Descending
Sort By [Type: List] [Default: Start Date]
By which field should the events being sorted.
The following options are available:
  1. Start Date
  2. Modified
  3. Added
Filter [Type: Text]
Find events whose title/description/location contain this string.
Description limit [Type: Text]
Specify how much text will be be displayed from the event description. Empty means unlimited.
Show Location [Type: Radio] [Default: No]
Shows the event location.
The following options are available:
  1. Yes
  2. No
Show Price [Type: Radio] [Default: No]
Show the price information.
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
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
Open in popup [Type: Radio] [Default: No]
Should the events being opened as a modal popup.
The following options are available:
  1. Yes
  2. No
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
Filter Featured [Type: Radio] [Default: No]
Show only featured events.
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.
Default Menu Item [Type: Menuitem]
The menu item to open the events with.
The following options are available:
Show Empty Text [Type: Radio] [Default: Yes]
Should a text being displayed when no events are found?
The following options are available:
  1. Yes
  2. No

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.
Event grouping [Type: Text]
Enter a date / time format for grouping (check http://www.php.net/date for details). All events with the same format will be grouped under a header. e.g. enter 'd M Y' to group events per day. How the header should look like can be customized below. Leave blank for no grouping.
Layout [Type: Modulelayout] [Default: _:default]
Use a layout from the supplied module or overrides in the templates.
Module Class Suffix [Type: Text]
A suffix to be applied to the CSS class of the module. This allows for individual module styling.

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