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

Craft CMS 网站的分步指南

获取嵌入代码

平台：

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

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

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

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

步骤 2：编辑布局模板（推荐）

将聊天机器人添加到所有页面的最简单方法是编辑主布局模板：

通过 FTP、SSH 或代码编辑器访问 Craft CMS 项目文件
导航到 templates/ 目录
找到主布局文件（通常命名为 _layout.twig、_layout.html，或位于 templates/_layouts/）
找到</body>闭合标签
将您的Asyntai嵌入代码粘贴到</body>标签之前
保存文件

提示： 在 </body> 闭合标签之前添加脚本可确保它在页面内容之后加载，这是聊天小部件的推荐做法，不会拖慢页面加载速度。

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS 提供了内置的 Twig 标签用于注册 JavaScript：

打开主布局模板
在 </body> 闭合标签之前添加以下代码：
{% js %} (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); })(); {% endjs %}
将 YOUR_WIDGET_ID 替换为您的实际小部件 ID
保存文件

注意： The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

替代方案：创建单独的包含文件

为了更好地组织代码，创建一个专用的包含文件：

创建新文件：templates/_includes/chatbot.twig（或 .html）
将您的 Asyntai 嵌入代码添加到此文件：
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
在主布局模板中，在 </body> 之前包含此文件：
{% include '_includes/chatbot' %}
保存两个文件

提示： 使用包含文件可以通过注释掉一行代码，轻松在整个网站启用/禁用聊天机器人。

替代方案：条件加载

仅在特定页面或栏目加载聊天机器人：

在布局或页面模板中，使用 Twig 条件语句：
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
或检查特定栏目：
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

步骤3：验证安装

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

看不到小部件？ 确保已保存模板文件，并且您编辑的是页面使用的正确布局模板。清除浏览器缓存或在无痕窗口中查看。如果使用了模板缓存，请从控制面板的「实用工具 > 清除缓存」中清除 Craft CMS 缓存。

模板位置： Craft CMS 模板位置可能因项目配置而异。常见位置包括 templates/_layout.twig、templates/_layouts/main.twig 或 templates/_base.twig。请检查现有模板以找到 </body> 标签的定义位置。