Template Recurring Event

From Wiki des DAI Makerspace
Jump to: navigation, search

This page contains changes which are not marked for translation.



Other languages:

Deutsch ? ?English

This template defines and describes a recurring event (based on Semantic MediaWiki's #set_recurring_event parser function).

Adding it to a page automatically creates a series of community calendar entries and an overview table such as the one created by Template:Event. It is not completely done yet, but works already. Have a look at "Weekly Making Hours" for a current implementation.

{{Recurring Event
|organizer=
|location=
|supervision=
|requires=
|url=
|title=
|start=
|end=
|repetitions=
|unit=
|period=
|include=
|exclude=
|description=
}}

What the Parameters Mean[edit | edit source]

  • organizer - who will be responsible for the event and can be contacted in case of questions or scheduling conflicts?
  • location - where will the events take place?
  • supervision - will someone supervise Makers who are not able to work by themselves yet (e.g. minors)?
  • requires - does the event rely on something specific, e.g. an entire room or quietness?
    • make use of this parameter to avoid conflicts with user users of a shared resource!
  • url - is there an external event page you'd like to link?
  • title - displayed <somewhere else>, the calendar entry has the name of the page you place the template on
  • start - when will the first event take place? This needs to be in MMM DD, YYYY format (e.g. Jan 01, 2015) in order to work.
  • how often should the event recur? Pick one of these parameters:
    • end if you know an end date (e.g. 2017-12-31 if it won't take place in 2018 anymore); overrides "repetitions"
    • repetitions if you know how many instances of the event should be added to the calendar
  • unit - what lies between two events? Possible values are "day", "week", "month" or "year"
    • (optional) period - how many of the units (default: 1) lie between events (e.g. "2" if your event takes place every two weeks and you entered "week" above)
    • (optional) include - which dates besides the regular rhythm should be entered (separated by semicolons)?
    • (optional) exclude - is the event going to be cancelled on any date within the regular rhythm (separated by semicolons)?
      • still uses up a "repetition" even if not shown in the calendar!
    • (optional) description - appears between the title and the info table

Recurring Event: Demonstration[edit | edit source]

This is how the template will look when rendered on a page:

Organizer(s)

Maker

Location

Maker's garage

Rhythm

every 3 week(s) since Jan 01, 2015 except Jan 22, 2015 (see calendar)

Supervision

no, this is just a demo

Requirements

computer

(what's an "event"?)


Automatically creating calendar entries works as well, but "Template:" pages seem to be filtered out.

Further Development[edit | edit source]

  • improve "rhtyhm", e.g. "every Wednesday" rather than "every 1 week(s)" or have users put it into "description" by hand
  • include end date in rendering (how? would have to be calculated...)
  • find out what exactly "title" does

This template is arguably not the prettiest, got any additional ideas? The most important thing is that it works.