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

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

RandomImage Статус релиза: не поддерживается
Реализация	Тег
Описание	Добавляет к парсеру тег ‎<randomimage>, позволяющий рандомизировать мультимедийный контент на странице
Автор(ы)	Rob Church (Robchurchобсуждение)
Последняя версия	1.5.1 (continuous updates)
MediaWiki	>= 1.39.4
Параметры $wgRandomImageNoCache
Метки randomimage
Используемые хуки ParserBeforeInternalParse ParserBeforePreprocess ParserFirstCallInit
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: репозиторий (GitHub) Обзор кода Gerrit журнал Git-коммитов Download source tarball README
Переведите расширение RandomImage, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

Расширение RandomImage добавляет тег ‎<randomimage> к парсеру MediaWiki, который позволяет рандомизировать мультимедийный контент на странице.

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

Установка

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

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

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

  wfLoadExtension( 'RandomImage' );
  

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

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

Тег может использоваться двумя способами:

‎<randomimage />

Отображает изображение с использованием автоматической подписи (см. ниже)

‎<randomimage>...‎</randomimage>

Отображает изображение с заданной надписью (текст внутри тегов)

Тег также поддерживает следующие атрибуты:

size

Установка ширины изображения (по умолчанию ширина пользовательской миниатюры)

float

Выравнивание изображений; доступные значения left, center и right

choices

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

Например

<randomimage size="100" float="left" choices="Apple.jpg|Pear.jpg" />

Подпись

Если подпись не указана, она будет взята, если это возможно, со страницы описания изображения.

Если страница описания содержит текст, обёрнутый в теги ‎<randomcaption>...‎</randomcaption>, то он будет использоваться как подпись. Теги игнорируются во время обычного просмотра страниц. В ином случае, в качестве подписи будет использоваться первый абзац текста страницы.

Подборка

На вики, где загружаются не изображения (например, аудио- и видеофайлы, документы и т. д.), расширение может выбрать файл, не являющийся изображением. Есть несколько эффективных способов ограничить количество выбранных файлов.

Если включить $wgRandomImageStrict, будет выполнен более сложный запрос к базе данных с большими затратами производительности, что обеспечит выбор изображений только с основным типом MIME изображения.

По умолчанию эта опция имеет то же значение, что и $wgMiserMode. Вы можете включить её, если весь контент на вашей вики имеет соответствующий рендер.

Кэширование

По умолчанию вывод кэшируется в обычном кэше парсера. Это может быть выгодно для крупных сайтов, которым необходимо использовать кэширование для снижения нагрузки, однако это означает, что контент не является 100% динамичным.

Чтобы отключить кэш парсера на странице, используйте тег ‎<randomimage>, установите $wgRandomImageNoCache = true; в LocalSettings.php (после вызова включения файла расширения). Это затронет всех пользователей и может повлечь за собой дополнительные расходы на просмотр страниц.

См. также

• Расширение:RandomSelection — Отображает случайный вариант из заданного набора.