Extension:RandomImage

MediaWiki 拡張機能マニュアル

RandomImage リリースの状態: 安定
実装	タグ
説明	Adds a ‎<randomimage> tag to the parser allowing for randomisation of multimedia content on a page
作者	Rob Church (Robchurchトーク)
最新バージョン	1.5.1 (continuous updates)
MediaWiki	>= 1.35
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー README
パラメーター $wgRandomImageNoCache
タグ randomimage
使用するフック ParserBeforeInternalParse ParserBeforePreprocess ParserFirstCallInit
Quarterly downloads	10 (Ranked 137th)
Public wikis using	5,812 (Ranked 2nd)
translatewiki.net で翻訳を利用できる場合は、RandomImage 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

The RandomImage extension adds a ‎<randomimage> tag to the MediaWiki parser which allows for randomisation of multimedia content on a page.

When the tag is rendered, a random image is selected from those uploaded and inserted at the location of the tag. Users can select a custom size, float and provide a caption for the resulting image.

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のRandomImageという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RandomImage
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'RandomImage' );
  

•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

使用法

The tag can be used in two forms:

‎<randomimage />

Produces an image using an automatic caption (see below)

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

Produces an image with a preset caption (text inside the tags)

The tag also supports the following attributes:

size

Set the image width (default is the user's thumbnail width)

float

Float the image; valid values are left, center and right

choices

Confines image selection to a pipe-delimited list of images

例

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

キャプション

If no caption is specified, one will be pulled, if possible, from the image description page.

If the description page contains text wrapped in ‎<randomcaption>...‎</randomcaption> tags, then this will be used as the caption. The tags are ignored during normal page views. Otherwise, the first paragraph of the page text will be used as the caption.

Selection

On wikis where non-images are uploaded (e.g. sound and video files, or documents, etc.), the extension might select a non-image file. There are few performance-efficient means of limiting those files selected.

If $wgRandomImageStrict is switched on, a more complex database query will be performed, with a greater performance cost, which will ensure only images with an image major MIME type are selected.

By default, this option has the same value as $wgMiserMode. You may wish to switch it off if all of the content on your wiki has an appropriate renderer.

キャッシュ

By default, the output is cached in the regular parser cache. This can be advantageous on larger sites which need to use caching to reduce the effects of load, however, it means that content is not 100% dynamic.

To disable the parser cache on pages which use the ‎<randomimage> tag, set $wgRandomImageNoCache = true; in LocalSettings.php (after the call to include the extension file). This will affect all users, and might incur additional overhead on page views.

関連項目

• Extension:RandomSelection — Displays a random option from the given set.