Jump to content

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

From mediawiki.org
This page is a translated version of the page Extension:RandomSelection and the translation is 100% complete.
Справка по расширениям MediaWiki
RandomSelection
Статус релиза: стабильно
Реализация Тег , Функция парсера
Описание Отображает случайный вариант из заданного набора
Автор(ы)
Последняя версия 3.0.0 (2018-09-09)
MediaWiki 1.39+
Изменения в БД Нет
Лицензия GNU General Public License 2.0 или позднее
Скачать
Пример

  • ‎<choose>
  • ‎<option>
  • ‎<choicetemplate>
Ежеквартальные загрузки 30 (Ranked 99th)
Использование общедоступными вики 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' );
    
  • Yes Готово – Перейдите на страницу 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:
 |Это первый вариант.
 |Это второй вариант.
 |И так далее...
}}

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

См. также