拡張機能のインストール方法

MediaWikiでは機能の追加は拡張機能というものを、MediaWikiのプロジェクトページからダウンロードしてセットアップします。これはワードプレスのプラグインに相当するものです。文字通り機能の拡張であって見た目（外装）には基本的には影響しません。このページでは、MediaWikiに拡張機能をインストールして使えるようにするまでの基本的な流れを説明します。

拡張機能を探す

まずは、MediaWikiでどういう機能を実装したいのかGoogleで検索するところから始めます。MediaWikiの拡張機能は多岐にわたり数多くありますので、探すのが大変です。しかも、MediaWikiを本格的に運用している事例が少ないことから資料となるWEBサイトもワードプレスの参考資料となるWEBサイトと比較すると10分の1くらいではないかと思われます。
これは、誇張しているわけではなく本当に資料が少ないです。色々なキーワードや文章で検索しても、ヒットするのは、たいていMediaWikiプロジェクトのヘルプばかり。しかも、そのヘルプは数年前の資料であることなどザラです。本サイトも体裁を整えるために拡張機能を色々探してまわり形になるのに5日ほどかかっています。これがワードプレスだったら、必要なプラグインというのはたいてい決まっていてそれを管理画面上からアップロードして有効化してと、全部ブラウザで完結するのですがMediaWikiはそうはいきません。ある程度WEBシステムを分かっている人が管理すること前提で設計されているようで、必要なソフトウェアがいくつかあります。

必要なソフトウェア

拡張機能をインストールする上で必要なソフトウェアを挙げていきます。

MediaWiki ウィキペディアを動かすくらい大規模なWEBサイトを構築できるWikiプログラム。これがないと始まらないです。
explzh ファイル・フォルダの圧縮解凍ソフト。様々な圧縮形式に対応していてフリーソフトウェア。
FileZilla FTPによるファイル転送ソフトウェア。バージョンアップしてFTPの安定性が増しました。フリーソフトウェア。
サクラエディタ主にLocalSettings.phpを編集するのに使います。Windows 10/11なら標準のテキストエディタでも大丈夫かもしれませんが、UTF-8の文字コード、LF改行コードで編集できるテキストエディタならなんでも大丈夫です。

ダウンロード方法

多くの拡張機能は、MediaWikiのプロジェクトページのExtensionsページにダウンロードリンク、またはGitプロジェクトのページリンクがあります。MediaWikiのバージョンにあったファイルをプルダウンで選択してダウンロード開始ボタンを押します。すると数秒待つとダウンロードを開始します。ファイルはtar.gz形式の圧縮ファイルがほとんどです。このファイルは、windows 10/11標準のzip形式とは違うので普通は解凍できません。そのため、圧縮・解凍ソフトを使用します。

セットアップ方法

拡張機能をダウンロード・解凍したら、extensions/ フォルダの下に解凍したフォルダをそのまま配置します。たいていの拡張機能ファイルは解凍すると拡張機能名のフォルダの中にファイルが存在しています。

例:extensions/ExtensionName このように拡張機能名の最初が大文字で、途中のキーワードになる文字の最初も大文字になっていることがほとんどです。

このExtensionNameフォルダを丸ごとFTPでサーバーにアップロードしていきます。場所はサーバー内のextensions/ フォルダです。
extensions/ExtensionName　と拡張機能を配置することができたら第一段階終了です。

LocalSettings.phpの設定

LocalSettings.phpの設定方法は、たいていMediaWikiの拡張機能ページの中盤あたりに解説されています。英語版のこともよくあるのでChromeブラウザの「日本語に翻訳」が大活躍します。LocalSettings.phpに記述するコードは主に2つです。

wfLoadExtension( 'ExtensionName' );拡張機能のプログラムをロードするコード。バージョンが新しいものでのコードです。2023年11月現在の最新バージョンは1.40.1です。もうすぐ1.41.0がリリースされます。
$wgExtensionNameSetting = true;など。このような設定パラメータをLocalSettings.phpに記述する必要がある場合があります。この設定については、各拡張機能ページに解説が載っています。

動作確認

ここまできたら、あとはMediaWikiの動作確認です。セットアップした拡張機能が動作しているか実際にMediaWikiにアクセスして確かめましょう。このコードの記述をミスしていると、インターナルサーバーエラー500になります。そうなったら慌てずにLocalSettings.phpをじっくり見て、編集した箇所に記述ミスがないか確認しましょう。たいていは文字コードがUTF-8になっていなかったり、改行コードがLFになっていなかったりです。あとは;の書き忘れくらいでしょうか。記述した文字の大文字・小文字はプログラムでは厳密に区別されますのでこれも注意です。

拡張機能のインストール・セットアップは上記の繰り返しです。慣れれば一つの機能のセットアップは10分もかからないでしょう。しかし、拡張機能を探すのにとても時間がかかります。

動作環境

参考資料

MediaWikiプロジェクト関連のページ

MediaWikiを運用していて、技術的な解説をしているWEBサイトをいくつかご紹介します。