Extension:LinkTarget/ru

This extension is professionally maintained by the WikiTeq team.

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

Справка по расширениям MediaWiki

LinkTarget Статус релиза: стабильно
Реализация	MyWiki
Описание	Добавляет атрибут цели к указанным ссылкам
Автор(ы)	Ike Hecht (Tosfosобсуждение)
Поддерживающий(ие)	Команда WikiTeq
Последняя версия	0.2.0 (14 декабря 2020)
Политика совместимости	В расширении есть соответствуюшая ветвь для каждого релиза MediaWiki, который является релизом долгосрочной поддержки (Long Term Support release).
MediaWiki	1.35, 1.39
Изменения в БД	Нет
Параметры $wgLinkTargetParentClasses $wgLinkTargetDefault
Используемые хуки OutputPageParserOutput
Licence	GNU General Public License 2.0 or later
Скачать	Скачать расширение Git [?]: репозиторий (GitHub) Обзор кода Gerrit журнал Git-коммитов Download source tarball
Переведите расширение LinkTarget, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

Расширение LinkTarget позволяет администраторам добавлять атрибут target к внутренним и внешним ссылкам. Это применимо, например, для открытия внутренних и внешних ссылок в новых окнах.

Это расширение было создано для WikiWorks.

Установка

• Скачайте и распакуйте файл(ы) в папку с названием LinkTarget в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:

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

• Добавьте следующий код в конце вашего файла LocalSettings.php :

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

• Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Настройка

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 ], ... ] Если target не указано или недействительно, цель будет установлена как $wgLinkTargetDefault. Обратите внимание, что валидным является и указание одного класса как строки, вместо массива классов.
$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.

Примеры

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

Using the same LocalSettings as in Example 1, in the wiki use:

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

Известные ограничения

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

См. также

• Manual:$wgExternalLinkTarget