Erweiterung:LinkTarget

Diese Erweiterung wird vom WikiTeq-Team professionell gewartet.

WikiTeq provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.

MediaWiki-Erweiterungen

LinkTarget Freigabestatus: stabil
Einbindung	MeinWiki
Beschreibung	Adds a target attribute to specified links
Autor(en)	Ike Hecht (TosfosDiskussion)
Betreuer	WikiTeq team
Letzte Version	0.2.0 (14. Dezember 2020)
Kompatibilitätspolitik	Für jede MediaWiki-Version, die ein Long Term Support Release ist, existiert ein entsprechender Zweig in der Erweiterung.
MediaWiki	1.35, 1.39
Datenbankänderungen	Nein
Lizenz	GNU General Public License 2.0 oder neuer
Herunterladen	Erweiterung herunterladen Git [?]: Repository durchsuchen (Phabricator · GitHub) Code-Review Ergänzungen und Änderungen Download source tarball
Parameter $wgLinkTargetParentClasses $wgLinkTargetDefault
Verwendete Hooks OutputPageParserOutput
Übersetze die LinkTarget-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme	Offene Aufgaben · Einen Fehler melden

The LinkTarget extension allows admins to add a target attribute to internal and external links. That can be used to, for example, open internal and external links in new windows.

This extension was created for WikiWorks.

Installation

• Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens LinkTarget im Ordner extensions/ ablegen.
  Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/LinkTarget
  

• Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:

  wfLoadExtension( 'LinkTarget' );
  $wgLinkTargetParentClasses = ' /*ENTER SOME CLASSES HERE*/ ';
  

• Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

Konfiguration

Name	Default	Description
$wgLinkTargetParentClasses	[]	The descendants of elements of this class will have their target attribute set by the extension. Expects an array with the format: [ target => [ classes ], target => [ classes ], ... ] If target is not specified or is invalid, the target will be set to $wgLinkTargetDefault. Note that it is also valid to specify one class as a string, instead of an array of classes.
$wgLinkTargetDefault	_blank	The default target for parent classes that do not have a valid target specified. Can be set to one of the following: _blank, _self, _parent, _top.

Beispiele

Example 1: Open specific internal/external links in new windows

In LocalSettings.php:

$wgLinkTargetParentClasses = [ 'foo', 'bar' ];

Adds target="_blank" as an attribute to links that are children of an HTML element that belong to either class "foo" or "bar". To use in the wiki:

This is some text with an <span class="foo">[[Internal link]]</span> and also an <span class="bar">[https://www.mediawiki.org External link]</span>.

In that example, both links will open in new windows or tabs.

Example 2: Open specific images in new windows

Verwende für Wiki ebenso LocalSettings, wie in Beispiel 1:

<div class="bar">[[File:SomeImage|link=mediawiki.org]]</div>

Example 3: Open most links in a new window, but not these

$wgExternalLinkTarget = '_blank';
$wgLinkTargetParentClasses = [ 'foo', 'bar' ];
$wgLinkTargetDefault = '_self';

In the wiki:

[[This link]] will open in a new window, but not <span class="foo">[[this one]]</span>.

Example 4: Use with extensions

Surround extension parser functions or tags with some code and open any links generated by those extensions in a new window. As an example, we will use the FlickrAPI extension, with the LocalSettings code from Example 1:

<div class="foo"><flickr>SOMEIMAGEID</flickr></div>

Actually, that extension helpfully already surrounds any code that it generates with a class so really it is sufficient to set LocalSettings as follows:

$wgLinkTargetParentClasses = [ 'flickrapi' ];

This will apply to all Flickr images generated by the extension. When users click on any image, the link will open in a new window or tab.

Advanced

$wgLinkTargetParentClasses = [
     '_top' => [ 'foo' ],
     [ 'bar' ],
     '_parent' => 'baz'
];

Descendants of 'foo' will have target '_top', descendants of 'bar' will have target '_blank' and descendants of 'baz' will have target '_parent'.

Known limitations

• The links will not have any special target while viewing the page in "preview" mode.

Siehe auch

• Handbuch:$wgExternalLinkTarget