Расширение:RandomSelection

**Справка по расширениям MediaWiki**
RandomSelection; Статус релиза: стабильно
Реализация	Тег, Функция парсера
Описание	Отображает случайный вариант из заданного набора
Автор(ы)	Ross McClure; Jack Phoenix;
Последняя версия	3.0.0 (2018-09-09)
MediaWiki	1.43+
Изменения в БД	Нет
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение ; Git [?]: репозиторий (GitHub); Обзор кода Gerrit; журнал Git-коммитов; Download source tarball;
Пример	Пример на Mises Wiki;
	Метки ‎<choose>; ‎<option>; ‎<choicetemplate>;
	Используемые хуки MagicWordwgVariableIDs; ParserFirstCallInit;
	Переведите расширение RandomSelection, если оно доступно на translatewiki.net

This page is a translated version of the page Extension:RandomSelection and the translation is 100% complete.

Расширение RandomSelection позволяет размещать случайно сгенерированный контент внутри вашей вики; например меняющееся изображения, случайные приветствия и т. д.

Установка

Скачайте и распакуйте файл(ы) в папку с названием RandomSelection в вашей папке extensions/.
Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RandomSelection
```
Добавьте следующий код в конце вашего файла LocalSettings.php :
```
wfLoadExtension( 'RandomSelection' );
```
Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Использование

Из каждого набора тегов ‎<choose> случайным образом будет выбран ровно один тег ‎<option>, и будет показано его содержимое. Внутри тегов option можно разместить что угодно: ссылки, изображения и даже шаблоны.

Однако аргументы этого шаблона не будут расширены из-за T4257.

Вы также можете отправить то, что помещено внутри тегов option, в качестве аргумента в шаблон с тегом ‎<choicetemplate>, например:

<choose>
<option>Template:Featured article/Elephant</option>
<option>Template:Featured article/Giraffe</option>
<option>Template:Featured article/Rhinoceros</option>
<choicetemplate>PageWithEditButton</choicetemplate>
</choose>

Затем вы можете создать [[Template:PageWithEditButton]] со следующим содержимым:

[{{canonicalurl:{{{1}}}|action=edit}} Edit] {{{{{1}}}}}

Это полезно, если вы хотите настроить произвольную ротацию избранных статей и иметь кнопку редактирования, позволяющую пользователю редактировать рекламные объявления избранных статей.

Параметры для choose

Параметр	Описание
`uncached`	Отключить кеширование для выбранного варианта
`before`	Поместите этот текст перед выбранным вариантом
`after`	Поместите этот текст после выбранного варианта

Начиная с версии 2.2.2 кэширование в теге ‎<choose> отключается только в том случае, если пользователь указывает ‎<choose uncached>. Ранее кэширование было отключено по умолчанию.

Если вы хотите отключить кэширование для option, вам следует добавить параметр uncached.

<choose uncached>
<option>Это первый вариант.</option>
<option>Это второй вариант.</option>
<option>И так далее...</option>
</choose>

Если вы хотите отобразить одно из трех видео YouTube, вы можете попробовать это (требуется Extension:Widgets и Расширение:YouTube ):

<choose before="{{#widget: YouTube|id=" after="}}">
<option>eR7-AUmiNcA</option><!--King of Anything-->
<option>cSCi7kCXKDA</option><!--Slipping Through My Fingers-->
<option>7n2d9XPsmmE</option><!--When Death Note Music Plays in My Car-->
</choose>

Параметры для option

Параметр	Описание
`weight`	Весомость option

Если вы хотите, чтобы некоторые option отображались чаще, чем другие, вы можете добавить весомости тегам option, например:

<choose>
<option weight="2">Эта option будет отображаться в два раза чаще, чем обычная.</option>
<option>По умолчанию option имеет весомость 1.</option>
<option weight="1.5">Эта option также имеет весомость 1. Дробные части игнорируются.</option>
</choose>

Функция парсера

Чтобы выбрать между одним или несколькими параметрами, просто поместите каждый параметр в функцию парсера #choose:, например:

{{#choose:
 |Это первый вариант.
 |Это второй вариант.
 |И так далее...
}}

Из каждого варианта, разделенного вертикальной чертой, будет случайным образом выбран ровно один вариант, и будет показано его содержимое. Внутри можно разместить что угодно: ссылки, изображения, даже шаблоны.

См. также

Расширение:RandomImage — Позволяет рандомизировать мультимедийный контент на странице

Это расширение включено в следующие вики-фермы/хостинги и/или пакеты: