Extension:MultimediaViewer/ja
 リリースの状態: 安定 | |||
|---|---|---|---|
| |||
| 実装 | User interface, Ajax | ||
| 説明 | 利用者がページ内のサムネイルをクリックした際の表示方法を改善 | ||
| 作者 | Mark Holmquist, Gergő Tisza, Gilles Dubuc | ||
| MediaWiki | 1.25+ | ||
| PHP | 5.4+ | ||
| データベースの変更 | いいえ | ||
| ライセンス | GNU General Public License 2.0 or later | ||
| ダウンロード | |||
| 例 | MediaWiki.org | ||
| 名前空間 |
main | ||
| |||
| |||
|
translatewiki.net で翻訳を利用できる場合は、MultimediaViewer 拡張機能の翻訳にご協力ください | |||
| 使用状況とバージョン マトリクスを確認してください。 | |||
| 未解決のタスク · バグを報告 | |||
MultimediaViewer (マルチメディアビューアー) 拡張機能は、ウィキの利用者に対して、別ページの読み込みによる手間や混乱をなくしつつ、ブラウザー内で元のサイズまたはそれに近い画像を表示できるような、別のユーザー インターフェイスを提供します。
Contents
インストール
選択肢 A：Vagrantを使用。手順はMediaWiki-Vagrant/jaのページを参照して、Vagrant仮想マシンシステム経由でMediaWikiをインストール。
次にvagrant enable-role multimediaviewerと、続いてvagrant provisionを実行。
選択肢 B: 手動インストール。
先にExtension:BetaFeatures/jaのインストールを検討してください。個人設定でメディアビューワー機能を非表示にするとよいかもしれません。ただしこれを意図的にインストールしなくても、有効にすることができます。この個人設定を登録するには、BetaFeaturesからフック（ GetBetaFeaturePreferences hook）の生成と起動を実行してMultimediaViewerに使用します。
また合わせてExtension:CommonsMetadata/Jaのダウンロードも検討しましょう - 絶対に必要ではありませんが、それがないとライトボックスで利用できる情報が限られてしまいます。
- ダウンロードして、ファイルを
extensions/フォルダー内のMultimediaViewerという名前のディレクトリ内に配置します。
- 以下のコードを LocalSettings.php の末尾に追加します:
wfLoadExtension( 'MultimediaViewer' );
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
MediaWiki 1.24 以前を稼働させている利用者へ:
上記の手順では、wfLoadExtension() を使用してこの拡張機能をインストールする新しい方法を記載しています。 この拡張機能をこれらの過去のバージョン (MediaWiki 1.24 以前) にインストールする必要がある場合は、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ファイルに保存し、ご利用のウィキにインポートするだけです。
関連項目
- 同様の拡張機能：
 | この拡張機能は Reading Web チームによって保守されています。 |
 | この拡張機能は 1 つ以上のウィキメディアのプロジェクトで使用されています。 これはおそらく、この拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。 この拡張機能がインストールされている場所を確認するには、ウィキメディアの設定ファイル CommonSettings.php および InitialiseSettings.php 内で、この拡張機能の名前を探してください。 特定のウィキにインストールされている拡張機能の完全な一覧は、そのウィキの Special:Version ページにあります。 |
- Extensions bundled with MediaWiki 1.31/ja
- GPL licensed extensions/ja
- Stable extensions/ja
- User interface extensions/ja
- Ajax extensions/ja
- Extensions in Wikimedia version control/ja
- GetBetaFeaturePreferences extensions/ja
- BeforePageDisplay extensions/ja
- CategoryPageView extensions/ja
- ResourceLoaderGetConfigVars extensions/ja
- All extensions/ja
- Extensions used on Wikimedia/ja
- Image extensions/ja
