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を追加する組み込み機能があります:
- 管理者としてMoodleサイトにログインしてください
- サイト管理に移動してください
- 外観 → 追加HTMLに移動してください
- Scroll down to the "Before BODY is closed" section
- テキストエリアにAsyntaiの埋め込みコードを貼り付けます
- \"変更を保存\"をクリックしてください
ヒント: "Before BODY is closed"にコードを追加すると、閉じ</body>タグの直前に配置されます。これはチャットウィジェットの推奨配置であり、メインページコンテンツの後に読み込まれることが保証されます。
代替方法:テーマ設定を使用
多くのMoodleテーマ(Boostとそのバリアントを含む)には、カスタムJavaScriptを追加するための独自の設定があります:
- サイト管理 → 外観 → テーマに移動してください
- アクティブなテーマ(例:Boost)のテーマ設定をクリックしてください
- "Raw SCSS"、"追加HTML"、または"カスタムJavaScript"セクションを探してください
- If there's a JavaScript field, paste your Asyntai embed code there
- \"変更を保存\"をクリックしてください
- キャッシュをパージしてください:サイト管理 → 開発 → キャッシュのパージ
注意: テーマ固有の設定はテーマによって異なります。テーマにJavaScriptフィールドがない場合は、上記の追加HTML方式を使用してください。
代替方法:ローカルプラグインの作成
For more control, you can create a simple local plugin:
- Moodleインストール内にフォルダ構造を作成してください:
local/asyntaichatbot/ - version.phpを作成してください:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - lib.phpを作成してください:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - フォルダ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);
}
};
}); YOUR_WIDGET_IDを実際のウィジェットIDに置き換えてください- サイト管理 → 通知に移動してプラグインをインストールしてください
- インストール後にキャッシュをパージしてください
重要: ローカルプラグイン方式では、ファイルを作成するためにコマンドラインアクセスが必要です。ほとんどのユーザーにとって、追加HTML方式の方がシンプルで十分です。
代替方法:テーマのフッターテンプレートを編集
テーマのフッターテンプレートを直接編集することもできます:
- テーマフォルダに移動してください:
theme/YOUR_THEME/ - layoutファイル(例:
layout/columns2.phpまたはtemplates/columns2.mustache)を見つけてください - Find the closing
</body>tag or the footer section - Add your Asyntai embed code just before
</body> - ファイルを保存します
- Moodleキャッシュをパージしてください
重要: テーマファイルを直接編集すると、テーマの更新時に変更が失われる可能性があります。より永続的なソリューションとして、子テーマまたは追加HTML方式を使用してください。
ステップ3:インストールの確認
変更を保存してキャッシュをパージした後、新しいブラウザタブまたはシークレットウィンドウでMoodleサイトにアクセスしてください。右下にチャットウィジェットボタンが表示されるはずです。クリックして正しく開き、正常に動作することを確認してください。
ウィジェットが表示されませんか? すべてのMoodleキャッシュをパージしてください:サイト管理 → 開発 → すべてのキャッシュをパージに移動してください。また、ブラウザのキャッシュをクリアするか、シークレットウィンドウで表示してみてください。キャッシュプラグインやリバースプロキシを使用している場合は、それらのキャッシュもクリアしてください。
Weebly