Calendar

Overview

A Calendar is a User Item that adds a dynamic calendar to a Custom Page. You can see an example on the Second Site demonstration site.

Each Calendar User Item may have one or more Calendar Events subitems to specify which events you want to include on the calendar. Events appear on the calendar on the anniversary date of their occurrence.

Calendars are created by scripts that Second Site adds to the page and they will not be visible unless JavaScript is enabled in the browser. The scripts generate the HTML required to show a one-month calendar and provide controls for changing from month to month.

The initial view of the calendar when the page is opened is the current month. The person browsing the site may move forward or backwards a month at a time using arrows that appear near the display of the current month.

You may place multiple Calendar User Items on a single page, but that is not recommended. Calendars make a page look busy and two calendars may be overwhelming to someone browsing your site.

Formatting

On the Custom Page that hosts the Calendar User Item, the calendar is enclosed by a DIV element that by default includes a border that also surrounds the calendar title and caption. You may adjust the formatting of the calendar using stylesheet parameters. In the Stylesheets.System section, see subsections that begin with "Calendar".

Calendar Events

To add events to the calendar based on events in your TMG project, you add Calendar Events via the [Add...] button on the Edit Calendar window. The Add button adds a Calendar Events subitem to the Calendar User Item that appears in the Calendar Events list on the right-hand side of the Edit Calendar window. Each Calendar Events subitem specifies a set of events.

See the Calendar Events Details section below for a more in depth description of Calendar Events.

Calendar Properties

Title

Calendars must have a Title, but the Title may or may not appear on the page. If Show Title is checked, which is the default, the title text appears above the calendar.

Caption

Captions are optional. If you enter a caption, it appears below the calendar.

Enabled

See Enabled on the User Items page.

Show Title

Calendars must have a Title, but the Title may or may not appear on the page. If Show Title is checked, which is the default, the title text appears above the calendar.

Name Option

The Name Option pull-down menu has the following choices:

Full Name
Name (Middle Initials)

When set to "Full Name", a calendar entry will include the person's full name. When set to "Name (Middle Initials)", Second Site will attempt to change any middle names to initials. If the given name field includes certain special characters, Second Site will not attempt to convert middle names to initials for that name. The special characters are ( [ " ' (left parenthesis, left bracket, double-quote, single-quote). The default value is "Name (Middle Initials)".

Calendar Events Details

For each Calendar Event item, you specify one or more filters to select a subset of TMG events. Second Site only processes events that have a regular date with a month assigned. Any patial date without a month is ignored. In addition, for each Calendar Event item you can filter the data as follows:

by Event Type (Birth, Death, Burial, etc.)
by Event Primary status
by Person (by a custom flag value)

The filters are applied in the following sequence:

As described above, the event must have a regular date. Partial dates must have a month assigned.
Event Type filter: Second Site checks the Event Type of each event. If you choose an Event Type from the Calendar Event item's Event Type pull-down menu, then the event must have the same Event Type. if you do not choose an Event Type, then the event must have an Event Type that is selected in the Database.Tags list of events.
Event Primary filter: If Primary Only is checked, the event must be primary for both principals or the event will not be processed.
Living filter: If People.Suppress Details for Living People is selected, and either principal is living, Second Site will suppress all events except for Marriage Group and Divorce Group events. Even those are suppressed if People.Suppress Marriages for Living People is also selected.
Included/Excluded filter: One of the event principals must be included on the site or the event is ignored.
Flag filter: Second Site applies the flag filter, if any, and ignores events if neither principal passes the flag filter. Only one principal must pass the filter, not both.

Show Label

If Show Label is checked, the event label will be included in the calendar entry.

Special Dates

Some events in your data might occur on February 29th, but the current year shown in the calendar may not be a leap year. In that case, Second Site will include February 29th even in non-leap years so that the February 29th events are visible. If there are no events on February 29th, then the day will only be included for leap years.
Some partial event dates will specify a month and year but not a day. Those events appear in the calendar for the given month but are not assigned to a specific day.