미디어위키/미디어위키 익스텐션

미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) MultimediaViewer 설치와 활용

씨실과 날실 2020. 5. 7. 09:00

[익스텐션 목록]

기본 익스텐션

2019/10/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Interwiki 설치와 활용

2020/04/28 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Nuke 설치와 활용

2020/04/28 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Renameuser 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CiteThisPage 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Replace Text 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) WikiEditor 설치와 활용

2020/04/30 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CodeEditor 설치와 활용

2020/04/30 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CategoryTree 설치와 활용

2020/05/01 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Cite 설치와 활용

2020/05/01 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ImageMap 설치와 활용

2020/05/02 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) InputBox 설치와 활용

2020/05/02 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ParserFunctions 설치와 활용

2020/05/03 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Poem 설치와 활용

2020/05/03 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) SyntaxHighlight 설치와 활용

2020/05/04 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) PDF Handler 설치와 활용

2020/05/04 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ConfirmEdit 설치와 활용

2020/05/05 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) SpamBlacklist 설치와 활용

2020/05/05 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) TitleBlacklist 설치와 활용

2020/05/06 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Gadgets 설치와 활용

2020/05/06 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) LocalisationUpdate 설치와 활용

2020/05/07 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) MultimediaViewer 설치와 활용

2020/05/07 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) OATHAuth 설치와 활용




[MultimediaViewer 익스텐션 관련 정보]

익스텐션 공식 안내 페이지

https://www.mediawiki.org/wiki/Extension:MultimediaViewer

다운로드

미디어위키 내 배포 페이지

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/MultimediaViewer

github 페이지

https://github.com/wikimedia/mediawiki-extensions-MultimediaViewer



MultimediaViewer 익스텐션 기능

위키 문서 내 썸네일을 클릭할 때 사용자에게 편리한 인터페이스와 유용한 기능을 제공하는 인터페이스 익스텐션입니다.




익스텐션 설치 전에

BetaFeatures 익스텐션을 설치하면 환경설정에서 미디어 뷰어 기능을 숨길 수 있습니다. MultimediaViewer는 BetaFeatures에서 생성 및 실행되는 GetBetaFeaturePreferences 훅를 사용하여 환경 설정을 등록합니다.

만약 이 BetaFeatures 익스텐션이 설치되어 있지 않으면 MultimediaViewer 익스텐션이 항상 활성화됩니다.


익스텐션 다운로드 및 설치

다운로드 안내

익스텐션 다운로드 및 설치 방법은 아래 링크를 참고하시기 바랍니다.


사용 중인 미디어위키의 버전에 맞는 배포 익스텐션 압축 파일을 다운로드받습니다.

다운로드 받은 압축 파일을 서버 안 미디어위키 설치 폴더 내에 있는  extensions폴더 안에 풀어줍니다.

리눅스 서버의 경우

$ sudo tar -xzf MultimediaViewer-REL1_34-30ea768.tar.gz -C /미디어위키 설치 경로/extensions


예시 - Ubuntu

$ sudo tar -xzf MultimediaViewer-REL1_34-30ea768.tar.gz -C /var/www/html/w/extensions

위 명령은 제 블로그를 그대로 따라오신 분의 경우 적용되는 예시입니다.


윈도 서버의 경우

탐색기로 압축 파일을 해당 위치에 풀어주시면 됩니다.


호스팅을 받는 경우

파일질라, 알FTP 등 FTP 프로그램을 이용해 미리 풀어 놓은 익스텐션 폴더(MultimediaViewer)를 통째로 해당 위치에 전송해줍니다.




MultimediaViewer 익스텐션 필수 설정

미디어위키의 환경 설정 파일인 LocalSettings.php 파일에 다음과 같은 코드를 추가해줍니다.

wfLoadExtension( 'MultimediaViewer' );


... 전략 ...

# Enabled extensions. Most of the extensions are enabled by adding
# wfLoadExtensions('ExtensionName');
# to LocalSettings.php. Check specific extension documentation for more details.
# The following extensions were automatically enabled:
wfLoadExtension( 'CategoryTree' );
wfLoadExtension( 'Cite' );
wfLoadExtension( 'CiteThisPage' );
wfLoadExtension( 'CodeEditor' );
wfLoadExtension( 'ConfirmEdit' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Interwiki' );
wfLoadExtension( 'LocalisationUpdate' );
wfLoadExtension( 'MultimediaViewer' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'OATHAuth' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'PdfHandler' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'Renameuser' );
wfLoadExtension( 'ReplaceText' );
wfLoadExtension( 'SpamBlacklist' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'TitleBlacklist' );
wfLoadExtension( 'WikiEditor' );

# End of automatically generated settings.
# Add more configuration options below.

... 후략 ...

미디어위키 설치시 기본 제공 익스텐션을 함께 설치하도록 설정한다면 코드는 보통 위 예시와 같은 위치에 추가됩니다.


설치 확인

미디어위키의 특수:버전(= Special:Version) 문서를 확인하면 위 익스텐션이 추가된 것을 확인할 수 있습니다.




MultimediaViewer 익스텐션 추가 구성 설정

$wgMediaViewerIsInBeta

"true"로 설정된 경우 BetaFeatures에 환경 설정을 등록합니다.

$wgMediaViewerEnableByDefault

 MultimediaViewer가 기본적으로 활성화할 것인지 설정하며 기본값은 true입니다.

위 코드 대신 아래 코드를 사용할 수도 있습니다.

$wgDefaultUserOptions['multimediaviewer-enable'] = 1;


$wgMediaViewerEnableByDefaultForAnonymous

MultimediaViewer가 익명 사용자에게도 기본적으로 활성화할 것인지 설정하며 기본값은 true입니다.


$wgMediaViewerUseThumbnailGuessing

위 코드는 초심자에게는 권장하지 않습니다. 이 코드를 활성화하면 성능을 향상할 수 있지만 위키 설정 방법에 따라 보안상 취약해질 수 있습니다. 그러나 404 핸들러를 사용하면 제대로 작동합니다.




MultimediaViewer 익스텐션 사용법

BetaFeatures 익스텐션을 설치, 활성화한 경우, 로그인하고 환경 설정이 활성화되어 있는지 확인합니다. 위키에 로그인하고 특수:환경 설정으로 이동 한 다음 "베타 기능"탭을 방문하여 해당 상자를 선택하면 됩니다.

그런 다음 썸네일이 있는 위키 문서로 이동합니다. 이미지나 근처의 "확장"아이콘을 클릭합니다. 라이트 박스가 나타나고 이미지를 더 크게 볼 수 있습니다.


사용자 스크립트로 확장

기능을 추가하려면 클래스를 살펴보고 기능을 수동으로 변경해야합니다. 그러나 이 작업은 초보자들에게 권장하지 않습니다.

예제는 아래 링크를 참고하시기 바랍니다.


템플릿

Multimedia Viewer와 Upload Wizard 익스텐션은 사진 데이터를 표시하기 위해 몇 가지 템플릿이 필요합니다.

위 링크의 코드를 xml 파일로 저장하고 위키로 가져오면 됩니다.


실무

예를 들어 위 그림처럼 위키 문서에 이미지가 있다고 가정합시다. MultimediaViewer 익스텐션이 설치되어 활성화되어 있다면 해당 이미지를 클릭하면 아래 그림처럼 멀티미디어 뷰어(MultimediaViewer)가 활성화됩니다.


멀티미디어 뷰어의 기본 활성화 모습입니다.


마우스를 아래로 드래그하거나 하단 막대를 클릭하면 위 그림처럼 해당 멀티미디어 파일에 대한 관련 정보가 표시됩니다.


멀티미디어 뷰어(MultimediaViewer) 창 우 하단의 다운로드 아이콘을 클릭하면 위 그림처럼 다운로드 팝업창이 뜹니다.


멀티미디어 뷰어(MultimediaViewer) 우 하단의 공유 아이콘을 클릭하면 해당 멀티미디어 파일을 다른 곳에 공유 이용할 수 있는 링크가 표시됩니다.


포함하기 탭을 클릭하면 해당 멀티미디어 파일을 위키의 다른 문서에 포함시킬 수 있는 코드가 표시됩니다.


멀티미디어 뷰어(MultimediaViewer) 우상단의 톱니바퀴 모양의 설정 아이콘을 클릭하면 멀티미디어 뷰어 기능을 비활성화할 수 있는 버튼이 나타납니다.


멀티미디어 뷰어(MultimediaViewer) 기능 비활성화 버튼을 클릭하면 위 그림처럼 다음번부터는 멀티미디어 뷰어 기능이 활성화되지 않는다고 알려주는 안내가 뜹니다.


멀티미디어 뷰어(MultimediaViewer)를 비활성ㄴ화 한 후 위키 문서 내 이미지 등을 클릭하면 멀티미디어 뷰어가 작동하지 않고 위 그림처럼 해당 파일 정보 문서 페이지로 이동합니다.


파일 정보 페이지에서 멀티미디어 뷰어(MultimediaViewer)를 수동으로 열어 설정 아이콘을 클릭하여 멀티미디어 뷰어(MultimediaViewer) 기능을 활성화하면 위 그림처럼 다음 번부터는 멀티미디어 뷰어 기능이 활성화된다고 알려주는 안내가 뜹니다.