9.6. 拡張機能

管理 → 拡張機能

注釈

拡張機能 にはサイト管理者だけアクセスすることができます。

Maharaの拡張機能はシステム内で特定の機能を提供します。拡張機能はどのタイミングでもインストールすること、また非表示にすることもできます。

9.6.1. プラグイン管理

管理 → 拡張機能 → プラグイン管理

*プラグイン管理*には現在あなたのMaharaインスタンスにインストールされているプラグインすべてが一覧表示されます。また、利用可能なプラグイン設定へのリンクが提供されます。

Plugins in Mahara are always installed and can be accessed if users know the URLs and would otherwise have access. Rather than enabling and disabling the functionality, plugins are hidden or made visible by clicking on the hide or show links beside the plugins. When hiding an artefact type plugin, Mahara stops the display of the blocks related to it.

Warning when a plugin is not yet installed

プラグインがインストールされていない場合の警告

If you added a plugin to your site or if a new plugin was added to Mahara since the last upgrade that you performed, you will need to go through its installation. A plugin that is not yet fully installed is marked with a warning and listed first in its section. Click the Install link to start the installation process.

プラグインを完全に削除するには、プラグインに関連するコードとすべてのデータベーステーブルを削除する必要があります。さらに、いくつかのシステムテーブル（例えば、 「artefact」、 「artefact_config」、 「artefact_cron」 など）から削除する必要があります。一例として、My Learningプラグインをアンインストールする方法についての情報 を表示します。

注釈

Core Mahara functionality can be made unavailable to users by hiding it. This may be useful if you connect Mahara to another system that already provides this functionality or if you do not wish your users to use that functionality. However, the decision about hiding a functionality should be considered thoroughly as it may also mean that users may not be able to have as many artefacts available to them as they should have.

以下では、追加設定のあるプラグインだけに関して説明します。

9.6.1.1. blocktype: file/folder

フォルダ ブロックに表示されるファイルのデフォルトの並べ替え順序と、フォルダ ブロックを含むポートフォリオページの閲覧者がフォルダの内容をzipファイルとして一度にダウンロードできるかどうかを決定できます。

Configure the Folder block

フォルダ ブロックを設定する

  1. デフォルト並べ替え順: フォルダ 内のファイル表示のデフォルト並べ替え順をアルファベットの昇順または降順に決定します。

    注釈

    ページ作成者はそれぞれのブロックで並べ替え順を変更することができます。

  2. Download folders as zip files: If you turn this setting on, you can download the contents of a folder displayed in a Folder block as zip file. Thus, it is very easy for a viewer to grab all files at once and download them to their computer.

    参考

    サイト管理者は アーティファクトタイプ: ファイル設定 でどのくらいの時間ZIPファイルをサーバ内に保持するか決定します。

9.6.1.3. blocktype: file/internalmedia

ユーザが 埋め込みメディアブロック 内に埋め込むことのできるファイルタイプを設定します。あなたがすでに使用されているファイルタイプを無効にした場合、それ以降表示されなくなります。

MaharaにはFLV、MP4 (in H.264 format) および MP3ファイルを再生することのできる「Flowplayer <http://flowplayer.org/>」 が同梱されています。ビデオは埋め込まれて、オーディオファイルはこのプレイヤーにより再生されます。

他のビデオも有効にすることができますが、ユーザは適切なソフトウェアを自分のコンピュータにインストールしてブラウザで再生できるよう個別のプラグインを有効にする必要があります。

Configure the Embedded media block

*埋め込みメディア*ブロックを設定する

  1. あなたのユーザのポートフォリオページに表示させたいファイルタイプを有効にします。
  2. 幅: ビデオのデフォルト幅 (ピクセル) を選択してください。
  3. 高さ: ビデオのデフォルトの高さ (ピクセル) を選択してください。
  4. あなたの変更を保持するには 保存 ボタンをクリックします。

注釈

あなたがFlowplayerで再生できないファイルタイプの埋め込みを許可した場合、これらのファイルタイプを表示するためにインストールする必要のあるソフトウェアを複数のユーザがインストールしていない可能性があります。

9.6.1.4. blocktype: text

あなたはインスタンス全体において、ノート ブロックタイプを テキスト ブロックタイプにコンバートすることができます。

Configure text settings

テキスト設定を設定する

  1. Maharaは、変換できるノートの数を計算します。以下の特性を持つノートが変換プロセスに含まれています。次のことに留意してください：
    • 別のブロックで再利用されていない；
    • ライセンスが添付されていない；
    • タグを使用しない；
    • 添付ファイルはない；
    • have not received any feedback.
  2. すべてのノートをコンバートするには 「ノート」 ブロックをコンバートする オプションを有効にします。
  3. 保存 ボタンをクリックして変換処理を開始します。変換する音符の数に応じて、時間がかかることがあります。

参考

If you have a large site, the conversion of notes to text may take a very long time. It can be beneficial to use the new in Mahara 15.04 command-line script.

9.6.1.5. blocktype: wall

あなたはこの設定で:ref:`ウォール <wall>`に投稿する文字数を制限することができます。既存の投稿は変更されません。

Configure wall settings

ウォールを設定する

  1. あなたのウォール投稿の最大文字数を選択します。
  2. あなたの変更を保持するには 保存 ボタンをクリックします。

9.6.1.6. artefact: comment: comment

コメントレーティングを有効にすることによりアーティファクトおよびパージのフィードバックセクションで5つ星のレーティングを有効にすることができます。

注釈

自分のものは評価することができません。また、コメントまたはファイル添付が必須入力です。

Enable comment ratings

コメント評価を有効にする

  1. コメントレーティングを有効にするにはこのオプションを有効にしてください。
  2. あなたの変更を保持するには 保存 ボタンをクリックします。

9.6.1.7. artefact: file: file

あなたはファイルのアップロードに関して様々なオプションを設定することができます:

  • デフォルトユーザクオータ
  • デフォルトグループクオータ
  • アップロード同意
  • アップロード時、イメージをリサイズする
  • プロファイル画像サイズ
  • コメント
  • フォルダダウンロード

9.6.1.7.1. デフォルトユーザクオータ

Configure the default user quota

デフォルトユーザクオータを設定する

  1. デフォルトクオータ: あなたは 新しいユーザ が彼らのクォータとして持つことのできるディスク容量を設定することができます。既存のユーザクォータは変更されません。
  2. Update user quotas: Turn this option on if you want to update the file quota for existing users with the value under Default quota. Only then will they be updated.
  3. Enforce a site-wide maximum quota: Turn this option on if you do not wish an administrator to go beyond the allowed maximum quota.
  4. 最大クオータ: あなたは管理者がユーザに与えることのできる最大クオータを設定することができます。既存のユーザクオータは影響を受けません。
  5. クォータ通知のしきい値: ユーザがファイルのアップロード制限に達する通知を受け取るときの 割合 を設定できます。次に、ファイルを削除してエリアを解放するか、サイトまたはインスティテューションの管理者に連絡してエリアを確保できるかどうかを確認します。
  6. Site administrator notification: Turn this option on if the site administrator shall receive the quota notification emails for individual users to take action.
  7. Institutional override: Turn this option on if you want to allow institution administrators to set user file quotas and have default quotas for each institution.
  8. 変更を完了したら、ページの下部にある 保存 ボタンをクリックするか、このページの次のセクションに進みます。

9.6.1.7.2. デフォルトグループクオータ

Configure the default group quota

デフォルトグループクオータを設定する

  1. デフォルトグループクオータ: あなたは それぞれのグループ がクオータとして持つことのできるディスク容量を設定することができます。既存のグループは影響を受けません。
  2. Update group quotas: Turn this option on if you want to update the file quota for existing groups with the value under Default quota. Only then will they be updated.
  3. 変更を完了したら、ページの下部にある 保存 ボタンをクリックするか、このページの次のセクションに進みます。

9.6.1.7.3. アップロード同意

Configure the upload agreement

アップロード同意を設定する

  1. Require agreement: Enable this option if you want to force users to agree to certain terms before they can upload a file to the site. They must accept this agreement before they are able to choose a file from their computer to upload to Mahara.
  2. デフォルト同意書: これは、同意書を要求する オプションを選択した場合、および独自のカスタム同意書を使用したくない場合に表示されるデフォルト同意書です。
  3. Use custom agreement: If you want to write your own upload agreement, turn this option on in addition to Require agreement.
  4. カスタム同意書: あなたがカスタムアップロード同意書を使用したい場合、ここで記述します。
  5. 変更を完了したら、ページの下部にある 保存 ボタンをクリックするか、このページの次のセクションに進みます。

9.6.1.7.4. アップロード時、イメージをリサイズする

Configure the image resizing options

イメージリサイズオプションを設定する

  1. 大きなイメージを自動的にリサイズする: このオプションを有効にすることによりアップロードされたイメージすべてが設定の最大幅および高さにリサイズされます。
  2. ユーザオプション: ユーザの:ref:`アカウント設定 <account_settings>`にイメージの自動リサイズに関するオプションを表示します。
  3. 最大幅: アップロード時にイメージのサイズを変更する最大幅（ピクセル単位）を選択します。
  4. 最大高さ: アップロード時にイメージのサイズを変更する最大高さ（ピクセル単位）を選択します。
  5. 変更を完了したら、ページの下部にある 保存 ボタンをクリックするか、このページの次のセクションに進みます。

9.6.1.7.5. プロファイル画像サイズ

Configure the size of the profile pictures

プロファイル画像のサイズを設定する

  1. 幅: ユーザのプロファイル画像の最大幅（ピクセル単位）を選択します。
  2. 高さ: ユーザのプロファイル画像の最大高さ（ピクセル単位）を選択します。
  3. 変更を完了したら、ページの下部にある 保存 ボタンをクリックするか、このページの次のセクションに進みます。

注釈

プロファイル画像エリアにアップロードされたすべての画像は、大きければこれらのサイズにリサイズされます。

9.6.1.7.6. コメント

Configure the default comment settings for different file types

異なるファイルタイプのデフォルトコメント設定を構成する

  1. すべてを選択する によりすべてのファイルタイプをマークすることができます。
  2. Select none to clear your selections from the checkboxes.
  3. デフォルトコメントパーミッション: デフォルトでコメントを有効にするアーティファクトタイプを選択します。ユーザは ファイルエリア でこれらの設定を個別にオーバーライドすることができます。あなたが有効にできるコメントは次のとおりです:
    • アーカイブ 例) 圧縮ファイル
    • オーディオファイル
    • ファイル
    • フォルダ
    • イメージ
    • プロファイル画像
    • ビデオファイル
  4. 変更を完了したら、ページの下部にある 保存 ボタンをクリックするか、このページの次のセクションに進みます。

9.6.1.7.7. フォルダダウンロード

Configure the folder download settings

フォルダのダウンロード設定を構成する

  1. zipファイルを保存する時間の長さ: フォルダのダウンロード処理中に作成されるzipファイルをサーバに保存する期間を選択します。デフォルト時間枠は3,600秒（1時間）です。
  2. あなたの変更を終了した場合、保存 ボタンをクリックします。

9.6.1.8. artefact: internal: profile

プロファイル情報に関して、あなたは手動またはCSVファイル経由でユーザアカウントが作成された時にユーザが提供する必要のあるフィールドを決定することができます。これらのフィールドは 必須フィールド としてマークされます。

検索可能フィールド がマークされているプロファイルフィールドはログインユーザが検索することができます。

Choose mandatory and searchable profile fields

必須および検索可能なプロファイルフィールドを選択する

  1. 必須フィールド: あなたがユーザすべてに入力させたいフィールドを選択します。特定のフィールドは選択解除できません。
  2. 検索可能フィールド: 他のユーザが検索することのできるフィールドを選択します。特定のフィールドは選択解除できません。
  3. あなたの変更を保持するには 保存 ボタンをクリックします。

9.6.1.9. 認証：BrowserID / Persona

new in Mahara 15.04 Persona authentication is discontinued as at 30 November 2016. Nobody is able to use that authentication anymore.

When you update to Mahara 15.04.10, Persona authentication will be deactivated, and you cannot re-activate it anymore. You can automatically migrate all accounts that use Persona to internal authentication.

Migrate Persona accounts to internal authentication

Personaアカウントを内部認証に移行する

  1. インスティテューション: Persona認証を使用するインスティテューションがリストされています。

  2. アクティブなPersonaユーザの数：Personaを持つすべてのユーザのリスト。このリンクをクリックすると、ユーザ検索ページ に移動し、Personaを持つユーザだけが表示されます。

  3. Personaユーザの自動移行：Persona認証を使用しているすべてのユーザを内部認証に移行する場合は、 「Yes」 に切り替えます。そうしないと、ログインできなくなります。

    注釈

    インスティテューションに内部認証セットがない場合、ユーザを移動できるように作成されます。

    Personaをログイン情報として使用したことを知らせる必要があります。パスワードをリセットするには、アカウントの詳細が電子メールで送信されないようにします。 「ユーザ名とパスワードを忘れました」 画面 に移動して、ユーザ名とパスワードを取得するために、自分のPersonaアカウントの電子メールアドレスを入力する必要があります。

  4. 保存 ボタンをクリックして、ユーザを移行します。

9.6.1.10. 認証: SAML

あなたのサイトで:ref:`SAML認証<saml>`を使用したい場合、これらの設定内でSAML phpファイルへのパスを提供する必要があります。

Prepare your site for SAML authentication

あなたのサイトのSAML認証を準備する

  1. SimpleSAMLphp lib directory: Provide the fully qualified path to the library directory of SimpleSAMLphp, e.g. if the full path to the bootstrap autoload.php is /some_path_to/simplesamlphp_1_3/lib/_autoload.php then this value should be /some_path_to/simplesamlphp_1_3/
  2. SimpleSAMLphp config directory: Provide the fully qualified path to the configuration directory to be used for this Service Provider (SP) SimpleSAMLphp, e.g. if the full path to the config.php is /some_path_to/simplesamlphp_1_3/config/config.php then this value should be /some_path_to/simplesamlphp_1_3/config/
  3. あなたの変更を保持するには 保存 ボタンをクリックします。

9.6.1.12. 検索: Elasticsearch

標準のMaharaの検索は、ユーザを特定し、特定の場所でページやコレクションのタイトル、説明、タグを検索することに限定されています。ただし、Maharaを拡張して全文検索機能を使用することもできます。Maharaのコアプロジェクトチームは、Elasticsearch を使用することを選択しました。これは強力で拡張可能な全文検索エンジンです。Javaサーバ（例えば、Tomcat）の実行が必要で、Maharaの小さなインスタンスでは利用できない可能性があります。

注釈

現在、プラグインはPostgreSQLデータベースで運用されているMaharaインスタンスだけに使用することができます。Mahara 1.9のMySQL にもサポートを広げるために対応中です。

Configure the Elasticsearch plugin

Elasticsearchプラグインを設定する

  1. ほとんどのElasticsearchの設定はサーバレベルで実施する必要があります。ここであなたは設定を閲覧だけすることができます。また、直接設定を変更することはできません。
  2. Cronレコード制限: それぞれのcron実行でキューからElasticsearchサーバに渡される最大レコード数を決定します。空白フィールドまたは 0 は制限なしを意味します。
  3. アーティファクトタイプ: 検索インデックスに含めるアーティファクトタイプを確認します。下に定義された階層を持つアーティファクトタイプだけが有効です。変更を有効にするには、以下のキューのアーティファクトをリセットする必要があります。
  4. アーティファクトタイプ階層: それぞれのアーティファクトタイプの階層を | (パイプ) で区切って入力します。それぞれのアーティファクトを1行に入力します。
  5. アーティファクトタイプ階層: それぞれのアーティファクトタイプの階層を | (パイプ) で区切って入力します。それぞれのアーティファクトを1行に入力します。
  6. 検索インデックスをクリアしてレコードすべてを削除した後に再度キューに入れるには リセット ボタンをクリックします。
  7. あなたの変更を受け付けるには 保存 ボタンをクリックします。

参考

あなたは wiki上のMaharaのElasticsearch に関するより多くの情報を見つけることができます。また、開発を始めるためのいくつかの 開発者ノート もあります。

9.6.1.13. インタラクション: フォーラム

ポスト遅延設定は、ユーザがフォーラムの投稿を編集して郵送するまでの時間（分）を決定します。フォーラム投稿が郵送され、さらに編集が行われると、日付、時刻、編集者が投稿に記載されます。

Set the edit time before the forum post is finalised

フォーラム投稿が固定されるまでの時間を設定します。

  1. 投稿遅延: 投稿が確定してさらなる編集ができなくなるまでの時間 (分) を設定します。
  2. あなたの変更を保持するには 保存 ボタンをクリックします。

9.6.2. HTMLフィルタ

管理 → 拡張機能 → HTMLフィルタ

Maharaは HTML Purifier を使用して、システムのセキュリティを脅かす可能性のある悪質なコードを排除します。コード、例えば、使用したい、それ以外の場合は除外されるiFramesまたはJavaScriptがある場合、それを回避するフィルタを作成する必要があります。フィルタは常にその目的に固有のものであり、可能な限りセキュリティを確保するために 『白紙委任』 を与えてはいけません。

Maharaにはすでに多数のフィルタがインストールされています。他のものはアップロードしてインストールすることができます。新しいHTMLフィルタセットを作成した場合は、そのファイルをフォルダ /htdocs/lib/htmlpurifiercustom に解凍してインストールし、インストール ボタンをクリックしてインストールできます。

YouTubeやWikiEducatorなどのメディアコンテンツの埋め込みを可能にするiFrameのカスタムフィルタを使用すると、実際の埋め込みコードを検索する代わりに、メディアが表示されているページのURLを取得できます。

注釈

<iframe>埋め込みコードを使用して埋め込むメディアには、必ずしも個別のフィルタが必要なわけではありません。元の埋め込みコードを使用したい場合は、許可されたiframeソース のリストに追加することができます。

代わりに (YouTubeビデオのように) URLをペーストできるようにしたい場合、 あなたはbespokeフィルタが必要です。

9.6.3. 許可済みiframeソース

管理 → 拡張機能設定 → iframeソースを許可する

この機能を使用すると、サイト管理者は、ユーザが埋め込むことができるメディアの基本URLを指定できます。これらのiframeは安全とみなされ、テキスト ブロックまたは ノート ブロック、外部メディア ブロック、または使用できる日誌エントリからは削除されません。これらのiframeソースを使用するための特注のフィルタを作成する必要はありません。

あなたは管理インタフェースでこれらのソースを簡単に追加および管理することができます。Maharaにはあなたがサンプルとして使用できる多くの埋め込みiframeソースが同梱されています。

Add and edit allowed iframe sources

許可されたiframeソースを追加および編集する

  1. サイト: iframeコードのベースURLです。
  2. 表示名: 外部メディアブロック 内でユーザに表示されるものを決定します。
  3. 既存のiframeソースまたはファビコンソースの表示名を更新するには*編集*|edit| タンをクリックしてください。
  4. 既存のiframeソースを削除するには、削除 ボタン delete をクリックします。
  5. 表示名: ここで*編集*ボタン|edit|をクリックした後、既存のiframeソースの表示名を変更します。
  6. アイコンホスト: 自動的に取得できない場合、サイトのファビコン (favicon) を探すためのベースURLを入力します。
  7. このサイトのあなたの変更を保持するには 保存 ボタンをクリックします。
  8. サイト: ここにベースURLを入力することにより、新しいiframeソースを追加します。忘れずに http:// を除外します。半角英数字および . / - _ だけ許可されます。
  9. 表示名: あなたのiframeソースの表示名を選択します。通常、これは外部コンテンツを保持しているサイト名です。
  10. あなたの新しいサイトを許可されたiframeソース一覧に追加するには 追加 ボタンをクリックします。ファビコンが表示されない場合、あなたのサイトを編集してステップ6でアイコンホストを指定します。

注釈

Some sites can be reached via a variety of URLs, e.g. GoogleApps, Glogster. You need to provide all possible base URLs to ensure that the iFrames are displayed. If you give the individual sites of one provider the same name, it will only show up once in the list of iFrame sources in the external media block and not clutter the space unnecessarily.

参考

Community members started to collect iFrame sources that they are using on their sites to share which URLs would need to be provided to get the iFrames to work. You can check out the list on the wiki and also add your own iFrame sources there.

9.6.4. クリーンURL

管理 → 拡張機能 → クリーンURLs

あなたのサイトが人間が解読可能なURLを ユーザプロファイル、グループ および (グループ) ポートフォリオページ に使用するよう設定することができます。例えば、次のようになります:

あなたはこのオプションでさらに記憶しやすいURLを作成することができます。

参考

サイト上でこの機能を有効にするには、wikiの設定手順に従って ください。これを行うには、サーバにアクセスする必要があります。

管理者エリアにおいて、あなたは既存のユーザ、グループおよびページのクリーンURLを生成することができます。これはあなたがMaharaの前のバージョンからアップグレードしてカスタムURLすべてをリセットしたい場合に便利です。

Regenerate clean URLs for existing users in bulk

既存ユーザのクリーンURLを一括再生成する

  1. クリーンURLを再生成するには 送信 ボタンをクリックします。既存のクリーンURLが破棄されることに留意します。
  2. 操作結果が画面最上部に表示されます。

警告

ここからすべてのユーザのクリーンURLを生成すると、すでにURLを変更したユーザは変更が失われ、リンクが切断されます。この機能は、Maharaサイトをアップグレードする場合や、クリーンなURL生成で問題が発生した場合にだけ使用することをお勧めします。

9.6.5. new in Mahara 15.04 Web services

ウェブサービスについては、別のセクション を参照してください。