확장기능:MultimediaViewer

이 extension 확장기능은 미디어위키 1.31 이상에서 포함됩니다. 따라서 다시 다운로드하지 않아도 됩니다. 하지만 여전히 제공되는 별개의 지침을 따라야 합니다.

미디어위키 확장 기능 매뉴얼

MultimediaViewer 출시 상태: 안정
구현	사용자 인터페이스, Ajax
설명	사용자가 문서 내의 섬네일을 클릭했을 때의 표시 방법을 개선
만든이	Mark Holmquist Gergő Tisza Gilles Dubuc
호환성 정책	Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki	1.25+
PHP	5.4+
라이선스	GNU General Public License 2.0 or later
다운로드	확장 기능 다운로드 Git [?]: Git master 다운로드 저장소 보기 (GitHub) 커밋 기록 repository contributors (GitHub) 코드 리뷰
예제	MediaWiki.org
변수 $wgMediaViewerDurationLoggingLoggedinSamplingFactor $wgMediaViewerAttributionLoggingSamplingFactor $wgMediaViewerDimensionLoggingSamplingFactor $wgMediaViewerImageQueryParameter $wgMediaViewerActionLoggingSamplingFactorMap $wgMediaViewerUseThumbnailGuessing $wgMediaViewerNetworkPerformanceSamplingFactor $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerDurationLoggingSamplingFactor $wgMediaViewerEnableByDefault $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
사용된 훅 BeforePageDisplay CategoryPageView GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
MultimediaViewer 확장 기능 번역 (translatewiki.net에서 가능한 경우)
사용법과 버전 매트릭스를 확인합니다.
이슈	미해결 작업 · 버그 보고

The MultimediaViewer extension gives the user of a wiki a different interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.

설치

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.

Option B: install manually.

First, consider installing 확장 기능:베타기능 . 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.

• Download and place the file(s) in a directory called MultimediaViewer in your extensions/ folder.
• 아래의 코드를 LocalSettings.php의 말미에 추가합니다:

  wfLoadExtension( 'MultimediaViewer' );
  

•  완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

미디어위키 1.26 이하를 실행 중인 사용자에게:

위의 지시사항은 wfLoadExtension()을 사용하여 이 확장기능을 설치하는 새로운 방법을 기술한 것으로, wfLoadExtension( 'MultimediaViewer' ); 대신 초기 버전(미디어위키 1.26 이하)에 이 확장기능을 설치하려면 다음을 사용해야 합니다:

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

설정

• $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).

Forced download

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.

Extending with user scripts

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.

See /Extension:Metadata for an example.

템플릿

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 Viewer
• Multimedia
• Multimedia/Media Viewer
• Extension:SlimboxThumbs