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

Backdrop CMS网站的分步指南

获取嵌入代码

平台：

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

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

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

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

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

Backdrop CMS在其主题中使用.tpl.php模板文件。推荐的方法是将嵌入代码直接添加到您当前主题的页面模板中：

通过FTP或文件管理器访问您的Backdrop CMS安装
导航到您当前主题的目录：themes/yourtheme/
打开page.tpl.php文件（或layout.tpl.php，取决于您的主题）
找到</body>闭合标签或<?php print $page_bottom; ?>这一行
将您的Asyntai嵌入代码粘贴在该行之前
保存文件

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

提示： 将代码放在<?php print $page_bottom; ?>或</body>闭合标签之前，可确保聊天机器人在页面内容之后加载，提供更好的页面加载性能。此方法会自动将聊天机器人添加到使用此主题的每个页面。

替代方法1：使用自定义模块

您可以创建一个简单的Backdrop CMS模块，使用backdrop_add_js()注入聊天机器人脚本：

创建模块目录：modules/custom/asyntai_widget/
使用以下代码创建模块文件asyntai_widget.module：
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
创建asyntai_widget.info文件：
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
在Backdrop管理面板中前往Functionality（admin/modules）
在自定义包下找到"Asyntai AI Chatbot Widget"并启用它
点击"保存配置"

注意： 将模块代码中的 YOUR_WIDGET_ID 替换为您在 Asyntai 仪表板中的实际小部件 ID。自定义模块方法是升级安全的，更新主题时不会被覆盖。

替代方法 2：使用 Backdrop 的"Add to Head"模块

"Add to Head"贡献模块提供了一种无需编辑代码即可注入脚本的简便方法：

从 Backdrop CMS 网站下载并安装"Add to Head"贡献模块
前往Configuration > Development > Add to Head
在页脚部分添加您的Asyntai嵌入代码
点击"保存配置"

提示： 如果您不想编辑主题文件或创建自定义模块，使用"Add to Head"模块是最简便的方法。它提供了一个简单的管理界面来管理注入的脚本。

替代方法3：使用区块系统

Backdrop CMS的布局和区块系统也可用于添加聊天机器人：

登录您的Backdrop CMS管理面板
前往Structure > Layouts
选择您要编辑的布局（例如默认布局）
在页脚区域中点击"添加区块"
选择"自定义区块"
将区块格式设置为"完整 HTML"或"原始 HTML"
将您的Asyntai嵌入代码粘贴到区块正文中
为区块设置标题（例如"Asyntai Chatbot"），并可选择勾选"隐藏标题"
点击"保存区块"，然后点击"保存布局"

重要提示： 确保文本格式设置为"完整 HTML"或"原始 HTML"，以免脚本标签被过滤掉。默认的"过滤 HTML"格式会出于安全原因移除脚本标签。

步骤3：清除缓存并验证

完成更改后，清除Backdrop CMS的缓存并验证安装：

在管理面板中前往Configuration > Performance
点击"清除所有缓存"
在新的浏览器标签页或无痕窗口中打开您的网站
您应该在右下角看到聊天小部件按钮
点击它以确保其正常打开和运行

看不到小部件？ 确保您已在Configuration > Performance中清除了Backdrop CMS的缓存。尝试在无痕窗口中查看您的网站或清除浏览器缓存。打开浏览器控制台（F12）检查是否有JavaScript错误。如果您使用了自定义模块方法，请验证该模块是否已在Functionality下启用。