10.11. config.php変数¶
一部のサイトオプションは管理エリアでは設定できません。そのため、config.php
ファイルをサーバ上で直接更新する必要があります。このセクションでは可能な設定およびサイトの config.php
ファイルに設定を含める理由を理解します。
config.php
ファイルはサイトの /htdocs
ディレクトリにあります。可能なすべての変数とそのデフォルト値を見たい場合、 /htdocs/lib/config-defaults.php
に見つけることができます。config.php
ファイルに変数を置くことで、デフォルト値を上書きできます。
10.11.1. 設定変数分析¶
機能するには構成変数を正しい構文で記述する必要があります。Maharaではこれは次のように行われます: $cfg->変数 = 値;
$cfg->: 「設定」を意味します。後続するものが設定変数であることを示します。
変数 =: ここで設定されている変数を確認できます。一般的に1語またはアンダースコアで繋がれた単語から成ります。変数にはスペースを含めません。
value;: 変数が取得する値が表示されます。値は異なる場合があります。例えば次のようになります:
「true」 または 「false」
テキスト
数字
ファイルパス
注釈
Maharaのインスタンスで変数のデフォルトの動作を変更する場合、
config-defaults.php
ファイルからconfig.php
ファイルにコピーして、コードベースを更新するときに上書きされないようにします。config.php
ファイルはMaharaのアップデートやアップグレードによって決して変更されません。
10.11.2. developermode: 開発者モードを有効または無効にする¶
$cfg->developermode = true;
または $cfg->developermode = false;
開発者モードを有効にした場合、あなたのサイトで次の2つの自動的に変更されます:
debug.css
は各ページに含まれます。このファイルを編集して、自分の裁量でデバッグCSSを追加できます。MochiKitのアンパックされたバージョンが使用されます。【訳注】MochiKitはMahara 17.04以降削除されました。
注釈
developermode=true
は productionmode=false よりも強力ではありません。
10.11.3. openbadgedisplayer_source: Open Badgesディスプレイヤのソース¶
$cfg->openbadgedisplayer_source = '{"shortname":"url","shortname":"url"}';
「オープンバッジ」 ブロック にオープンバッジを表示するにはバッジをホストするサイトを設定する必要があります。デフォルトでは Mozilla Backpack <https://backpack.openbadges.org/> および `Open Badge Passport <https://openbadgepassport.com>`に接続できます。他のソースがある場合、それらを許可されたソースに追加する必要があります。
10.11.4. passwordsaltmain: サイト全体のpassword saltを設定する¶
$cfg->passwordsaltmain = 'your secret phrase here';
パスワードソルトは 「ハッシュ」 パスワードをデータベースでより安全に使用して、ハッキングをより困難にするのに役立ちます。フレーズを使うのはよいスタートです。パスワードはすでにデータベースにプレーンテキストで表示されていません。ハッシュされています。このソルトはそれをさらにランダム化するのに役立ちます。
あなたにパスワードsaltがない場合、 「管理ホーム」 ページで警告が表示されます。
10.11.5. pathtoclam: ウィルススキャナClamAVへのパス¶
$cfg->pathtoclam = '/path/to/your/clamscan';
サーバ上でウイルス対策エンジン ClamAV を実行しており、システムレベルでウイルスをスキャンしない場合、Maharaにファイルの場所を知らせて、アップロードされたファイルをスキャンします。セキュリティ上の理由から、サーバ上のClamAVへのパスを config.php
ファイルで指定する必要があります。
「セキュリティ設定」 で設定したパスを確認できます。
10.11.6. probationenabled: ユーザ保護観察状態を与える¶
$cfg->probationenabled = true;
または $cfg->probationenabled = false;
同じように $cfg->probationstartingpoints = 2;
を設定する必要があります。
ユーザの スパムの保護観察レベル を設定して自己登録ユーザが特にパブリックサイトに迷惑メールを投稿しないようにできます。これを行うには次の2つの変数を使用します:
$cfg->probationenabled = true;
: この設定ではユーザが保護観察を受けることができるかどうかを決定します。$cfg->probationstartingpoints = 2;
: この設定では新しく自己登録されたユーザがデフォルトごとに保持する保護観察ポイントの数を指定します。この例ではユーザがすべての機能を利用できるようになるには2つの保護観察ポイントが必要になります。
保護観察ポイントは*管理* の ユーザのアカウント設定ページ で個別に変更できます。
あなたが保護観察を有効にした場合、ページやアーティファクにコメントを残してログインしていないユーザはURLを投稿することはできません。
10.11.7. productionmode:プロダクションモードを有効または無効にする¶
$cfg->productionmode = true;
または $cfg->productionmode = false;
プロダクションモードが無効になっている場合は画面上部にその旨を示すメッセージが表示されます。
テストサイトや開発サイトでは多くのパラメータが適切なデフォルト値で上書きされます。現在のパラメータのリストについては init.php
を参照してください。これらの設定には次が含まれます:
デバッグ情報、警告メッセージ、および環境ターゲットを画面とエラーログに出力します。これにより、画面に直接表示されるエラーメッセージをすばやく確認できます。
開発者モード を有効にします。
キャッシュを無効にします。
注釈
逆説的に productionmode=false
は適切な開発者モードのデフォルトで多くの設定を上書きするため、テスト/開発サイトで設定を微調整する場合は productionmode=true
を設定する必要があります。
10.11.8. remoteavatarbaseurl: リモートアバターサーバURL¶
$cfg->remoteavatarbaseurl = 'https://example.com/avatar/';
ユーザのプロファイル画像はGravatarなどのアバターサービスから取得できます。あなた自身のサービス、例えば、Libravatar を実行する場合、この構成変数を使用してMaharaを直接指すことができます。
あなたはリモートの化身を表示するかしないかを 「ユーザ設定」 で決めます。
10.11.9. renamecopies: コピーされたページおよびコレクションを改名する¶
$cfg->skins = true;
または $cfg->skins = false;
サイト管理者はコピーしたページやコレクションに対して 「のコピー」 を追加できます。 $cfg->renamecopies = true
の場合、新しいページとコレクションのコピーにはそのタイトルの後に 「のコピー」 が付加されます。デフォルトの設定は $cfg->renamecopies = false;
です。【訳注】デフォルトの設定の場合、コピーにはそのタイトルの後に 「v.2」 のようなコピー回数に応じた文字列が付加されます。
10.11.10. showloginsideblock: ログインサイドブロックを表示するまたは隠す¶
$cfg->showloginsideblock = true;
または $cfg->showloginsideblock = false;
config.php
ファイルに値 $cfg->showloginsideblock = false
を追加してログインフォームを非表示にできます。これを実行した場合、管理者、またはMaharaアカウントを持つ他のユーザがサイトにログインするためのログインフォームへのリンクだけが表示されます。
これはシングルサインオンを設定し、別のサイトからMaharaに自動的にログインする場合に便利です。
デフォルトでは値は 「true」 に設定され、ログインサイドブロックが表示されます。
10.11.11. sitethemeprefs: 任意のテーマからブラウズテーマを選択する¶
$cfg->sitethemeprefs = true;
または $cfg->sitethemeprefs = false;
サイト管理者が許可した場合、 「アカウント設定」 ページで閲覧テーマとして使用可能なテーマを選択できます。その場合、インスティテューションのテーマだけを使用するように制限されたり、複数のインスティテューションのメンバである場合はそれらのどちらかのテーマを選択するように制限されることはありません。
10.11.12. スキン¶
$cfg->skins = true;
または $cfg->skins = false;
テーマを選択する以外にユーザが自分のポートフォリオページをパーソナライズできるようにできます。これはMaharaの スキン を介して行われます。スキンは サイトレベル または個人によって作成できます。インスティテューションはユーザに スキンの使用を許可または拒否 できます。
10.11.14. usersuniquebyusername: 内部のMaharaユーザ名は外部の認証方法を接続するときに優先される¶
$cfg->usersuniquebyusername = true;
あるいは $cfg->usersuniquebyusername = false;
これは 実験的な機能 です。この設定を有効にした場合、ユーザのSSOがどのアプリケーションから来ているかには関係なく、内部ユーザ名が一致し、リモートユーザ名が無視されるため、Maharaで同じアカウントが与えられることになります。