構成設定マネージャープラグイン

構成設定マネージャーによりウィキ管理者はウィキの構成設定を簡単に変更することができるようになります。 設定の変更はオンラインでお気に入りのウェブブラウザ上から快適に行うことができます。

このプラグインは DokuWiki に同梱されています。 別途インストールを行う必要はありません。 構成設定マネージャーへは管理画面からアクセスすることができます（スーパーユーザーとしてログインを行い、 “管理” をクリックした後 “サイト設定” を選択します）。

各設定項目の表示は現在の状態を分かりやすくするため様々な背景を使って行われます。 青色の背景はデフォルト値（conf/dokuwiki.php）が表示されている場合に使用されます。 たとえば、 ユーザーによる変更が行われていない値です。 白色の背景はローカルな変更（conf/local.php）を意味します。 明るい赤色の背景は保護されている項目（conf/local.protected.php）を示しています。 これらの項目は変更することができません。

変更された項目を保存する際、 このプラグインは現在のローカル設定ファイル（conf/local.php）を conf/local.php.bak としてコピーし更新済みの設定を conf/local.php として保存します。 デフォルト設定に対する変更が conf/dokuwiki.php に保存されることは決してありません。 ただし、 構成設定オプションページで説明されているように conf/local.php に見られる設定がデフォルト設定よりも優先されます。

このプラグインは conf/local.php の更新を行う際に次の行をファイルの先頭に追加します：

/*
 * Dokuwiki's Main Configuration File - Local Settings 
 * Auto-generated by config plugin 
 * Run for user: <username>
 * Date: <current date/time, rfc 2822 format (day, dd MMM YYYY hh:mm:ss TZ)>
 */

特定の設定項目を conf/local.protected.php に置くことによりその設定項目を保護することができます。 このプラグインは conf/local.php の末尾に次の行を追加します —

@include(DOKU_CONF.'local.protected.php');

— それにより確実に保護設定項目のインクルードが行われ conf/dokuwiki.php と conf/local.php をもとに設定された以前の値を上書きします。 このファイルの中に見られるすべての設定項目はプラグインによって表示されます。 表示される項目は保護状態を表すため明るい赤色で囲まれています。 保護された値の編集は無効になっています。

構成設定データの保存を行えるようにするため、 conf/local.php および conf/local.php.bak のファイルパーミッションはウェブサーバーによる書き込みが可能になっている必要があります。 各種システム上でのファイルパーミッション設定に関する詳細についてはパーミッションを参照してください。

構成設定ファイルへの書き込みが行えないことをプラグインが検知した時点で、 プラグインがページの先頭に設定項目が読み込み専用になっており変更不可であることを説明するメッセージボックスを表示します。 通常はページの末尾に置かれている保存ボタンがこの場合には表示されません。