Quick Calendar Plugin

<--
   Contributions to this TWiki plugin are appreciated. Please update the plugin page at
   http://twiki.org/cgi-bin/view/Plugins/QuickCalendarPlugin or provide feedback at
   http://twiki.org/cgi-bin/view/Plugins/QuickCalendarPluginDev.
   If you are a TWiki contributor please update the plugin in the SVN repository.
-->

Introduction

Generates a monthly calendar and creates link anchors from each day and week to somewhere else. A user can then place anchors further down in the page and the calendar date will link to them. The generated anchors correspond to ISO 8601 standard.

This plugin is one of the building blocks for a time management plugin I've written. But it might be useful by itself.

This plugin is kind of the "reverse" of the TWiki:Plugins.CalendarPlugin (which may also be of interest) which generates a custom calendar from wiki text. This TWiki:Plugins.QuickCalendarPlugin generates a fixed calendar which links to wiki text.

For recent changes, see TWiki:Plugins.QuickCalendarPluginDev.

Syntax Rules

• Use the variable %CAL% or with arguments, %CAL{settings}% where settings are listed below.
  • Without settings, a linkified calendar of the current or specified month is displayed.
• Additional Settings (all are optional):
  • month="sep" or month="september" or month="9"
  • year="yyyy" (must be a four digit year! "01" would be 01 C.E. )
  • URL specification: href="some url here"
    • Dates in calendar will link to some url hereYYYYMMDD or some url hereYYYYWW
      • Default URL link in anchor mode will be the current web.topic with #CalDateYYYYMMDD or #CalDateYYYYWW anchors
      • Default URL link in non anchor mode will be the wiki username with YYYYMMMDD or YYYYWW appended.
  • doy="on" will display dates in day-of-the-year format (see example below). Default: off
• Relative Arguments (all are optional):
  • month="+4" or month="-6"
  • year="+2" or year="-1"
• See examples below.

Examples

Example 1: Current Month

By default the plugin displays the current month:

You Type: %CAL%

Example 2: Specific Month and/or Year

You Type: %CAL{month="sep" year="2003"}%

Example 3: Day-of-Year mode

If you like, you can specify doy="on" as an argument, and get a calendar which uses days of the year. This is handy for some things, like astronomy. Type ==

<-- Calender rendered by TWiki Plugin: Quick Calendar -->

<-- Calender rendered by TWiki Plugin: Quick Calendar -->

Example 4: Anchoring

• Each month creates both day and week anchors (for name="#anchor"), either (a) within the current topic in anchor mode, (b) a topic of the user's wiki name in non anchor mode, or (c) the user specified href.
  • The calendar days will link to the day anchors.
    • Click on the Sept 27th above to see the effect (anchor mode).
  • The week column will link to the week anchors.
    • Click on "2003.38" above to see the effect (anchor mode).
• Specify a custom url with the syntax: href="link"

This line contains an anchor to "work week" 38 (in year 2003)

• This is a very simple example of text following the week 38 anchor..

This line contains an anchor to the date 09/27/2003

• This is a very simple example of text following the date anchor..

QuickCalendarPlugin Global Settings

• One line description, is shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = An anchor linkified, internally generated, minimal calender

• Debug plugin:
  • Set DEBUG = 0

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

• Run configure for automated install, or do a manual install:
• Download the .PM file from TWiki:Plugins.QuickCalendarPlugin (see below).
• "Edit" this topic and copy & paste the wiki text into your own site.
• Verify the created files exist in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/QuickCalendarPlugin.txt	Plugin topic
  lib/TWiki/Plugins/QuickCalendarPlugin.pm	Plugin Perl module

• Test if the installation was successful:
  • Currently active plugins are: FormQueryPlugin, SpreadSheetPlugin, ActionTrackerPlugin, BackupRestorePlugin, BreadCrumbsPlugin, CalendarPlugin, ChartPlugin, ColorPickerPlugin, CommentPlugin, DBCachePlugin, DatePickerPlugin, EditTablePlugin, ExplicitNumberingPlugin, FormPlugin, GluePlugin, HeadlinesPlugin, InterwikiPlugin, JQueryPlugin, JqPlotPlugin, LdapContribAdminPlugin, LdapNgPlugin, MacrosPlugin, NewUserPlugin, PreferencesPlugin, QuickCalendarPlugin, RedirectPlugin, RenderListPlugin, RevisionLinkPlugin, SetGetPlugin, SlideShowPlugin, SmiliesPlugin, SubscribePlugin, TWikiSheetPlugin, TablePlugin, TagMePlugin, TinyMCEPlugin, TreeBrowserPlugin, TwistyPlugin, VotePlugin, WatchlistPlugin, WebPermissionsPlugin, WysiwygPlugin
  • Calendars should appear below.

The following should display a calendar of Dec 2006

<-- Calender rendered by TWiki Plugin: Quick Calendar -->

The following should display a small calendar of month+1

<-- Calender rendered by TWiki Plugin: Quick Calendar -->

The following should display a small calendar of month-14/year+1 (two months ago)

<-- Calender rendered by TWiki Plugin: Quick Calendar -->

The following should display a small calendar of month=12/year=2001

<-- Calender rendered by TWiki Plugin: Quick Calendar -->

Plugin Info

Plugin Author:	TWiki:Main.JonathanCline
Copyright:	© 2003 TWiki:Main.JonathanCline © 2007-2011 TWiki:TWiki.TWikiContributor
License:	GPL (GNU General Public License)
Plugin Version:	2011-01-13 (V1.4)
Change History:	<-- versions below in reverse order -->
2011-01-13:	TWikibug:Item6530: Doc improvements; changing TWIKIWEB to SYSTEMWEB -- TWiki:Main.PeterThoeny
2003-10-10:	1.300 add doy, add internal enhancements, fix ww numbering
2003-09-08:	1.220 cosmetic upgrades & enhancements by TWiki:Main/WillNorris
	1.210 bug fixes and specific date selection
2003-08-23:	1.100 initial
CPAN Dependencies:	none
Other Dependencies:	POSIX package in Perl (should be standard)
Perl Version:	5.005
Plugin Home:	TWiki:Plugins/QuickCalendarPlugin
Feedback:	TWiki:Plugins/QuickCalendarPluginDev

Related Topics: TWikiPreferences, TWikiPlugins