본문 바로가기
미디어위키

Extension UploadWizard

by 다움위키 2023. 12. 29.

UploadWizard은 사용자에게 단계별로 구성된 자바-스크립트 마법사로 여러 파일을 업로드할 수 있도록 도와줍니다. 자세한 내용은 다음을 참조하십시오: Upload Wizard description page on Wikimedia Commons

Installation

미디어위키 확장 내려받기 지면에서 해당 판을 내려받아서 정해진 위치로 이동시킵니다.

미디어위키 설정 LocalSettings.php 파일에 다음을 추가합니다:

wfLoadExtension( 'UploadWizard' );

Special:Version에 접근해서 확장이 정상적으로 설치가 되었는지 확인을 합니다.

Configuration

이전에 파일을 업로드하는 환경을 구축했다면, 다음과 같은 설정이 있어야 합니다:

$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
$wgFileExtensions = array('png','gif','jpg','jpeg');
$wgFileBlacklist = array('html','htm','php','phtml','php3','php4','php5');
$wgCheckFileExtensions = true;
$wgStrictFileExtensions = true;
$wgUploadSizeWarning = 10000000;

만약 UploadWizard 확장이 IE에서 제대로 동작하기 원한다면, 다음의 설정을 추가해야 합니다:

$wgApiFrameOptions = 'SAMEORIGIN';

라이센스 설명에 접근하기 위해서는, InstantCommons를 활성화해야 합니다:

$wgUseInstantCommons = true;
설명서에는 Wikimedia Commons에 업로드하는 것으로 나오기 때문에 이미지의 수정이 필요합니다.

사이드 바의 업로드 링크를 UploadWizard 확장으로 바꾸기 위해서는 다음을 추가합니다:

$wgUploadNavigationUrl = '/wiki/Special:UploadWizard';

반면에, 위키의 경로를 정확히 모르거나, 앞으로 바꿀 계획이 있는 상황이라면, 경로에 구애받지 않는 방법으로 설정하는 것이 좋습니다:

$wgExtensionFunctions[] = function() {
    $GLOBALS['wgUploadNavigationUrl'] = SpecialPage::getTitleFor( 'UploadWizard' )->getLocalURL();
    return true;
};

여러 가지 다른 선택사항을 구성 배열을 통해서 설정할 수도 있습니다:

$wgUploadWizardConfig = array(
    'debug' => false,
    'autoAdd' => array(
         'wikitext' => array(
            'This file was uploaded with the UploadWizard extension.'
            ),
         'categories' => array(
              'Uploaded with UploadWizard'    
              ),
        ), // Should be localised to the language of your wiki instance
    'feedbackPage' => 'Feedback about UploadWizard',
    'altUploadForm' => 'Special:Upload',
    'fallbackToAltUploadForm' => false,
    'enableFormData' => true, // Should FileAPI uploads be used on supported browsers?
    'enableMultipleFiles' => true,
    'enableMultiFileSelect' => false,
    'uwLanguages' => array(
        'ko' => 'Korean',
        'en' => 'English'
        ), // Selectable languages for file descriptions - defaults to 'en'
    'tutorial' => array(
         'skip' => true
        ), // Skip the tutorial
    'maxUploads' => 15, // Number of uploads with one form - defaults to 50
    'fileExtensions' => $wgFileExtensions // omitting this may cause errors
    );

Usage in license-free environments

라이선스가 사용되지 않는 환경에서 UploadWizard를 설치하는 경우에는, LocalSettings.php에 아래의 구성을 추가할 수 있습니다. 이렇게 하면 라이선스 선택 사항이 위키의 일반 면책 조항을 참조하는 단일 기본값으로 제한됩니다. 사용 사례에 따라 추가할 수 있는 기타 많은 구성 설정이 있습니다.

$wgUploadWizardConfig = array(
    'licensing' => array(
        'ownWorkDefault' => 'own',
        'ownWork' => array(
            'type' => 'or',
            'template' => 'licensing', // this adds a link to Template:Licensing to the file info page
            'licenses' => array(
                'generic',
            )
        ),
    ),

);
이것들은 단지 몇 가지 표본 설정입니다. $wgUploadWizardConfig 배열에서 지원되는 더 많은 옵션을 보려면 "UploadWizard.config.php" 파일(60 행 전후)을 참조하십시오.