틀:확장기능설치

From mediawiki.org
This page is a translated version of the page Template:ExtensionInstall and the translation is 89% complete.
Outdated translations are marked like this.
  • 파일을 다운로드하고 ExtensionInstall 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
Template documentation

사용법

Add instructions about installing an extension.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Extension name1

Set the extension name manually.

Default
The current page name without namespace prefix.
Auto value
{{ROOTPAGENAME}}, i.e. the page name without namespace nor subpages
Stringoptional
Vagrant role namevagrant

If given, shows how to install extension with the vagrant's enable-role command

Auto value
Stringoptional
Download linkdownload-link

Overwrite the download link.

Default
Link to ExtensionDistributor with the extension name.
URLoptional
LocalSettings earlylocalsettingsearly

Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.

Example
$wgUseAjax = true; //must be included before the extension is loaded
Unknownoptional
LocalSettingslocalsettings

Pass custom php code that the user should include in [[LocalSettings.php]].

Example
$wgUseAjax = true;
Unknownoptional
Database updatedb-update

If the extension has one or more database tables that need to be created through [[update.php]], set this parameter to any value.

Default
false
Booleanoptional
Composercomposer

If the extension uses [[Composer]] to manage dependencies, set this parameter to any value.

Default
false
Booleanoptional
Custom steps 0custom-steps0

Additional steps before download, e.g. other required extensions (as an unordered "* list")

Contentoptional
Custom stepscustom-steps

Additional steps (as an unordered "* list")

Contentoptional
Supports registrationregistration

Changes the template to use <code>wfLoadExtension()</code> if it supports registration. Set to any value if the extension supports registration, or to <code>required</code> if it <em>only</em> supports registration and doesn't support the old-style of loading.

Stringoptional
No registration versionno-registration-version

The MediaWiki version for which extension registration should not be used

Default
1.24
Unknownoptional

예제

아래에는 이 틀을 사용하는 방법에 관한 몇 가지 예제가 있습니다:

단순

{{ExtensionInstall}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

이름

{{ExtensionInstall|CategoryTree}}
  • 파일을 다운로드하고 CategoryTree 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/CategoryTree/CategoryTree.php";
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

다운로드 링크

{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
  • 파일을 Download하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

LocalSettings

{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    $wgUseAjax = true;
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

LocalSettings early

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // this must be included before the extension is loaded
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    $wgUseAjax = true; // this must be included before the extension is loaded
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

DB 업데이트

{{ExtensionInstall
|db-update=Yes
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • 갱신 스크립트를 실행합니다. 이 스크립트는 이 확장기능을 필요로 하는 데이터 베이스 테이블을 자동적으로 작성합니다.
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

컴포저

{{ExtensionInstall
|composer=Yes
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • Git에서 설치할 경우, PHP 의존 기능을 설치하려면 Composer를 실행하여 확장 기능 디렉터리에 composer install --no-dev를 발행하십시오. (잠재적인 문제에 대해서는 작업 T173141 을 참고하십시오.)
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

사용자 지정 단계

{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

지원 등록

{{ExtensionInstall
|registration=1
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    wfLoadExtension( 'MyExtension' );
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

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

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

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

권장되는 등록 미디어위키 버전 설정

{{ExtensionInstall
|registration=1
|no-registration-version=1.25
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    wfLoadExtension( 'MyExtension' );
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

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

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

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

등록 욕구

{{ExtensionInstall
|registration=required
}}
  • 파일을 다운로드하고 MyExtension 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    wfLoadExtension( 'MyExtension' );
    
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

모든 것

{{ExtensionInstall|Example
|download-link=[http://bits.wikimedia.org/example.zip Download]
|vagrant=example
|localsettings=
$wgUseAjax = true;

|db-update=Yes
|composer=Yes
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
|registration=yes
}}
  • 파일을 Download하고 Example 폴더를 extensions/ 디렉토리에 넣어 주세요.
  • Git에서 설치할 경우, PHP 의존 기능을 설치하려면 Composer를 실행하여 확장 기능 디렉터리에 composer install --no-dev를 발행하십시오. (잠재적인 문제에 대해서는 작업 T173141 을 참고하십시오.)
  • 아래의 코드를 $LocalSettings의 말미에 추가합니다:
    wfLoadExtension( 'Example' );
    $wgUseAjax = true;
    
  • 갱신 스크립트를 실행합니다. 이 스크립트는 이 확장기능을 필요로 하는 데이터 베이스 테이블을 자동적으로 작성합니다.
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

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

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

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


Vagrant installation:

  • Vagrant 를 사용하고 있는 경우에는, vagrant roles enable example --provision로 설치해주세요