ダッシュボードに戻る

ドキュメント

Asyntaiの使い方を学ぶ

MoodleにAsyntai AIチャットボットを追加する方法

Moodle LMSウェブサイトのステップバイステップガイド

埋め込みコードの取得

ステップ1:埋め込みコードを取得する

まず、Asyntaiダッシュボードに移動し、「埋め込みコード」セクションまでスクロールしてください。次のような固有の埋め込みコードをコピーしてください:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

注意: 上記のコードは一例です。個人のウィジェットIDが含まれているため、ダッシュボードから固有の埋め込みコードをコピーしてください。

ステップ2:追加HTML機能を使用(推奨)

Moodleには、すべてのページにカスタムHTML/JavaScriptを追加する組み込み機能があります:

  1. 管理者としてMoodleサイトにログインしてください
  2. サイト管理に移動してください
  3. 外観 → 追加HTMLに移動してください
  4. Scroll down to the "Before BODY is closed" section
  5. テキストエリアにAsyntaiの埋め込みコードを貼り付けます
  6. \"変更を保存\"をクリックしてください

ヒント: "Before BODY is closed"にコードを追加すると、閉じ</body>タグの直前に配置されます。これはチャットウィジェットの推奨配置であり、メインページコンテンツの後に読み込まれることが保証されます。

代替方法:テーマ設定を使用

多くのMoodleテーマ(Boostとそのバリアントを含む)には、カスタムJavaScriptを追加するための独自の設定があります:

  1. サイト管理 → 外観 → テーマに移動してください
  2. アクティブなテーマ(例:Boost)のテーマ設定をクリックしてください
  3. "Raw SCSS""追加HTML"、または"カスタムJavaScript"セクションを探してください
  4. If there's a JavaScript field, paste your Asyntai embed code there
  5. \"変更を保存\"をクリックしてください
  6. キャッシュをパージしてください:サイト管理 → 開発 → キャッシュのパージ

注意: テーマ固有の設定はテーマによって異なります。テーマにJavaScriptフィールドがない場合は、上記の追加HTML方式を使用してください。

代替方法:ローカルプラグインの作成

For more control, you can create a simple local plugin:

  1. Moodleインストール内にフォルダ構造を作成してください:local/asyntaichatbot/
  2. version.phpを作成してください:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. lib.phpを作成してください:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. フォルダamd/src/とファイルloader.jsを作成してください:
    define([], function() {
      return {
        init: function() {
          var script = document.createElement('script');
          script.async = true;
          script.src = 'https://asyntai.com/static/js/chat-widget.js';
          script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
          document.body.appendChild(script);
        }
      };
    });
  5. YOUR_WIDGET_IDを実際のウィジェットIDに置き換えてください
  6. サイト管理 → 通知に移動してプラグインをインストールしてください
  7. インストール後にキャッシュをパージしてください

重要: ローカルプラグイン方式では、ファイルを作成するためにコマンドラインアクセスが必要です。ほとんどのユーザーにとって、追加HTML方式の方がシンプルで十分です。

代替方法:テーマのフッターテンプレートを編集

テーマのフッターテンプレートを直接編集することもできます:

  1. テーマフォルダに移動してください:theme/YOUR_THEME/
  2. layoutファイル(例:layout/columns2.phpまたはtemplates/columns2.mustache)を見つけてください
  3. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </body>
  5. ファイルを保存します
  6. Moodleキャッシュをパージしてください

重要: テーマファイルを直接編集すると、テーマの更新時に変更が失われる可能性があります。より永続的なソリューションとして、子テーマまたは追加HTML方式を使用してください。

ステップ3:インストールの確認

変更を保存してキャッシュをパージした後、新しいブラウザタブまたはシークレットウィンドウでMoodleサイトにアクセスしてください。右下にチャットウィジェットボタンが表示されるはずです。クリックして正しく開き、正常に動作することを確認してください。

ウィジェットが表示されませんか? すべてのMoodleキャッシュをパージしてください:サイト管理 → 開発 → すべてのキャッシュをパージに移動してください。また、ブラウザのキャッシュをクリアするか、シークレットウィンドウで表示してみてください。キャッシュプラグインやリバースプロキシを使用している場合は、それらのキャッシュもクリアしてください。