틀:확장기능설치
- 파일을 다운로드하고
ExtensionInstall폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall
- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
| 이 틀은 루아를 사용합니다: |
사용법
Installation instructions.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Extension name | 1 | Set the extension name manually.
| String | optional |
| Git submodule | git-submodule | Add --recurse-submodules to the git clone command | Boolean | optional |
| Vagrant role name | vagrant | If given, shows how to install extension with the Vagrant's enable-role command | String | optional |
| Download link | download-link | Overwrite the download link.
| URL | optional |
| LocalSettings early | localsettingsearly | Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.
| Unknown | optional |
| LocalSettings | localsettings | Pass custom PHP code that the user should include in [[LocalSettings.php]].
| Unknown | optional |
| Database update | db-update | If the extension requires the update script to be run, set this parameter to any value. (For example, if it has one or more database tables that need to be created.)
| Boolean | optional |
| Composer | composer | If the extension uses Composer to manage dependencies, set this parameter to any value. Not that this does not indicate that the extension is able to be installed with Composer.
| Boolean | optional |
| Custom steps 0 | custom-steps0 | Additional steps before download, e.g. other required extensions (as an unordered "* list"). | Content | optional |
| Custom steps | custom-steps | Additional steps (as an unordered "* list"). | Content | optional |
| Supports registration | registration | 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. | String | optional |
| No registration version | no-registration-version | The MediaWiki version for which extension registration should not be used.
| Unknown | optional |
See also
예시
아래에는 이 틀을 사용하는 방법에 관한 몇 가지 예제가 있습니다:
단순
{{ExtensionInstall}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/MyExtension/MyExtension.php";완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
이름
{{ExtensionInstall|CategoryTree}}
- 파일을 다운로드하고
CategoryTree폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/CategoryTree/CategoryTree.php";완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
다운로드 링크
{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
- 파일을 Download하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/MyExtension/MyExtension.php";완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
LocalSettings
{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/MyExtension/MyExtension.php"; $wgUseAjax = true;완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
LocalSettings early
{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // This must be included before the extension is loaded
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
$wgUseAjax = true; // This must be included before the extension is loaded require_once "$IP/extensions/MyExtension/MyExtension.php";완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
DB 업데이트
{{ExtensionInstall
|db-update=Yes
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/MyExtension/MyExtension.php";- 갱신 스크립트를 실행합니다. 이 스크립트는 이 확장기능을 필요로 하는 데이터 베이스 테이블을 자동적으로 작성합니다.
완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
컴포저
{{ExtensionInstall
|composer=Yes
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Git에서 설치할 경우, PHP 의존 기능을 설치하려면 Composer를 실행하여 확장 기능 디렉터리에
composer install --no-dev를 발행하십시오. (잠재적인 문제에 대해서는 T173141 을 참고하십시오.)- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/MyExtension/MyExtension.php";완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
사용자 지정 단계
{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
require_once "$IP/extensions/MyExtension/MyExtension.php";- Lorem ipsum dolor sit amet
- Foo bar baz quux sandbox
완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
지원 등록
{{ExtensionInstall
|registration=1
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
wfLoadExtension( 'MyExtension' );완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
Support registration with minimum version
{{ExtensionInstall
|registration=1
|no-registration-version=1.39
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
wfLoadExtension( 'MyExtension' );완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
미디어위키 1.39 이하를 실행 중인 사용자에게:
위의 지시사항은
wfLoadExtension()을 사용하여 이 확장기능을 설치하는 새로운 방법을 기술한 것으로,wfLoadExtension( 'MyExtension' );대신 초기 버전(미디어위키 1.39 이하)에 이 확장기능을 설치하려면 다음을 사용해야 합니다:require_once "$IP/extensions/MyExtension/MyExtension.php";
This only works if the version specified is 1.39 or later, otherwise the template assumes nobody cares about ancient versions and falls back to #Require registration.
등록 필요 여부 설정
{{ExtensionInstall
|registration=required
}}
- 파일을 다운로드하고
MyExtension폴더를extensions/디렉토리에 넣어 주세요.
개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.
wfLoadExtension( 'MyExtension' );완료 – 위키의 ‘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.php 코드의 마지막에 추가합니다.
wfLoadExtension( 'Example' ); $wgUseAjax = true;- 갱신 스크립트를 실행합니다. 이 스크립트는 이 확장기능을 필요로 하는 데이터 베이스 테이블을 자동적으로 작성합니다.
- Lorem ipsum dolor sit amet
- Foo bar baz quux sandbox
완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.
미디어위키 1.39 이하를 실행 중인 사용자에게:
위의 지시사항은
wfLoadExtension()을 사용하여 이 확장기능을 설치하는 새로운 방법을 기술한 것으로,wfLoadExtension( 'Example' );대신 초기 버전(미디어위키 1.39 이하)에 이 확장기능을 설치하려면 다음을 사용해야 합니다:require_once "$IP/extensions/Example/Example.php";
Vagrant 설치:
- Vagrant를 사용하고 있는 경우에는,
vagrant roles enable example --provision로 설치해주세요