Extension:MultimediaViewer

この拡張機能は MediaWiki 1.31 以降に同梱されています。 そのため再度ダウンロードする必要はありません。 しかし、提供されているその他の手順に従う必要はあります。

MediaWiki 拡張機能マニュアル

MultimediaViewer リリースの状態: 安定
実装	ユーザー インターフェイス, Ajax
説明	利用者がページ内のサムネイルをクリックした際の表示方法を改善
作者	Mark Holmquist Gergő Tisza Gilles Dubuc
MediaWiki	1.25+
PHP	5.4+
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
例	MediaWiki.org
パラメーター $wgMediaViewerDurationLoggingLoggedinSamplingFactor $wgMediaViewerAttributionLoggingSamplingFactor $wgMediaViewerDimensionLoggingSamplingFactor $wgMediaViewerImageQueryParameter $wgMediaViewerActionLoggingSamplingFactorMap $wgMediaViewerUseThumbnailGuessing $wgMediaViewerNetworkPerformanceSamplingFactor $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerDurationLoggingSamplingFactor $wgMediaViewerEnableByDefault $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
使用するフック BeforePageDisplay CategoryPageView GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
translatewiki.net で翻訳を利用できる場合は、MultimediaViewer 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。
問題点	未解決のタスク · バグを報告

MultimediaViewer (マルチメディアビューアー) 拡張機能は、ウィキの利用者に対して、別ページの読み込みによる手間や混乱をなくしつつ、ブラウザー内で元のサイズまたはそれに近い画像を表示できるような、別のユーザー インターフェイスを提供します。

インストール

選択肢 A: Vagrant を使用。手順は MediaWiki-Vagrant のページを参照して、Vagrant 仮想マシンシステム経由で MediaWiki をインストール。

次にvagrant enable-role multimediaviewerと、続いてvagrant provisionを実行。

選択肢 B: 手動インストール。

先に Extension:BetaFeatures のインストールを検討してください。個人設定でメディアビューアー機能を非表示にするとよいかもしれません。ただしこれを意図的にインストールしなくても、有効にすることができます。この個人設定を登録するには、BetaFeaturesからフック (GetBetaFeaturePreferences フック) の生成と起動を実行してMultimediaViewerに使用します。

また合わせて Extension:CommonsMetadata のダウンロードも検討しましょう - 絶対に必要ではありませんが、それがないとライトボックスで利用できる情報が限られてしまいます。

• ダウンロードして、ファイルを extensions/ フォルダー内の MultimediaViewer という名前のディレクトリ内に配置します。
• 以下のコードを LocalSettings.php の末尾に追加します:

  wfLoadExtension( 'MultimediaViewer' );
  

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

MediaWiki 1.26 以前を稼働させている利用者へ:

上記の手順では、wfLoadExtension() を使用してこの拡張機能をインストールする新しい方法を記載しています。 この拡張機能をこれらの過去のバージョン (MediaWiki 1.26 以前) にインストールする必要がある場合は、wfLoadExtension( 'MultimediaViewer' ); の代わりに以下を使用する必要があります:

require_once "$IP/extensions/MultimediaViewer/MultimediaViewer.php";

設定

• $wgMediaViewerIsInBetaを"true"を指定すると、個人設定でBetaFeaturesが有効になります。
• $wgMediaViewerEnableByDefaultならびに$wgMediaViewerEnableByDefaultForAnonymousにより、既定でだれでも、つまりログインしない匿名利用者でもマルチメディアビューアーを使用できるか決定します。既定では両方とも「true」。 $wgMediaViewerEnableByDefaultの代わりに$wgDefaultUserOptions['multimediaviewer-enable'] = 1;を使用可能。
• $wgMediaViewerUseThumbnailGuessingを有効にするとパフォーマンスが向上しますが、ウィキの設定によっては脆弱になりかねません（404 handlerを使用した場合なら問題なく作動するはずです）。

強制ダウンロード

Vagrantを利用する場合を除き、「…をダウンロードする」というボタンを押したときに利用者のブラウザで表示するだけでなく、ほんとうにダウンロード用ファイルが提供されているか確認するには、サーバの設定が必要です。

要求した画像のディレクトリのURLにdownloadクエリ引数が含まれる場合、Content-Disposition-ヘッダはattachmentに設定してください。 その手順はApacheと互換性のあるサーバで.htaccessファイルで mod_rewrite および mod_headers を使用すると実行します。 Varnishの設定はこういう表示になります。

この拡張機能の利用

試用する前提として、最初にログイン状態であること、個人設定が有効かどうかを次のように確認します。ウィキにログインして「特別ページ:個人設定」を開き、「ベータ機能」タブへ移動して対応するチェックボックスにレ点を入れます。

次に、サムネイル画像が含まれたページを開きます。画像もしくは周辺にある「拡大」アイコンをクリック。ライトボックスが別のウィンドウで開き、画像を拡大して表示します。

もし興味があればテスト環境を書き出し用に用意してありますので、Special:Importを経由すると、テストに適した環境を手軽に設定できます。（訳注：「他のウィキからのページの取り込み」には管理者あるいは同等の権限が必要です。）

ユーザースクリプトで拡張

機能を追加したい場合は、ほぼ手作業でクラスを順に調べて機能を変更することになります。この作業をもっと快適にするために取り組んでいるのですが、これまでに構築したクラスとメソッドの系統に照らすと、それほど困難な取り組みではないと考えています。

そうは言うものの左記の作業の繰り返しは避けてください。内部的に変更が行われるとせっかく書いたコードが壊れてしまい、予想外の展開にあなた（とあなたのツールのユーザー）がびっくりする可能性があるからです。そういう事態を予防するには、製品拡張のもっと安定した手法が確立するまでお待ちください。

例については /Extension:Metadata を参照してください。

テンプレート

マルチメディアビューアーとアップロードウィザード（Upload Wizard）は画像のデータを表示するにはいくつかテンプレートを使います。 こちらのコードをxmlファイルに保存し、ご利用のウィキにインポートするだけです。

関連項目

• Help:Extension:Media Viewer
• Multimedia
• マルチメディア/メディアビューアー
• Extension:SlimboxThumbs