Help:Recurring events

From semantic-mediawiki.org

Revision as of 10:26, 29 June 2009 by Robert Murphy (Talk | contribs)
Jump to: navigation, search

A recurring event is any event that occurs more than once, according to a pre-defined rule: examples are weekly meetings, anniversaries and birthdays. In Semantic MediaWiki, the dates for a recurring events are defined using the #set_recurring_event parser function, which is placed on the page that represents the event. This function takes the following arguments, in any order:

  • property - the Date property that is being set to all the values
  • start - the first date of the series
  • end - the last date of the series (optional)
  • unit - the time unit for the event's frequency; options are year, month, week and day (optional - default is day)
  • period - the number of time units between one occurrence and the next week (optional - default is 1)
  • include - any additional dates to include in the series, separated by semicolons (;) (optional)
  • exclude - any dates to exclude from the series, separated by semicolons (optional)

The following call would define the set of all Mondays between January 4, 2010 and June 8, 2011, with the exception of March 15, 2010 and March 22, 2010, both of which are replaced by the following Tuesday:

{{#set_recurring_event:property=Has date
|start=January 4, 2010
|end=June 8, 2011
|unit=week
|period=1
|include=March 16, 2010;March 23, 2010
|exclude=March 15, 2010;March 22, 2010
}}

If no end date is set, a fixed number of dates is simply saved; this number is defined by the variable $smwgDefaultNumRecurringEvents, which has a default value of 100. There is also a maximum number of dates that can be saved using this function, regardless of the start and end date specified. This number is set by the variable $smwgMaxNumRecurringEvents, which has a default value of 500. Both values can be modified in one's LocalSettings.php file.

Personal tools