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

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

RandomSelection Статус релиза: стабильно
Реализация	Тег , Функция парсера
Описание	Отображает случайный вариант из заданного набора
Автор(ы)	Ross McClure Jack Phoenix
Последняя версия	3.0.0 (2018-09-09)
MediaWiki	1.39+
Изменения в БД	Нет
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: скачать текущую версию исходника репозиторий (GitHub) история изменений список разработчиков (GitHub) code review
Пример	Пример на Mises Wiki
Метки ‎<choose> ‎<option> ‎<choicetemplate>
Используемые хуки MagicWordwgVariableIDs ParserFirstCallInit
Ежеквартальные загрузки	27 (Ranked 111st)
Использование общедоступными вики	7,190 (Ranked 23rd)
Переведите расширение RandomSelection, если оно доступно на translatewiki.net

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

Установка

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

  wfLoadExtension( 'RandomSelection' );
  

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

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

Теги

Чтобы выбрать один и более вариантов, поместите каждое содержимое в тег ‎<option>, которые в свою очередь помещаются в тег ‎<choose>, например:

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

Из каждого набора тегов ‎<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}}}}}

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

<span id="Parameters_to_‎<choose>">

Параметры для ‎<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>

<span id="Parameters_to_‎<option>">

Параметры для ‎<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:
 |Это первый вариант.
 |Это второй вариант.
 |И так далее...
}}

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

См. также

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