Extension:MultimediaViewer

ショートカット: MV

MediaWiki 拡張機能マニュアルManual:Extensions

MultimediaViewer リリースの状態:Extension status 安定
実装Template:Extension#type	User interface, Ajax
説明Template:Extension#description	利用者がページ内のサムネイルをクリックした際の表示方法を改善
作者Template:Extension#username	Mark Holmquist, Gergő Tisza, Gilles Dubuc
MediaWikiTemplate:Extension#mediawiki	1.25+
PHPTemplate:Extension#php	5.3+
データベースの変更Template:Extension#needs-updatephp	いいえ
ライセンスTemplate:Extension#license	GNU General Public License 2.0 or later
ダウンロード	スナップショットをダウンロード (Git master) Git [?]: リポジトリの要約 ファイル ツリーの参照 (GitHub) コミット履歴 コード レビュー
例Template:Extension#example	MediaWiki.org
名前空間Template:Extension#namespace	main
パラメーターTemplate:Extension#parameters $wgEnableMediaViewerForLoggedInUsersOnly $wgMediaViewerIsInBeta
使用するフックTemplate:Extension#hook GetBetaFeaturePreferencesManual:Hooks/GetBetaFeaturePreferences BeforePageDisplayManual:Hooks/BeforePageDisplay CategoryPageViewManual:Hooks/CategoryPageView ResourceLoaderGetConfigVarsManual:Hooks/ResourceLoaderGetConfigVars
translatewiki.net で翻訳を利用できる場合は、MultimediaViewer 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。
問題点Phabricator	未解決のタスク · バグを報告

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

インストール

Option A: use Vagrant. See the MediaWiki-Vagrant page for instructions to get a MediaWiki installation going with a Vagrant virtual machine system.

Then do vagrant enable-role multimediaviewer and then vagrant provision.

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

First, consider installing Extension:BetaFeatures. It may be helpful to hide the media viewer feature behind a preference. If you don't install this, it will be enabled everywhere. MultimediaViewer uses the GetBetaFeaturePreferences hook, which is created and run from BetaFeatures, to register this preference.

You'll also likely want to download Extension:CommonsMetadata - it's not a hard requirement, but without it you won't get very much information in your lightboxes.

• ダウンロードして、ファイルを extensions/ フォルダー内の MultimediaViewer という名前のディレクトリ内に配置します。

• 以下のコードを LocalSettings.php の末尾に追加します:

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

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

設定

• $wgMediaViewerIsInBeta will register a preference with BetaFeatures if set to "true"
• $wgMediaViewerEnableByDefault and $wgMediaViewerEnableByDefaultForAnonymous will determine whether MMV is enabled by default for everyone and for anonymous users, respectively. They both default to true. $wgDefaultUserOptions['multimediaviewer-enable'] = 1; can be used as a replacement for $wgMediaViewerEnableByDefault.
• $wgMediaViewerUseThumbnailGuessing will improve performance when enabled, but can be fragile depending on how the wiki is set up (it will probably work fine if you use a 404 handler).

強制ダウンロード

To ensure files are offered for download and not viewed in the user's browser following a click on the Download … button, the server has to be configured, except when using vagrant:

If the requested URL to an image directory contains the download query parameter, the Content-Disposition-header must be set to attachment. This can be achieved in Apache and compatible servers using mod_rewrite and mod_headers in a .htaccess file. Varnish configuration can look like this.

本拡張機能の利用

First thing, before testing, is to make sure you're logged in and you have the preference enabled: Log in to the wiki and go to Special:Preferences, then visit the "Beta features" tab and check the appropriate box.

Next, go to a page that has a thumbnail on it. Try clicking on the image or on the "expand" icon near it. The lightbox should pop up and give you a bigger view of the image.

If you'd prefer, there's an exported test environment that you can use via Special:Import to quickly set up a suitable testing environment.

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

If you want to add functionality, you'll have to dig around in the classes and change the functionality pretty manually. We'll work on making this a nicer experience, but given the class and method hierarchy we've built, we think it's not terribly difficult right now.

HOWEVER, you should avoid doing this too much. If things change internally, then your code might break in unexpected ways, and you (and your users) will be surprised. Don't let that happen, and wait for a more stable way to extend the product.

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

テンプレート

Multimedia Viewer and Upload Wizard needs several templates to show data of photos. Just save this code in a xml file and import it in your wiki.

関連項目

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

Similar extension(s)

• Extension:FancyBoxThumbsExtension:FancyBoxThumbs