Hilfe:Calendar Extension

Aus HPGR
Wechseln zu: Navigation, Suche

Grundlagen

Einen Kalender erstellt man, indem man die eine Seite mit dem Namen Kalender:Kalendername erzeugt und darin folgenden Code unterbringt:

<calendar /> 
<calendar name="Kalendername" /> 

Die beiden nachfolgenden Beispiele zeigen, wie die Seitenstruktur innerhalb von Kalenderseiten aufgebeut ist. Ein Termin ist immer als Seite gespeichert, z.B. auf Kalender:Kalendername/Mein Kalender/Datum:

<calendar name="Kalendername" />
    Kalender:Kalendername/Kalendername/12-1-2008 -Event 1
<calendar name="Anderer Kaledername" />
    Kalender:Kalendername/Anderer Kalendername/12-1-2008 -Event 1

Termine

Termine können über den "Termin eintragen" Link an jedem Tag, oder über den "template load" button (wenn aktiv) erzeugt werden. Beide Varianten funktionieren nebeneinander.

Die erste Zeile eines Events wird im Kaleder eingeblendet

Beispiel:

Kino 20:00 
Wir gehen ins Kino und schauen den tollen $Film

zeigt dann im Kalender

Kino 20:00


Kalender abonieren

Man kann die Daten aus einem Kalender in einen anderen Kalender importieren indem man die Parameter "subscribe" oder "fullsubscribe" verwendet. So erzeugt man einen eigenen Kalender der die Daten aus einem anderen Kalender enthält.

Wichtig: Wenn der aufgerufenen Kalender mit speziellen Parametern wie "usetemplates" benutzt wird, müssen diese auch im abbonierendem Kalender sein.

Beispiel:

<calendar name="Support" subscribe="Calendars:Acme Company/Sales" />

Parameter

Weitere Parameter (wird noch übersetzt) Please use quotes for any parameter that may contain a space

Parameters Description Example Default Version
name=<"value"> Name of your calendar name="Family Events" Public 2.0.4
disableaddevent The "Add Event" link is removed from the calendar. disableaddevent enabled 2.0.4
yearoffset=<value> Sets the year dropdown +/- value. yearoffset=3 2 (+/- years) 2.0.4
date=<value> Display a single day listing.
Values can be: today, tomorrow or a datevalue
date=tomorrow or date=1-1-2010 off - normal month view 2.0.4
defaultedit Whenever a user clicks an event, the event defaults to edit mode. defaultedit off - page view 3.0
charlimit=<value> Sets the calendar event name max length charlimit=30 20 charactors 3.0
subscribe=<"value"> Allows the calendar to subscribe to existing events from other calendar(s); subscribe to additional calendars delimited by a comma within the ; add events go to your calendar only subscribe="Main Page/Name, SomePage/Name" not subscribed 3.2
usetemplates This allows the use of one page to add events by storing many events in one location. The templates are identifed by the button with the month name in the lower right section of the calendar. usetemplates disabled 3.2
locktemplates This disables the template button and template links; template events remain visable locktemplates off 3.2
fullsubscribe=<"value"> Allows the calendar to subscribe impersonate another calendar; add events go to the subscribed calendar only; you can use subscribe mode if needed as well fullsubscribe="Tech Group/Team Calendar" not subscribed 3.2
disablelinks This removes the ability to click/edit an existing event created via 'add event'; use 'locktemplates' to disable template created links disablelinks off - allow links/edits 3.2
usemultievent Users clicking 'add event' opens the last entered event; you must place each event title in ==event1==, ==event2== multiple event formatting as describle later in this help. usemultievent disabled - 'add event' will create a new event pages 3.2
maxdailyevents=<value> Set the limit of how many "add event" unique pages are created; this doesn't include template or ==event== type entries. This in sense forces users to use ==event1==, ==event2== formatting maxdailyevents=5 5 events 3.2
disablestyles Disable the 'event style' button and disables keyword search styling; inline direct syles are not effected. disablestyles enabled, but does nothing until keyword styles are added 3.2
lockdown Basically puts the calendar into a read-only state; this includes 'disableaddevent', 'disablelinks' and 'locktemplates' lockdown false - no lockdown 3.2
enablesummary=<value> Enables event summaries to display below the eventname; value is max character length of the summary enablesummary=100 disabled 3.4.2
useeventlist=<value> Enabling this displays a vertical list of all events within a defined amount of days. This hits the db alot as it must search events for every single day in the amount of future days defined... I have the code limited to 120 days, but use the least days needed. useeventlist=30 disabled 3.4.2
useconfigpage Use alot of parameters? Use the config page instead. Enter each parameter followed by the enter key into the config page. The disablelink option removes the btn and text links to the config page. You can use the config page and <calendar /> options together, but the <calendar /> options overwrites the config page options. useconfigpage
useconfigpage=disablelink
off 3.4.2
css=<value> Create your own css design based off the default.css file. Rename it and load it via this parameter. I may change the default.css page during releases, so use this as long as you dont mind re-writing your custom css after an upgrade... (= css="olive.css" default.css 3.5
disabletimetrack Time tracking is enabled by default and looks for double colons (::vacation-8) or (::vacation:8). This will create a dynamic listing of trackable events below the calendar. disabletimetrack enabled 3.5
enablerepeatevents Repeating events are created using using (5# Vacation) within normal events. The code looks up the previous months and applies carry-over events to the current month. It may increase the calendar load time as it looks back 15 days into the previous month for carry over repeating events. enablerepeatevents disabled 3.5
enablelegacy=<"value"> Load events from the older "Title (12-1-2008) - Event 1" format. These older events were used in some version of 3.2 and older. This may increase calendar load times as it much search for older style events and newer events. The optional parameter sets an effective (last) date on which to lookup the older events. enablelegacy=12/15/2008 disabled 3.5.0.1
mod: 3.6
diablemodes This removes the 'year', 'month', 'week' buttons from the top of the respective pages. diablemodes enabled 3.6
5dayweek This sets the 'week' mode calendar to not display weekends 5dayweek full week 3.6
week or year These parameters default the calendar into that requested mode year month mode 3.6
ical=<value> This enables the iCalendar load tool in full calendar mode. Currently this will load 'DTSTART', 'DTEND', 'SUMMARY', 'DESCRIPTION' and most standard 'RRULE' logic. The optional value is 'overwrite'. Please see iCal readme for more info. ical disabled 3.6
disablerecurrences This skips any RRULE recurrences stored in the 'page/name/recurrences' page. The page contains all imported ical repeating rules (RRULE). disablerecurrences disabled 3.6.0.2
simplemonth Creates a simple month that displays only clickable numberic days. This would best be used wraped in a tag to create "mini-calendar" views.
simplemonth normal mode 3.7


Multiple Events

In this example, two calendar events are created using the same page. The == event == can be used to create these mulitple events per page. However, you can still create new page events by clicking Add Event.

In this example, Picnic and Party will show up on the same day.

==Picnic==
Bring food!
==Party==
Bring drinks

Repeating Events

Repeating events is not an easy task to handle via "wiki" page structure. However, I did come up with a way... The below example will create 5 repeating Vacation events in the caledar. You MUST enable the functionality by adding enablerepeatevents to your parameter tag or config page.

5# Vacation

Recurrence Event

Recurrence type events are traditional repeating yearly events like holidays, birthdays, etc. To create a recurrence event, choose 'add event' and add the following trigger syntax:

##My Birthday

This will convert the event into an vCalendar RRULE event and store it into the 'page/name/recurrence' wiki page. This is also where any ical recurrence events are stored.

Template Events

The template button (if enabled) allows users to add a bunch of events into one page. Only one template is created per month/year. This can be used along with all other event types.

The day and the event must be seperated by an '#' as shown in the example. You can also create duplicated days. The days do not have to be in order

1# Vacation
2# Holiday
7# Election Day
7# Office Closed
31# Half Day
19# Appointment
20-25# Hiking Trip <-- multiple day event

Colors and Formatting

  1. The calendar supports most of the basic MediaWiki text/font properties including the 'ticks' for italic and bold.
    • '''<font color=red>vacation</font>'''
    • Vacation time!! --> <span style="color:red;background:yellow">Vacation time!!</span>
  2. Setup the event style' page by adding as many 'styles' as you wish. These styles are based on keyword matches, so be wary of what words you choose... The styles follow standard html/css style properties.
    • syntax: keyword:: style1; style2; etc
      • myStyle:: color:green; text-decoration:line-through; --> Whatever
      • birthday:: color:red; font-style: bold; --> My Birthday
      • sick:: color: green;background-color: yellow --> Out Sick today
      • vacation:: color: red; font-style: italic --> Vacation to Florida!


I'm not sure how far and how many variation of the css and/or Wiki formatting will go, but I've tested a good portion of the standard text properties. (<div> is giving me an issue at this time though... but <span> works just fine!)

Time Tracker

You can keep simple time tracking of events by formatting the event as below. This will track any dynamically created event in a simple table below the calendar in full mode only.

::Vacation: 8 or ::Vacation -8
::Team Project 1 - 3
::Sick : 4

Note that events created using the 'add event' link only track time for that month. If you want to track a years total, you need to enable and use month templates (usetemplates)


vCalendar (iCal) Support

The calendar supports the basic importing of vCalendar formatted files. The import utility is enabled by adding ical or ical=overwrite to your parameter string or config file settings.

The calendar excepts the following vCalendar formats

DTSTART
DTEND
SUMMARY
DESCRIPTION (not with RRULEs though)
RRULE

The RRULE evaluates basic calendar event logic only... nothing complex like "every 3rd Monday of every-other month". It does handle typical repeats like Thanksgiving, Mothers Day, etc that required logic like "the 4th Thursday of November" or "the last Monday of March" kinda logic. Basically, it should capture most repeating events like birthdays and holidays.


The RRULE (repeating) events are stored in a subpage called recurrence'. Basically, in the following format page/calendarname/recurrence. You can manually edit or delete these as needed. If you use the ical=overwrite option, it deleted the data before writing in the new ical data.


Imported events without the RRULE are created in the calendar as normal pages in the -Event 0 page for the respective day.

Hilfe Dieser Artikel ist eine Hilfedatei und soll Autoren beim Umgang mit der Software unterstützen. Hilfe