The Upcoming Events Module
Module Name: Upcoming Events
Purpose: The Upcoming Events module displays a list of upcoming events in a module. There are several styles and dozens of variations available.
Use the following module settings to configure your upcoming events module:
Select a calendar: Choose a calendar to specify which events and theme to use for the upcoming events
Upcoming Type: Select days, weeks or months
Upcoming Number: used with Upcoming Type to determine how far into the future to show upcoming events. Example Upcoming Type: weeks, Upcoming Number: 2 will show up to 2 weeks of upcoming events
Max # of Events: Do not display more than this # of events in the module. Use "0" to show all events in the given range.
Upcoming Start: Choose "Starting Today" or "Starting Now". Selecting "Starting Now" will not show events that have occurred earlier today.
Show End Time: When enabled, the end time will be displayed for meetings, i.e. "12pm - 1pm"
Show Date: When enabled, the date of the event will be displayed. The date is always displayed for multi-day events.
Date Format: The formatting of the date when "Show Date" is enabled. It can either be in the date format for PHP's gmdate() or strftime() functions. Two short formats to consider are "%m/%d" or "%d.%m", where %m is the 2 digit month and %d is the 2 digit day of the month.
Display format: Zap Calendar provides 9 display formats for upcoming events (note: Zap Calendar Lite has only one display format, "default"):
- Default - a simple list of events
- Fancy - displays a calendar icon using the calendar's theme color
- Fancy Color - same as "fancy" using the category color
- Fancy Box - displays a box surrounding the calendar icon and event details using the calendar's theme color
- Icon - combines the category color with the event icon to create the calendar icon
- Plain - displays a minimalist calendar icon using the calendar's theme color
- Plain Color - same as "plain" using the category color
- Round - displays a round calendar icon using the calendar's theme color
- Round Color - same as "round" using the category color
Footer Text: This text will be displayed at the bottom of the module.
Footer URL: When combined with Footer Text, a hyperlink can be added at the bottom of the module. For example, the footer text "Full Calendar" combined with the URL can redirect a user to the calendar page.
Footer Target: Used with the footer text and footer URL, this is the "target" attribute for a hyperlink.
Module Class Suffix: This option, along with the display format option, can generate dozens of variations of display styles. The following class suffix options are supported:
- border - This option creates a border around the calendar icon, supported by the plain and round format styles.
- horizontal - (new in version 4.1.1) This option will display the upcoming events in a horizontal list instead of a vertical list.
- large - This option creates a larger calendar icon.
- no-repeat-icon - (new in version 4.1.1) When used, this option will only display the calendar icon for the first event of the day.
- shadow - This option creates a shadow behind the calendar icon to create a 3D effect.
- upper - This option displays the icon's month text in uppercase letters.
These classes can be combined by separating them with a space. For example, "shadow large" will create a large icon with a shadow behind it. You will need to preceed the first class option with a space.
Below is a side-by-side example of some of the display formats:
Additional layouts are possible through customization (see the "Customizing Zap Calendar" article for more information).