如何将 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:

  1. 以管理员身份登录您的 Moodle 网站
  2. 转到站点管理
  3. 导航到 外观 → 附加 HTML
  4. 向下滚动到"BODY 关闭前"部分
  5. 将您的 Asyntai 嵌入代码粘贴到文本区域中
  6. 点击"保存更改"

提示: 将代码添加到"BODY 关闭前"会将其放在</body>关闭标签之前,这是聊天小部件的推荐位置,可确保在主要页面内容之后加载。

备选方案:使用主题设置

许多 Moodle 主题(包括 Boost 及其变体)都有自己的设置来添加自定义 JavaScript:

  1. 转到 站点管理 → 外观 → 主题
  2. 点击活动主题的主题设置(例如 Boost)
  3. 查找"原始 SCSS""附加 HTML""自定义 JavaScript"部分
  4. 如果有 JavaScript 字段,请将您的 Asyntai 嵌入代码粘贴到那里
  5. 点击"保存更改"
  6. 清除缓存:站点管理 → 开发 → 清除缓存

注意: 主题特定的设置因主题而异。如果您的主题没有 JavaScript 字段,请使用上面的附加 HTML 方法。

备选方案:创建本地插件

如需更多控制,您可以创建一个简单的本地插件:

  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/columns2.phptemplates/columns2.mustache
  3. 找到 </body> 闭合标签或页脚部分
  4. </body> 之前添加您的 Asyntai 嵌入代码
  5. 保存文件
  6. 清除 Moodle 缓存

重要提示: 直接编辑主题文件意味着更新主题时更改可能会丢失。使用子主题或附加 HTML 方法可获得更持久的解决方案。

步骤3:验证安装

保存更改并清除缓存后,在新的浏览器标签页或无痕窗口中访问您的 Moodle 网站。您应该会在右下角看到聊天小部件按钮。点击它以确保它能正常打开和运行。

看不到小部件? 请确保清除所有 Moodle 缓存:转到 站点管理 → 开发 → 清除所有缓存。也请尝试清除浏览器缓存或在无痕窗口中查看。如果使用了缓存插件或反向代理,也请清除这些缓存。