Extension:LinkTarget

Toto rozšíření je profesionálně spravováno týmem WikiTeq.

WikiTeq poskytuje oficiální podporu pouze pro verze MediaWiki LTS. Může fungovat s jinými verzemi MediaWiki.

Příručka k rozšířením MediaWiki

LinkTarget Stav rozšíření: stabilní
Implementace	MyWiki
Popis	Přidá atribut target k zadaným odkazům.
Autoři	Ike Hecht (Tosfosdiskuse)
Správci	Tým WikiTeq
Nejnovější verze	0.2.0 (14. prosince 2020)
Zásady kompatibility	Pro každé vydání MediaWiki, které je vydáním dlouhodobé podpory, existuje v rozšíření odpovídající větev.
MediaWiki	1.35, 1.39
Změny v databázi	Ne
Parametry $wgLinkTargetParentClasses $wgLinkTargetDefault
Použité háčky (hooks) OutputPageParserOutput
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Přeložte rozšíření LinkTarget, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření LinkTarget umožňuje administrátorům přidat atribut target k interním a externím odkazům. To lze například použít k otevírání interních a externích odkazů v nových oknech.

Toto rozšíření bylo vytvořeno pro WikiWorks.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného LinkTarget ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

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

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

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

• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Konfigurace

Name	Default	Description
$wgLinkTargetParentClasses	[]	Potomci prvků této třídy budou mít atribut target nastavený rozšířením. Očekává pole ve formátu: [ target => [ classes ], target => [ classes ], ... ] Pokud není zadána hodnota target nebo je neplatná, cílová hodnota bude nastavena na $wgLinkTargetDefault. Všimněte si, že je také platné zadat jednu třídu jako řetězec, nikoli jako pole tříd.
$wgLinkTargetDefault	_blank	Výchozí cíl pro nadřazené třídy, které nemají zadaný platný cíl. Lze nastavit na jednu z následujících hodnot: _blank, _self, _parent, _top.

Příklady

Příklad 1: Otevření konkrétních interních/externích odkazů v nových oknech

V LocalSettings.php:

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

Přidá atribut target="_blank" k odkazům, které jsou potomky elementu HTML patřícího do třídy "foo" nebo "bar". Pro použití na 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>.

V tomto příkladu se oba odkazy otevřou v nových oknech nebo na nových kartách.

Příklad 2: Otevření konkrétních obrázků v nových oknech

>Použijeme stejnou hodnotu LocalSettings jako v příkladu 1, ale na wiki použijeme:

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

Příklad 3: Většina odkazů se otevírá v novém okně, ale tyto ne

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

Na wiki:

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

Příklad 4: Použití s ​​rozšířeními

Obklopte funkce nebo tagy analyzátoru rozšíření nějakým kódem a otevírejte všechny odkazy generované těmito rozšířeními v novém okně. Jako příklad použijeme rozšíření FlickrAPI s kódem LocalSettings z příkladu 1:

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

Ve skutečnosti toto rozšíření již obklopuje jakýkoli kód, který generuje, třídou, takže stačí nastavit LocalSettings takto:

$wgLinkTargetParentClasses = [ 'flickrapi' ];

Toto se bude vztahovat na všechny obrázky Flickru vygenerované rozšířením. Když uživatelé kliknou na libovolný obrázek, odkaz se otevře v novém okně nebo na nové kartě.

Pokročilé

$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'.

Známá omezení

• Odkazy nebudou mít při prohlížení stránky v režimu "náhledu" žádný speciální cíl.

Související odkazy

• Příručka:$wgExternalLinkTarget