如何将 Asyntai AI 聊天机器人添加到 MODX

MODX CMS 网站的分步指南

获取嵌入代码

平台：

步骤1：获取您的嵌入代码

首先，前往您的 Asyntai 仪表板并向下滚动到"嵌入代码"部分。复制您的专属嵌入代码，格式如下：

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

注意： 以上代码仅为示例。您必须从仪表板复制您自己的专属嵌入代码，因为其中包含您的个人小部件 ID。

步骤 2：添加到 MODX 模板（推荐）

推荐的方法是直接在 MODX 管理器中编辑您的 MODX 模板来添加聊天机器人：

登录您的 MODX 管理器（管理面板）
在左侧边栏中，转到 元素 > 模板
打开您网站的模板（通常称为"BaseTemplate"或您正在使用的模板）
在模板代码中找到 </body> 闭合标签
将您的 Asyntai 嵌入代码粘贴到 </body> 闭合标签之前
点击"保存"以保存模板

<!-- Your existing template content -->

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

提示： 将代码添加到 </body> 闭合标签之前可确保聊天机器人在所有页面内容加载后再加载，这是聊天小部件的推荐位置，不会减慢您的页面加载速度。

备选方法 1：使用 MODX Chunk

您可以使用 MODX Chunk 将嵌入代码保持独立且可复用：

在 MODX 管理器中，转到 元素 > Chunks
点击"新建 Chunk"以创建新的 Chunk
将 Chunk 命名为"asyntaiWidget"
将您的 Asyntai 嵌入代码粘贴到 chunk 内容区域
点击"保存"
打开您的模板（在 元素 > 模板 下）
在 </body> 闭合标签之前添加 chunk 调用 [[$asyntaiWidget]]
保存模板

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

提示： 使用 Chunk 可以方便地在一个地方管理和更新嵌入代码，特别是当您在网站中使用多个模板时。

备选方法 2：使用 MODX 系统设置（HTML 头部/页脚）

一些 MODX 设置通过系统设置包含了页脚脚本的占位符：

在 MODX 管理器中，转到 系统 > 系统设置
按"htmlhead"筛选或搜索用于页脚脚本的自定义系统设置
如果您的设置有页脚脚本的占位符（如 [[++footer_scripts]]），您可以使用它
将系统设置的值设置为您的 Asyntai 嵌入代码
确保相应的占位符 [[++footer_scripts]] 在模板中 </body> 闭合标签之前
保存系统设置

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

注意： 此方法取决于您的 MODX 设置是否有页脚脚本的自定义系统设置。如果不存在，您可以创建自定义系统设置并在模板中使用 [[++setting_key]] 语法引用它。

备选方法 3：使用 MODX 插件（OnWebPagePrerender）

作为高级方法，您可以创建一个 MODX 插件，自动将聊天机器人代码注入到每个页面中：

在 MODX 管理器中，转到 元素 > 插件
点击"新建插件"以创建新的插件
将插件命名为"AsyntaiChatbot"
将以下 PHP 代码粘贴到插件代码区域：

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

点击"系统事件"标签页
勾选"OnWebPagePrerender"旁边的复选框，使插件在该事件时触发
点击"保存"

重要提示： 将YOUR_WIDGET_ID替换为您在Asyntai 控制面板中的实际小部件 ID。此插件将在 MODX 网站的每个页面渲染之前自动注入聊天机器人脚本。

步骤3：清除缓存并验证

使用上述任一方法添加嵌入代码后，您需要清除 MODX 缓存并验证安装：

在 MODX 管理器中，转到 管理 > 清除缓存（或点击顶部菜单中的清除缓存图标）
在新的浏览器标签页或无痕窗口中打开您的网站
您应该会在页面右下角看到聊天小部件按钮
点击它以确保它能正常打开和运行

看不到小部件？ 确保您已在 MODX 管理器中通过管理 > 清除缓存清除了 MODX 缓存。也可以尝试清除浏览器缓存或在无痕窗口中查看网站。如果您使用了插件方法，请验证插件已勾选"OnWebPagePrerender"系统事件。