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

미디어위키(Mediawiki) 설치 권장 추가 익스텐션(Extension) MsUpload 설치와 활용

씨실과 날실 2020. 7. 9. 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 설치와 활용




추천 추가 익스텐션





익스텐션 연재 목록




[익스텐션명 익스텐션 관련 정보]

익스텐션 공식 안내 페이지

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

다운로드

미디어위키 내 배포 페이지

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

github 페이지

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


MsUpload 익스텐션 기능

MsUpload 익스텐션은 Ms 시리즈 중 하나로, 드래그 앤 드롭 방식 또는 탐색기 등을 이용한 파일 선택 방식으로 원하는 파일들을 다중 업로드할 수 있도록 해줍니다.

MsUpload 익스텐션의 주요 기능은 다음과 같습니다.

하나 이상의 파일을 동시에 쉽게 업로드 할 수 있습니다.

편집 페이지에 파일 업로드가 통합되었습니다.

끌어서 놓기를 통해 업로드할 수 있습니다.
(브라우저에서 HTML5를 사용할 수있는 경우)

파일을 편집 페이지에 클릭으로 손쉽게 링크를 추가할 수 있습니다.

파일을 편집 페이지에 손쉽게 이미지를 추가할 수 있습니다.

업로드하기 전에 파일 이름을 바꿀 수 있습니다.

편집중인 페이지가 카테고리 페이지인 경우 현재 카테고리에 파일을 추가할 수 있습니다.

MsUpload 익스텐션을 통해 파일을 업로드하는 경우 파일 정보 문서의 설명란에 'MsUpload로 파일을 올림'이라 자동 기록됩니다.




익스텐션 다운로드 및 설치

다운로드 안내

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


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

익스텐션 공식 배포처

미디어위키 내 배포 페이지

github 페이지




미디어위키 버전별 익스텐션 다운로드 주소

1.34

https://extdist.wmflabs.org/dist/extensions/MsUpload-REL1_34-f70d1c8.tar.gz

1.33

https://extdist.wmflabs.org/dist/extensions/MsUpload-REL1_33-2c533f8.tar.gz

1.32


1.31

https://extdist.wmflabs.org/dist/extensions/MsUpload-REL1_31-d854ddf.tar.gz

위 주소는 코드 수정으로 바뀔 수 있으므로 다운이 받아지지 않는다면 위 공식 루트를 통해 다운받으시기 바라비니다.

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

리눅스 서버의 경우

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


예시 - Ubuntu

$ sudo tar -xzf MsUpload-REL1_34-f70d1c8.tar.gz -C /var/www/html/w/extensions

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


익스텐션 다운로드

study@study-VirtualBox:~/MW_Ext$ wget https://extdist.wmflabs.org/dist/extensions/MsUpload-REL1_31-d854ddf.tar.gz
--2020-06-09 14:52:02--  https://extdist.wmflabs.org/dist/extensions/MsUpload-REL1_31-d854ddf.tar.gz
Resolving extdist.wmflabs.org (extdist.wmflabs.org)... 185.15.56.49
접속 extdist.wmflabs.org (extdist.wmflabs.org)|185.15.56.49|:443... 접속됨.
HTTP request sent, awaiting response... 200 OK
Length: 166333 (162K) [application/octet-stream]
Saving to: ‘MsUpload-REL1_31-d854ddf.tar.gz’

MsUpload-REL1_31-d8 100%[===================>] 162.43K   387KB/s    in 0.4s    

2020-06-09 14:52:04 (387 KB/s) - ‘MsUpload-REL1_31-d854ddf.tar.gz’ saved [166333/166333]

study@study-VirtualBox:~/MW_Ext$ 


익스텐션 압축 풀기

study@study-VirtualBox:~/MW_Ext$ sudo tar -xzf MsUpload-REL1_31-d854ddf.tar.gz -C /var/www/html/w/extensions
[sudo] study의 암호: 
study@study-VirtualBox:~/MW_Ext$ 



윈도 서버의 경우

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


호스팅을 받는 경우

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




MsUpload 익스텐션 필수 설정

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

wfLoadExtension( 'MsUpload' );


설치 확인

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




MsUpload 익스텐션 사용법

MsUpload 익스텐션 전용 특수 확장 기능

아래는 LocalSettings.php에서 설정할 수 있는 MsUpload 익스텐션 전용 특수 확장 기능입니다

$wgMSU_useDragDrop = true; // 드래그앤 드롭 영역 표시(기본값이 아니므로 반드시 적어줄 것)
$wgMSU_showAutoCat = true; // 카테고리 페이지를 편집하는 동안 업로드된 파일 해당 카테고리에 추가
$wgMSU_checkAutoCat = true; // 페이지에 카테고리를 추가하기 위한 확인란의 기본 설정
$wgMSU_useMsLinks = false; // MsLinks 스타일로 링크를 삽입
$wgMSU_confirmReplace = true; // 파일 바꾸기 확인란 표시
$wgMSU_imgParams = 'thumb|none'; // 파이프로 구분 된 모든 이미지 매개 변수, e.g., {width}px, left, right, center, none, border, frameless, frame, thumb etc.


업로드 관련 전역 변수

업로드 관련 전역 변수들입니다.

$wgEnableWriteAPI = true; // API 활성화
$wgEnableUploads = true; // 업로드 활성화
$wgAllowJavaUploads = true; // Office 2007 및 최신 파일 (docx, xlsx 등)의 문제를 해결
$wgGroupPermissions['user']['upload'] = true; // 일반 사용자가 업로드할 수 있도록 허용

// 업로드 가능 파일 형식(확장자) 설정
$wgFileExtensions = array('png','gif','jpg','jpeg','doc','xls','pdf','ppt','tiff','bmp','docx','xlsx','pptx');


$wgFileExtensions 변수가 이미 설정되어 있는 경우 LocalSettings.php 파일 하단에 또 추가할 필요 없습니다.

만약 $wgFileExtensions 변수가 두 번 이상 사용되는 경우 업로드 기능이 정상적으로 작동하지 않을 수 있습니다.


MsUpload 익스텐션을 설치한 후 위키 문서 편집화면입니다.

LocalSettings.php 파일에 $wgMSU_useDragDrop = true; 코드를 추가해야 위 그림처럼 드래그 앤 드롭 영역이 추가됩니다.


이미지 파일 등록 준비 화면입니다.

선택한 파일들을 드래그 앤 드롭 영역에 끌어다 놓거나 MsUpload 버튼을 이용해 파일들을 선택하면 위 그림처럼 위키 서버에 파일을 업로드할 준비가 됩니다.

이 상태에는 파일이 실제로 업로드된 것은 아닙니다. 이 파일 올리기 버튼을 눌러야 실제로 위키 서버에 업로드되고 해당 파일 정보가 DB에 기록됩니다.


이 파일 올리기 버튼을 눌러 파일을 업로드한 후 문서 내 링크와 그림 넣기를 클릭한 화면입니다.


파일 업로드 후 문서 내 링크와 그림 넣기를 적용 후 문서 저장한 다음 읽어본 화면입니다.


링크를 클릭하면 위 그림처럼 해당 파일 정보가 표시됩니다.

'MsUpload로 파일을 올림'이라고 기록되어 있음을 확인할 수 있습니다.


기본적으로 위키는 이미지 외의 파일은 업로드가 불가능합니다. 따라서 따로 설정을 하지 않은 채 이미지 파일 외 다른 확장자의 파일을 올리려고 하면 위 그림처럼 경고 문구가 출력됩니다.


다른 파일도 업로드 가능하도록 설정 후 파일 등록을 시도하면 위 그림처럼 가능한 것을 볼 수 있습니다.

파일 업로드 가능 확장자 설정은 아래 링크를 참고하시기 바랍니다.


파일 업로드 후 링크 넣기를 적용한 모습입니다. 단 위 그림에서 사용된 파일은 이미지 파일이 아니므로 그림 넣기는 적용되지 않습니다.


파일 업로드 후 링크 넣기를 적용하여 문서 저장 후 읽어본 모습입니다.


링크를 누르면 해당 파일 정보가 표시됩니다.