Jump to content
MediaWiki

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

From mediawiki.org
This page is a translated version of the page Extension:RandomSelection and the translation is 84% complete.
Справка по расширениям MediaWiki
RandomSelection
Статус релиза: стабильно
Реализация Тег , Функция парсера
Описание Отображает случайный вариант из заданного набора
Автор(ы)
Последняя версия 3.0.0 (2018年09月09日)
MediaWiki 1.43+
Изменения в БД Нет
  • $wgRandomSelectionAllowUncached
  • ‎<choose>
  • ‎<option>
  • ‎<choicetemplate>
Licence GNU General Public License 2.0 or later
Скачать
Пример
Переведите расширение RandomSelection, если оно доступно на translatewiki.net

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

Установка

  • Скачайте и распакуйте файл(ы) в папку с названием RandomSelection в вашей папке extensions/.
    Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:
    cdextensions/
gitclonehttps://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}}}}}

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

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

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

If you'd like some options to be shown more often than others, you can add weight as parameter names, like so: 

{{#choose:
 2=This option will be shown twice as often as a normal option.
 |By default, options have a weight of 1.
 |1.5=This option also has a weight of 1. Fractional portions are ignored.
}}

If the option contains =, you have to escape it, by either replacing it with {{=}} or prefixing the option with 1=.

MediaWiki handles the first parameter differently: it is expanded before passed to the parser function. As a result, if the expanded result contains =, you have to escape it with 1= ({{=}} doesn't work).

Example:

  • {{#choose:2 + 2 = 4}} → 4
  • {{#choose:2 + 2 {{=}} 4}} → 4
  • {{#choose:1=2 + 2 = 4}} → 2 + 2 = 4

См. также

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

AltStyle によって変換されたページ (->オリジナル) /