The calendar view is one of the most powerful features of Zap Calendar; it ties events and categories together in a customizable display.  The amount of options available for customization may be a bit overwelming to the new user; however, this article will try to demystify the meaning of these options and show how they can be used to create the ideal calendar display for your website.

The view options are divided into 10 groups:

• General
• Calendar
• Category
• Event
• Link
• Upcoming
• Yearly
• Export
• Plugins

The options in each of these groups will be described below.

General

This group of options define some of the more important view settings

Show Title - Show title at top of calendar

Title - Title used for display

Published - The calendar must be in a published state in order for it to be visible to users

Icon Display - Select icon, text, or icaon and text display modes

Print Icon

Download Icon

Subscribe Icon - Not available with events.

Add/Suggest EventIcon - Zap Calendar's global settings define if this will be an add icon or a suggest icon.

Share Icon - for sharing events on social networks. Only available with events.

Calendar Start - Choose the start date for your calendar. No events will be displayed prior to this date. This can be used by the static list display mode to limit the number of displayed events. It can also be used to limit the number of events exported by the iCal format. For example, if your site is primarily interested in future events, you may not want to export past events.  This field can use an absolute or relative date. An absolute date uses the format "yyyy-mm-dd", where "yyyy" is the 4 digit year, "mm" is the 2 digit month, and "dd" is the day.  A relative date uses the format " #[d][m][y] ", where # is a positive or negative number, followed by either a "d" for day, "m" for month, or "y" for year. A relative format of "-1m" will mean "1 month prior to today".  A relative format of "2y" or "+2y" will mean "2 years from today".  If this field is blank, the the global calendar start date will be used (which could be either an absolute or relative date).

Calendar End - Choose the end date for your calendar. No events will be displayed after this date. See previous discussion on field format.

Theme - Choose from one of the supplied themes to change the appearance of the calendar

Browser Mode - Choose from AJAX Browser, non-AJAX Browser, and Static. Both browser modes allow the display to be changed by the user, typically by using the calendar's browser buttons.  The static mode does not allow the display to be altered. It also provides the list and upcoming display modes, which are not available in the browser modes.  Use Static if you wish to use the list or upcoming display modes, and set the static display option below to one of these modes.

Show Browser Buttons

Browser Display - This display is used when browser mode is set to one of the browser modes.

Static Display - This display is used when browser mode is set to static.

Display Description - When enabled, the description will be displayed in the view.

Description

Calendar

This group of options defines settings as they relate to the calendar.

Start of Week - Choose either Sunday or Monday as the beginning of the week

Show Weekends

Day of Week Display - Show either full day of week display or an abbreviated display (i.e. "Monday" vs. "Mon")

Add Pre Week to Monthly Calendar - Add a full week prior to the first week of the month

Add Post Week to Monthly Calendar - Add a full week after the last week of the month

Category

Categories - Specify which categories will be displayed with this calendar.  Multiple categories can be selected. If the categories are defined in a tree structure, then any parent category specified will automatically have its child categories included for display.  This field also determines the categories that a user can use when adding or suggesting an event on the front end.

Show Category Color - Specify none, partial (line of color next to the event, or full ( use color for event background).

Show Category Icon - Show category icon when displaying the calendar.

Event

Allow Popups - When enabled, show popup window when hovering over an event in the calendar.

Show Description - When enabled, include the event description in the popup window.

Description Length - Used with the "Show Description" option above. This sets the maximum number of characters of the description to display in the popup window. Use "-1" to show the entire description.

Date Format - Date format using PHP's date function.  For example, "l, M j, Y" would display "Friday, Mar 5, 2010".

Time Format - Choose either 12 or 24 (military) time format.

Empty List Text - This message will be displayed if there are no events to display, for example, "No events scheduled".

Events Spanning Midnight - This option determines how meetings will be displayed if they go beyond midnight into the next day. The choices are:

• Always show last day
• Do not show last day if meeting ends less than 3 hours after midnight
• Do not show last day if meeting ends less than 6 hours after midnight
• Do not show last day if meeting ends less than 12 hours after midnight
• Do not show last day

Note: This only effects meetings. All day events are not affected by this option.

Link

When Event Links to the Event Description

When Event Links to an Article

When Event Links to an URL

All three of these options have three choices: Same window, New window, and Modal style.

Itemid Hint - Enter the Itemid to the Zap Calendar component page.  This option is used when this view is used in a module and links to the component page.

View Hint - Enter the view id of the component page to point to in this view's RSS feed.

Upcoming

Upcoming Type

Upcoming Number

Max # of Events

Use these options to display the list of upcoming events. These options allow the display of upcoming items such as upcoming events in the next 3 days, 1 week, 3 months, etc.  Use the maximum # of events option to limit the number of upcoming events to display.

Alternate format for upcoming display - Use this option to use an alternative form to display the upcoming events. If left blank, the default form, "upcomingitem.tpl", is used. To use an alternative format, create a file with the ".frm" extension in the component's forms folder similar to the "upcomingitem.tpl" file in the same folder.  Enter the form's name (without the extension) in this field.

Yearly

Month Start - Choose January as the year's starting month, or pick another starting month.  You may wish to start your calendar in the same month as your fiscal calendar.  Schools may wish to display the calendars from July to June.

Export

Allow iCal Public Export - Allow users to export your calendar as an iCal file.

RSS Feed for this calendar - Use this option to enable the RSS feed for this view.

Use publishDate Tag in RSS Feed

URL Home Page for RSS Feed - Subscribers of your feed will be directed to this page

Event formatting in feed (leave blank for default format) - Use this field to change the default format by creating a custom form to display the event in the RSS feed.

RSS publish mode - Select "Daily" or "Weekly".  In most cases, choose "Daily".  Weekly mode is a special mode used by feedburner.com to publish events on a weekly basis via e-mail using Zap Calendar's RSS feed.

Day Mode - RSS # of upcoming days

Weekly Mode: RSS publish day

Plugins

If a Zap Calendar plugin has view specific parameters, they will be seen here.  The display order of plugins is done in Joomla's plugin manager.