Manual:Extensions/ja

{| style="border: 2px solid #aaa; padding: 1em 2em; margin: 1em 0 2em 0; width:auto; margin:0 auto; float: " |

拡張機能とは
拡張機能とは、MediaWiki の外観や動作をカスタマイズさせるものです.

ウィキの利用者は、既存の拡張機能を閲覧したり、新たな拡張機能を要求することができます. 管理者であれば MediaWiki 上の拡張機能を管理することができ、インストール、あるいは削除を行うことができます. 開発者は、新しい拡張機能の作成や改善・改良ができます.

拡張機能をキーワードで検索:
 * style="textalign: center; valign: middle; padding: 0 2em" |


 * }

拡張機能は以下のように使われます:


 * 記事を書くのに使用されるウィキマークアップを拡張します - 例は と  を参照してください.
 * 特別ページを通して新しい報告と運営上の機能を追加します - 例はCategory:Special page extensionsをご覧下さい.
 * MediaWiki の見た目を変更します - 例は Special:AllPages/Skin: および を参照してください.
 * カスタム認証メカニズムを使用してセキュリティを強化します - 例は を参照してください.

拡張機能には、MediaWikiの開発者によってメンテナンスされているものもありますが、サードパーティーの開発者によって書かれたものもあります. その結果、拡張機能の多くがバグを有し、相互に互換性があることを保証されているわけではありません. 一部のものはメンテナンスがされていません. したがって、すべての拡張機能が、MediaWikiのすべてのバージョンで動作するわけではありません. どの拡張機能であっても、特に安全ではないというタグが付けられたものについては、自己責任で使用して下さい. もし、MediaWiki本体のコードや、データベースのエントリにパッチをあてなければならない拡張機能を使う場合には、あなたのWikiが回復しない損害を受けるリスクを避けるためにも、データベースやMediaWikiのコードのバックアップをとることを忘れないでください.

拡張機能の参照
では、これまで書かれたあらゆる種類の拡張機能を閲覧することができます. も、拡張機能を選ぶ際には有益でしょう. これらの拡張機能をインストールしたり、独自のものを作ったりするための情報については、下記をご覧下さい.

インストールされた拡張機能の確認
MediaWikiに拡張機能をインストールできるのは、サーバのファイルシステム（データベースを含む場合も多い）にアクセスできる管理者に限られますが、誰でも Special:Version ページにアクセスすることで、MediaWikiのインスタンスでどの拡張機能がアクティブになっているかを確認することができます. たとえば、英語版ウィキペディアで利用できる拡張機能

拡張機能のインストール
MediaWiki はインストールが終わった直後に既に拡張機能を受け入れる用意ができています. 拡張機能を追加するために以下のステップに従います:


 * 1) 始める前に
 * いくつかの拡張機能はパッチのインストールが要求されます. それらの多くはunixコマンドの使用によるインストールのために設計された手引きを提供しています. 拡張機能ヘルプページにリスト表示されたこれらのコマンドを入力するためにシェルアクセス(SSH)の権限が要求されることもあります.
 * 1) 拡張機能をダウンロードする. 
 * Extension Distributor は、よく用いられている拡張機能を選び、ダウンロードする手引となります.
 * 通常、拡張機能はモジュール パッケージとして配布されます. それらは一般的に   の独自のサブディレクトリに入ります.   ウィキメディアの Git リポジトリに保存された拡張機能の一覧は git:mediawiki/extensions にあります.  拡張機能の中には、履歴管理をしていないものがあり、使用は推奨されません.
 * 拡張機能のなかにはbundles、、package repositoriesで利用可能なものもあります.
 * 1) 拡張機能をインストールする. .
 * 一般的に、 ファイルの終わりに、(PHPのコードの終わりの区切り文字、" "の上に)、次の行を追加します:
 * この行はPHPインタプリタに拡張機能ファイルを読み込むことを強制し、その結果MediaWikiにアクセス可能にします.
 * 拡張機能の中には、たとえば$_SERVERに直接アクセスするような（推奨されていません）、メンテナンススクリプトと衝突するものもあります.
 * In this case they can be wrapped in the conditional so maintenance scripts can still run.
 * In this case they can be wrapped in the conditional so maintenance scripts can still run.


 * The maintenance script will fail for any extension which requires customized namespaces which is included inside the conditional above such as,.


 * Ensure that required permissions are set for extensions!
 * While this installation procedure is sufficient for most extensions, some require a different installation procedure. Check your extension's documentation for details.
 * If you want to alter configuration variables in LocalSettings.php, you have to do this typically after including the extension. Otherwise defaults defined in the extension will overwrite your settings.
 * While extension declaration can be placed in other places within the LocalSettings.php file, never place extensions before the  line for MediaWiki versions below 1.17 . Doing so will blank the extension setup function arrays, causing no extensions to be installed, and probably will make your wiki inaccessible until you fix it!

拡張機能のアップグレード
Some extensions require to be updated whenever you update MediaWiki, while others work with multiple versions. To upgrade to a new version of an extension:


 * 1) Download the new version of the extension
 * 2) Replace all the extension files in the extension/ExtensionName directory with the new files. Do not remove the extension configuration present in LocalSettings.php
 * 3) Depending on the extension, you may have to run the Update.php maintenance script. Most extensions will mention if this script needs to be run or not. (Running the update.php script when its unnecessary will not hurt anything, so if you're unsure don't be afraid to run it). If you don't have command line access, you can also use the web updater.
 * 4) That's all you need to do. In most cases any extension configuration you have in LocalSettings.php will also work with the newer version of the extension.

These instructions cover 99% of extensions. If the specific extension you are upgrading has instructions that differ from these, you should probably follow the specific extension's instructions

拡張機能のアンインストール
Extensions are added by adding a line to LocalSettings.php, which basically looks like this:

Depending on the extension you want to uninstall additionally other stuff might be done on installation, which you want to undo now. For details see the section on installing an extension.


 * 1) Remove this line and the extension is uninstalled. If you want to, you can (and if you do not want to use this extension in the future you should) remove the files of this extension inside the folder "extensions/".
 * 2) Maybe you also have some other lines in LocalSettings.php, which have to do with the extension you want to remove. Most likely this will be lines, which give certain users the right to access pages, which are provided by the extension. These lines contain the variable "$wgGroupPermissions" and make some settings there. As far as they have to do with rights, which come from the removed extension, you can remove these lines as well.
 * 3) Maybe your extension also has added columns to your database. The updater maintenance/update.php removes them, when you run it, after you have uninstalled the extension.

拡張機能の開発
This complex topic is handled on the developing extensions manual page.

関連項目

 * Project:Extension requests
 * - Information about translating extensions.
 * Project:Extension requests
 * - Information about translating extensions.
 * Project:Extension requests
 * - Information about translating extensions.
 * Project:Extension requests
 * - Information about translating extensions.
 * - Information about translating extensions.