Extension:ImageLink

From MediaWiki.org

Manual on MediaWiki Extensions
List of MediaWiki Extensions

ImageLink Release status: stable
Implementation	Parser function
Description
Author(s)	Jean-Lou Dupont
Version	1.6.0
MediaWiki	1.8.2, 1.9.3, 1.10, 1.11, 1.12
Download	SVN See SVN ($Id: ImageLink.doc.wikitext 961 2008-04-03 14:43:28Z jeanlou.dupont $)

ImageLink provides a clickable image link using an image stored in the Image namespace or accessible through an interwiki link and an article title (which may or may not existin the database).

The extension also supports the link-less mode thereby enabling a one-stop solution for both link and link-less requirements.

Furthermore, the extension also supports events but only on edit protected pages.

Lastly, the extension provides the parser function #iconlink which provides a clickable URL with the site's favicon.ico as image.

[edit] Usage Note

Please use the #img parser function instead of the older #imagelink one.

[edit] Usage

[edit] Local Image

• {{#imagelink: image-page-name | page name |alternate text | width | height | border }}
• {{#img: image=image-page-name [|page=page-to-link-to] [|alt=alternate-text] [|height=height-parameter] [|width=width-parameter] [|border=border-parameter] [|title=title-parameter] [|default-image]}}

See W3Schools on IMG tag for more details.

[edit] Link-Less option

If no page name is given, then no anchor (i.e. HTML < a> element) will be generated.

[edit] Default Image

When the parameter image points to a non-existing image page, then default parameter (if specified) is used as image page. Note that for interwiki link, this option is not supported.

[edit] InterWiki accessible Image

• {{#imagelink: interwiki_prefix:image-page-name | page name | alternate text | width | height | border }}
• {{#img: image=interwiki_prefix:image-page-name ... }}

[edit] Event Parameters

Event parameters supported: onchange, onsubmit, onreset, onselect, onsubmit, onreset, onselect, onblur, onfocus, onkeydown, onkeyup, onkeypress, onclick, ondblclick, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup.

[edit] Examples

• {{#imagelink: New Clock.gif | Admin:Show Time | Current Time | 32 | 32 | 2 }}
• {{#img: image=Star.png | page=Starred Page | height=100% | title=Some starred page }}
• {{#iconlink: site=http://www.yahoo.com | domaincheck=y | target=_blank | content=YAHOO! }}

[edit] Dependency

• StubManager extension

[edit] Installation

See the Mediawiki Extension table entry "download" above.^[1]

[edit] LocalSettings.php

Extension:ExtensionManager: See footnote^[2]

• Add the following to LocalSettings.php if the extension was downloaded from Jean-Lou Dupont's MediaWiki SVN directory (link in the download entry of the table above)^[2]:

require_once( "$IP/extensions/ImageLink/ImageLink.php" );

pear channel-discover mediawiki.googlecode.com/svn

pear install mediawiki/ImageLink

require 'MediaWiki/ImageLink/ImageLink.php';

pear clear-cache

pear upgrade --force mediawiki/ImageLink

[edit] RSS feed

To keep kept up-to-date with this channel, use the following RSS feed.

[edit] Notes

1. ↑ The most recent release is always available through the extension's PEAR and SVN repositories. This page is not necessarily up-to-date.
2. ↑ ^{2.0 2.1 2.2} Extension:ExtensionManager does not require any modification to LocalSettings.php because ExtensionManager includes the extension.
   Note that if PHP code caching is in place (e.g. APC, eAccelerator), then to successfully complete the installation a cache flush might be needed.
3. ↑ Modifications to LocalSettings.php is only necessary if not using Extension:ExtensionManager

[edit] Optional Dependency

The PEAR package Validate can be installed: the extension performs additional sanity check for {{#iconlink}} site parameter.

[edit] History

[edit] Sites using this extension

• author's web site