如何将 Asyntai AI 聊天机器人添加到 Moodle
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
- 向下滚动到"BODY 关闭前"部分
- 将您的 Asyntai 嵌入代码粘贴到文本区域中
- 点击"保存更改"
提示: 将代码添加到"BODY 关闭前"会将其放在</body>关闭标签之前,这是聊天小部件的推荐位置,可确保在主要页面内容之后加载。
备选方案:使用主题设置
许多 Moodle 主题(包括 Boost 及其变体)都有自己的设置来添加自定义 JavaScript:
- 转到 站点管理 → 外观 → 主题
- 点击活动主题的主题设置(例如 Boost)
- 查找"原始 SCSS"、"附加 HTML"或"自定义 JavaScript"部分
- 如果有 JavaScript 字段,请将您的 Asyntai 嵌入代码粘贴到那里
- 点击"保存更改"
- 清除缓存:站点管理 → 开发 → 清除缓存
注意: 主题特定的设置因主题而异。如果您的主题没有 JavaScript 字段,请使用上面的附加 HTML 方法。
备选方案:创建本地插件
如需更多控制,您可以创建一个简单的本地插件:
- 在 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/columns2.php或templates/columns2.mustache) - 找到
</body>闭合标签或页脚部分 - 在
</body>之前添加您的 Asyntai 嵌入代码 - 保存文件
- 清除 Moodle 缓存
重要提示: 直接编辑主题文件意味着更新主题时更改可能会丢失。使用子主题或附加 HTML 方法可获得更持久的解决方案。
步骤3:验证安装
保存更改并清除缓存后,在新的浏览器标签页或无痕窗口中访问您的 Moodle 网站。您应该会在右下角看到聊天小部件按钮。点击它以确保它能正常打开和运行。
看不到小部件? 请确保清除所有 Moodle 缓存:转到 站点管理 → 开发 → 清除所有缓存。也请尝试清除浏览器缓存或在无痕窗口中查看。如果使用了缓存插件或反向代理,也请清除这些缓存。
Weebly