Jump to content

Extension:Link Attributes

From mediawiki.org
Warning Warning: This extension is often confused with the similarly named Extension:LinkAttributes.
MediaWiki extensions manual
Link Attributes
Release status: stable
Implementation Parser function
Description Adds support for the rel, rev and class attributes on links
Author(s) Toby Inkster, Dennis Roczek, Sam Wilson
Latest version 1.1
MediaWiki >= 1.35.0
Database changes No
License GNU General Public License 2.0 or later
Download
Quarterly downloads 3 (Ranked 129th)
Translate the Link Attributes extension if it is available at translatewiki.net

This extension adds support for the rel, rev and class attributes on external links:

  • rel – The relationship of the linked URL as space-separated link types.
  • rev – Specified a reverse link; the opposite of the rel attribute. Deprecated for being very confusing.
  • class – A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements.

Usage

[edit]

The syntax is a little unorthodox. To set the rel attribute, place one or more tokens in double-parentheses at the end of the link title. e.g.:

  [http://tobyinkster.co.uk/ My website((me home))]

The above would be converted to the following link:

  <a href="http://tobyinkster.co.uk/" rel="me home" class="external">My website</a>

To set the class attribute, the same syntax is used, but tokens which represent classes are prefixed with a dot:

  [http://tobyinkster.co.uk/ My website((me .class1 home .class2))]

Becomes:

  <a href="http://tobyinkster.co.uk/" rel="me home" class="external class1 class2">My website</a>

Similarly, prefixing with a tilde (~) sets the rev attribute.

Tokens may be prefixed by a minus sign (-) to indicate that you don't want to add the token, but remove it. For example:

  [http://tobyinkster.co.uk/ My website((me -.external home))]

Becomes:

  <a href="http://tobyinkster.co.uk/" rel="me home">My website</a>

The "nofollow" rel token is considered untouchable though.

Installation

[edit]
  • Download and move the extracted Link_Attributes folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Link_Attributes
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'Link_Attributes' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

See also

[edit]
  • Extension:LinkAttributes – a different syntax for adding the attributes.
  • T35886