Interwiki Plugin

The InterwikiPlugin links ExternalSite:Page text to external sites based on aliases defined in the Inter Wikis topic. This plugin is inspired by UseMod Wiki's inter-wiki links, http://www.usemod.com/cgi-bin/wiki.pl?InterWiki.

Syntax Rules

• Enter ExternalSite:Page to create a link that points to the Page on the ExternalSite server.
• Enter [[ExternalSite:Page][any label]] to specify a custom label.
• All ExternalSite aliases are defined in the Inter Wikis topic.
• Add and edit aliases in Inter Wikis.
• Each entry must be of format:
  | External site alias | URL | Tooltip help text |.
• Site aliases must start with an upper case letter and may contain alphanumeric letters.
• The URL and Tooltip Text may contain optional $page fromatting tokens; the token gets expanded to the page name.

For Foswiki and TWiki sites, both the web and the topic have to be specified: Foswiki:Webname/SomePage

Foswiki:Extensions/InterwikiPlugin or Foswiki:Extensions.InterwikiPlugin

InterwikiPlugin Settings

You can override the default settings using preferences. These preferences can be set in your Site Preferences, or in WebPreferences, or in individual topics.

Preference	Use to	Default
INTERWIKIPLUGIN_RULESTOPIC	Change the link rules topic name	Inter Wikis
INTERWIKIPLUGIN_INTERLINKFORMAT	Set the interlink format	<a href="$url" title="$tooltip" class="interwikiLink"><noautolink>$label</noautolink></a>

The INTERWIKIPLUGIN_INTERLINKFORMAT supports a number of formatting tokens:

Token	Meaning
$site	Site alias
$page	Page (part after colon)
$url	Site URL (might contain $page)
$label	Equal to $site:$page
$tooltip	Tooltip message

Plugin Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

• Test: If the Plugin is correctly installed, this Wiki:InterWiki link should point to http://c2.com/cgi/wiki?InterWiki topic - try it out.

Plugin Info

Author:	Foswiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny
Copyright:	© 2001-2007, Andrea Sterbini, Peter Thoeny (TWIKI.NET), Project Contributor
License:	GPL (GNU General Public License)
Version:	9483 (2010-10-03)
Release:	12 Jul 2010
Change History:
12 Jul 2010:	Foswiki:Main.AndrewJones - Check access controls on InterWikis topic
10 Jul 2010:	mod_perl and FastCGI compatible
20 Sep 2009:	Version from 15 Apr now included with Foswiki 1.0.7.
15 Apr 2009:	Foswiki:Main.CrawfordCurrie - removed plugin preferences from this topic
16 Dec 2008:	Foswiki:Main.KennethLavrsen - Foswiki version - no features changed
03 Aug 2008:	TWiki 4.2.1 release version
22 Jan 2008:	TWiki 4.2.0 release version
25 Nov 2007:	15752 - TWikibug:Item5006 - Renamed Bugs rule to TWikibug rule (PTh)
13 Aug 2007:	14545 - TWikibug:Item4451 - Added Bugs: rule (TWiki:Main.CrawfordCurrie)
11 Aug 2007:	14538 - Fixed broken ISBN link (TWiki:Main.PeterThoeny)
08 Nov 2006:	11935 - Added css class="interwikiLink" (TWiki:Main.PeterThoeny)
07 Nov 2006:	11924 - Added INTERLINKFORMAT; removed redundant SUPPRESSTOOLTIP; allow @ signs in page part of interwiki link; support single digit page part (TWiki:Main.PeterThoeny)
26 Feb 2005:	1.008 TWiki:Main.CrawfordCurrie cleaned up code and made Dakar-ready
25 Aug 2004:	1.005 TWiki:Main.PeterThoeny updated Inter Wikis link rules (no code change)
09 Mar 2004:	Internal changes: Use only official TWiki::Func Plugin API; for increased speed, moved Interwiki link handling from outsidePREHandler to startRenderingHandler
16 Feb 2004:	Support [[Site:Page][label]] Interwiki links (PTh); use TWiki::Func interface for I18N regular expressions (Walter Mundt)
18 Jan 2003:	Allow number sign # in Page name (PTh)
31 Aug 2002:	Allow percent sign % in page name (PTh)
27 Jul 2001:	Allow numbers 0-9 in site name
26 Jul 2001:	Fixed alternating missed link bug due to greedy $postfixPattern (fix by Richard Donkin)
14 Jul 2001:	Changed to plug & play
16 Jun 2001:	Made tooltips optional; prevent Module::Sub type of link
12 Jun 2001:	Added optional tool tips (IE only); added the link rules topic name variable; added flexible link patterns; optional $page in URL
10 Jun 2001:	Changed rules topic to table-based syntax
20 Feb 2001:	TWiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny - Initial version
Plugin Home:	http://foswiki.org/Extensions/InterwikiPlugin
Support:	http://foswiki.org/Support/InterwikiPlugin