Update Info Plugin

UpdateInfoPlugin will add a "new" or "updated" icon after a WikiWord link if a %ISNEW% tag is used after the link, and the linked topic was recently touched.

WikiWord %ISNEW% will be expanded to:

• WikiWord - if the topic is neither new nor updated
• WikiWord - if the topic is younger than five days and is revision 1.1
• WikiWord - if the topic revision is higher than 1.1 and the topic was updated during the last five days

Default values for the "version" and "days" parameters are set sitewide here in UpdateInfoPlugin#PluginSettings, but can be overridden pr. topic (or in WebPreferences pr. web), by setting variables UPDATEINFOVERSION and/or UPDATEINFODAYS.

Syntax Rules

The %ISNEW%-tag must be written after a WikiWord separated by exactly one space.

Full %ISNEW% syntax takes one or two options:

• days: Changes the number of days a Topic is marked as new or updated
• version: Specifies which revision is still considered to be new

Full syntax overrides site/topic defaults.

Syntax Examples

• MyTopic %ISNEW%
• Web.ToPic %ISNEW%
• Gr�dWeb.Bl�B�rGr�d %ISNEW% (I18N characters in WikiWords and WebNames are matched)
• TopIc %ISNEW{days="15"}%
• TopiC %ISNEW{days="20" version="1.4"}%

UpdateInfoPlugin supports these TWikiML link syntaxes:

• WikiWord
• (WikiWordAs)WebName.WikiWord
• [[WikiWord][link text]]
• [[WebName.WikiWord][link text]]
• [[link text]]
• [[link-text]] (links to non-WikiWord topics, i.e. topic names containing special chars like "-")
• [[singleword]]
• WIK IWO RDS (abbreviations / acronyms)

(All followed by the %ISNEW% syntax).

Examples (Works if installed)

• UpdateInfoPlugin %ISNEW%
• Main %ISNEW%
• WebHome %ISNEW{days="15"}%
• TWikiPreferences %ISNEW{days="20" version="1.4"}%
• UpdateInfoPluginTest %ISNEW% (Edit and save the Sandbox.UpdateInfoPluginTest topic, and it should be highlighted with a icon)

UpdateInfoPlugin Settings

• One line description, is shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Add a %ISNEW% tag after a WikiWord to get a visual display of whether the linked topic was created or updated recently

• Sitewide "version" default
  • Set UPDATEINFOVERSION = 1.1

• Sitewide "days" default
  • Set UPDATEINFODAYS = 5

• Debug plugin: (See output in data/debug.txt)
  • Set DEBUG = 0

Plugin Installation Instructions

• Just unzip the package as usual.

Plugin Info

-- TWiki:Main.ChrisHuebsch - 07 Apr 2005