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

ExpressionEngine CMS 的分步指南

获取嵌入代码

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

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

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

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

步骤 2:添加到模板布局(推荐)

将聊天机器人添加到所有页面的最简单方法是在 ExpressionEngine 控制面板中编辑主布局模板:

  1. 在 EE 控制面板中,转到开发者 > 模板 > 模板组
  2. 打开您的主模板组(通常是"site")并编辑布局模板(或包裹所有页面的模板)
  3. 找到</body>闭合标签
  4. 将您的 Asyntai 嵌入代码粘贴到 </body> 标签之前
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. 保存模板

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

替代方法 1:使用 EE 模板片段

ExpressionEngine 模板片段允许您创建可在各模板中复用的代码片段:

  1. 转到开发者 > 模板 > 模板片段
  2. 点击"新建"创建一个名为 _asyntai_widget 的新局部模板
  3. 将您的 Asyntai 嵌入代码粘贴到片段内容中:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. 保存片段
  5. 将其包含在布局模板中 </body> 闭合标签之前:
    {embed="_asyntai_widget"} </body>

注意: 使用模板片段可以保持代码整洁,并且可以在一个位置轻松更新整个网站的聊天机器人嵌入代码。

替代方法 2:使用 EE 的 HTML 页眉/页脚

某些 ExpressionEngine 配置提供全局页脚部分用于添加脚本:

  1. 转到设置 > 内容和设计 > 全局模板偏好设置
  2. 如果您的 EE 配置有全局页脚部分,请将 Asyntai 嵌入代码粘贴到那里
  3. 如果没有全局页脚部分,请直接编辑主布局模板并在 </body> 闭合标签之前添加嵌入代码:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. 保存更改

替代方法 3:使用 config.php

对于高级用户,您可以通过 ExpressionEngine 的配置或创建自定义附加组件来注入聊天机器人脚本:

  1. 通过 FTP、SSH 或代码编辑器访问 ExpressionEngine 项目文件
  2. 导航到 system/user/config/ 目录并打开 config.php
  3. 对于自定义 JavaScript 注入,建议创建一个简单的 EE 附加组件/扩展,挂钩到 template_post_parse 钩子以在页面渲染时注入脚本:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. YOUR_WIDGET_ID 替换为仪表板中的实际小部件 ID

重要提示: config.php 和附加组件方法适用于熟悉 ExpressionEngine 开发的高级用户。对于大多数用户,建议使用模板布局方法(步骤 2)或模板片段方法(替代方法 1)。

步骤3:验证安装

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

看不到小部件? 请确保您已保存模板,并且正在编辑页面所使用的正确布局模板。清除浏览器缓存或在无痕窗口中查看。如果启用了 ExpressionEngine 模板缓存,请从控制面板的 开发者 > 实用工具 > 缓存管理器 中清除缓存。