본문 바로가기
미디어위키

Extension SimpleBatchUpload

by 다움위키 2024. 11. 10.

원문 보기: https://dawoum.duckdns.org/wiki/Extension:SimpleBatchUpload

 

 

SimpleBatchUpload 확장은 jQuery 파일 업로드 자바스크립트 라이브러리를 사용하여 "Special:BatchUpload"에서 여러 파일을 미디어위키에 기본적이고 간편하게 업로드하는 것을 허용합니다.

Download

이 확장을 다운로드하기 위한 권장되는 방법은 mw:Composer를 사용하는 것입니다.

미디어위키 composer.local.json 파일에 다음을 추가하고 미디어위키 설치 디렉터리에서 php composer.phar update mediawiki/simple-batch-upload를 실행하십시오.

{
	"require": {
		"mediawiki/simple-batch-upload": "^2.0"
	}
}

단지 extension.phar update mediawiki/simple-batch-upload를 업데이트하기 위해 다시 php composer를 실행하십시오.

대안적으로, GitHub에서 타르볼이나 zip 파일을 다운로드해서 미디어위키 설치 디렉토리의 extensions 디렉터리에 압축을 풀 수 있습니다.

Installation

"LocalSettings.php" 파일에 다음 줄을 추가하십시오:

wfLoadExtension( 'SimpleBatchUpload' );

SimpleBatchUpload가 올바르게 설치되었는지 확인하기 위해, Special:Version에 해당 항목이 있는지 확인하고 Special:BatchUpload가 작동하는지 확인하십시오.

확장을 사용하기 위해, 사용자에게 writeapi 권한이 필요합니다. 이것은 등록된 사용자를 위한 기본 미디어위키 설정이지만 위키 구성 중에 변경되었을 수 있습니다.

Usage

이 확장을 사용하여 파일을 업로드하는 방법은 네 가지가 있습니다:

  • 일반 업로드 페이지를 얻기 위해 Special:BatchUpload로 가십시오.
  • 업로드된 파일 페이지의 위키텍스트로 {{Foo}}를 설정하는 업로드 페이지를 얻기 위해 Special:BatchUpload/Foo로 가십시오.
  • 간단한 업로드 버튼을 얻기 위해 임의의 위키페이지에 {{#batchupload:}}를 추가하십시오.
  • 업로드된 파일 페이지의 위키텍스트로 {{Foo|Bar|Baz}}를 설정하는 업로드 버튼을 얻기 위해 임의의 위키페이지에 {{#batchupload:Foo|Bar|Baz}}를 추가하십시오.
위키텍스트는 새로 업로드된 파일에만 설정될 것입니다. 만약 파일이 이미 존재하면, 파일의 새 버전을 이후에 업로드해도 위키텍스트는 변경되지 않을 것입니다.

Customization

MediaWiki:Simplebatchupload-parameters 페이지를 편집함으로써 특정 파일 유형에 대한 전용 업로드 페이지를 지정할 수 있습니다. 해당 페이지의 각 줄은 하나의 매개변수 집합으로 고려됩니다.

사용 가능한 매개변수는 다음과 같습니다:

  • 초기 업로드 시 텍스트로 저장할 템플릿의 이름
  • 업로드 주석
  • Special:BatchUpload/subpage 페이지의 제목 줄

매개변수는 파이프 (|)로 구분해야 합니다.

사용할 줄은 Special:BatchUpload 페이지의 URL에 하위 페이지로 템플릿 이름을 덧붙임으로써 선택됩니다.

템플릿 이름에서 공백은 이 과정을 실패하는 원인이 될 것입니다.

Example:

매개변수 줄을 생각해 보십시오:

 Pics | These pics were uploaded using [[Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]] | Upload some pics!
  • 이것은 Special:BatchUpload/Pics로 감으로써 선택될 수 있습니다.
  • 이 페이지의 제목은 "Upload some pics!"입니다.
  • 업로드에 대한 주석은 "These pics were uploaded using SimpleBatchUpload"가 됩니다.
  • 해당 이름을 가진 파일이 처음으로 업로드되면 {{Pics}}가 위키텍스트로 포함됩니다.

Configuration

$wgSimpleBatchUploadMaxFilesPerBatch

사용자 그룹에 따라 매번 업로드할 수 있는 최대 파일 수를 정의하는 배열입니다. 사용자가 더 큰 파일 배치를 업로드하려고 하면 오류 메시지가 표시됩니다.

기본값:

$wgSimpleBatchUploadMaxFilesPerBatch = [
	'*' => 1000,
];
이것은 파일 업로드를 차단하거나 속도를 조절하기에 올바른 설정이 아니라는 점을 알아두십시오!

사용자는 일반 파일 업로드나 미디어위키 API를 계속 사용할 수 있습니다.

업로드를 선택적으로 차단하려면, Manual:Configuring file uploads를 참조하십시오. 업로드 조절을 제한하려면 $wgRateLimits를 참조하십시오.

See also