Difference: InterwikiPlugin (r17 vs. r16)

Interwiki Plugin

Link ExternalSite:Page text to external sites based on aliases defined in a rules topic

Introduction

The InterwikiPlugin links ExternalSite:Page text to external sites based on aliases defined in the InterWikis 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 InterWikis topic.
  • Add and edit aliases in InterWikis.
  • 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 variables; the variable gets expanded to the page name.
  • HELP For TWiki sites, both the web and the topic have to be specified: TWikisite:Webname/SomePage

InterwikiPlugin Settings

Plugin settings are stored as Preferences variables. To reference a plugin setting write %<plugin>_<setting>%, for example, %INTERWIKIPLUGIN_SHORTDESCRIPTION%

  • One-line description, shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Link ExternalSite:Page text to external sites based on aliases defined in a rules topic
  • Link rules topic name: (default is InterWikis)
    • Set RULESTOPIC =
  • Inter-link format, with variables:
    $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

ALERT!ALERT! Note:This plugin is included in the TWiki distribution package. You do not need to install it unless you want to upgrade to a newer version. NOTE: This Plugin is included in the TWiki distribution package. You do not need to install it unless you want to upgrade to a newer version.

  • Download the ZIP file from the TWiki:Plugins web (see below)
  • Unzip InterwikiPlugin.zip in your TWiki installation directory. Content:
    File:Description:
    data/TWiki/InterwikiPlugin.txt Plugin topic
    data/TWiki/InterWikis.txt Link rules topic for inter-site links
    lib/TWiki/Plugins/InterwikiPlugin.pm Plugin Perl module
  • 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

Plugin Author: TWiki:Main.AndreaSterbini TWiki:Main/AndreaSterbini , TWiki:Main.PeterThoeny TWiki:Main/PeterThoeny
Copyright: 2001-2009, 2001-2009 Andrea Sterbini, Peter Thoeny ( TWIKI.NET
2001-2010 Peter Thoeny (Twiki, Inc.), TWikiContributor
2001-2010 TWiki:TWiki/TWikiContributor
License: GPL (GNU General Public License)
Plugin Version: 28 Feb 2009 2010-05-15 18695 (2010-05-29) 17852 (02 Sep 2009)
Change History:  
28 2010-05-15: Feb 2009: 17851 - TWikibug:Item6433TWikibug:Item5025 - doc improvements; replacing TWIKIWEB with SYSTEMWEB - Added = and & to page regex, allowing links such as Site:ID=1234&sel=56
03 Aug 2008: 28 Feb 2009: TWiki 4.2.1 17851 - release version TWikibug:Item5025 - Added = and & to page regex, allowing links such as Site:ID=1234&sel=56
22 Jan 03 Aug 2008: TWiki 4.2.0 4.2.1 release version
25 Nov 2007: 22 Jan 2008: 15752 - TWiki 4.2.0 release version TWikibug:Item5006 - Renamed Bugs rule to TWikibug rule (PTh)
13 Aug 25 Nov 2007: 14545 15752 - TWikibug:Item4451 TWikibug:Item5006 - Added Bugs: Renamed Bugs rule ( to TWikibug rule (PTh) TWiki:Main.CrawfordCurrie)
11 13 Aug 2007: 14538 14545 - Fixed broken ISBN link ( TWiki:Main.PeterThoeny TWikibug:Item4451 - Added Bugs: rule (TWiki:Main.CrawfordCurrie)
08 Nov 2006: 11 Aug 2007: 11935 14538 - Added css Fixed broken ISBN link ( class="interwikiLink" (TWiki:Main.PeterThoeny)
07 08 Nov 2006: 11924 11935 - Added INTERLINKFORMAT; css removed redundant SUPPRESSTOOLTIP; allow @ signs in page part of interwiki link; support single digit page part ( class="interwikiLink" (TWiki:Main.PeterThoeny)
26 Feb 2005: 07 Nov 2006: 1.008 11924 - Added INTERLINKFORMAT; removed redundant SUPPRESSTOOLTIP; allow @ signs in page part of interwiki link; support single digit page part ( TWiki:Main.CrawfordCurrie TWiki:Main.PeterThoeny cleaned ) up code and made Dakar-ready
25 Aug 2004: 26 Feb 2005: 1.005 1.008 TWiki:Main.PeterThoeny TWiki:Main.CrawfordCurrie updated cleaned up code and made Dakar-ready InterWikis link rules (no code change)
09 Mar 25 Aug 2004: Internal 1.005 changes: Use only official TWiki::Func Plugin API; for increased speed, moved Interwiki link handling from outsidePREHandler to startRenderingHandler TWiki:Main.PeterThoeny updated InterWikis link rules (no code change)
16 Feb 09 Mar 2004: Support Internal changes: Use only official TWiki::Func Plugin API; for increased speed, moved Interwiki link handling from outsidePREHandler to startRenderingHandler [[Site:Page][label]] Interwiki links (PTh); use TWiki::Func interface for I18N regular expressions (Walter Mundt)
18 Jan 2003: 16 Feb 2004: Allow Support number sign # [[Site:Page][label]] in Page name (PTh) Interwiki links (PTh); use TWiki::Func interface for I18N regular expressions (Walter Mundt)
31 Aug 2002: 18 Jan 2003: Allow percent number sign % # in page Page name (PTh)
27 Jul 2001: 31 Aug 2002: Allow numbers percent sign 0-9 % in site page name (PTh)
26 27 Jul 2001: Fixed alternating Allow numbers missed link bug due to greedy $postfixPattern (fix by Richard Donkin) 0-9 in site name
14 26 Jul 2001: Changed Fixed alternating missed link bug due to plug & play greedy $postfixPattern (fix by Richard Donkin)
16 Jun 14 Jul 2001: Made tooltips optional; prevent Changed to plug & play Module::Sub type of link
12 16 Jun 2001: Added optional tool tips Made tooltips optional; prevent (IE only); added the link rules topic name variable; added flexible link patterns; optional $page Module::Sub in URL type of link
10 12 Jun 2001: Changed Added optional tool tips (IE only); added the link rules topic to table-based syntax name variable; added flexible link patterns; optional $page in URL
20 Feb 10 Jun 2001: TWiki:Main.AndreaSterbini Changed rules topic to table-based syntax , TWiki:Main.PeterThoeny - Initial version
CPAN Dependencies: 20 Feb 2001: none TWiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny - Initial version
Other CPAN Dependencies: none
Perl Version: Other Dependencies: 5.0 none
Benchmarks Perl Version: : GoodStyle 5.0 100%, FormattedSearch 98%, InterwikiPlugin 98%
Plugin Home: Benchmarks: http://TWiki.org/cgi-bin/view/Plugins/InterwikiPlugin GoodStyle 100%, FormattedSearch 98%, InterwikiPlugin 98%
Feedback: Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginDev http://TWiki.org/cgi-bin/view/Plugins/InterwikiPlugin
Appraisal: Feedback: http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginAppraisal http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/InterwikiPluginAppraisal

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences, InterWikis

-- TWiki:Main.PeterThoeny - 28 Feb 2009

 
This site is powered by the TWiki collaboration platformCopyright © 1999-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.InterwikiPlugin.