如何将 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 控制面板中编辑主布局模板:
- 在 EE 控制面板中,转到开发者 > 模板 > 模板组
- 打开您的主模板组(通常是"site")并编辑布局模板(或包裹所有页面的模板)
- 找到
</body>闭合标签 - 将您的 Asyntai 嵌入代码粘贴到
</body>标签之前:<!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body> - 保存模板
提示: 在 </body> 闭合标签之前添加脚本可确保它在页面内容之后加载,这是聊天小部件的推荐做法,不会拖慢页面加载速度。
替代方法 1:使用 EE 模板片段
ExpressionEngine 模板片段允许您创建可在各模板中复用的代码片段:
- 转到开发者 > 模板 > 模板片段
- 点击"新建"创建一个名为
_asyntai_widget的新局部模板 - 将您的 Asyntai 嵌入代码粘贴到片段内容中:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - 保存片段
- 将其包含在布局模板中
</body>闭合标签之前:{embed="_asyntai_widget"} </body>
注意: 使用模板片段可以保持代码整洁,并且可以在一个位置轻松更新整个网站的聊天机器人嵌入代码。
替代方法 2:使用 EE 的 HTML 页眉/页脚
某些 ExpressionEngine 配置提供全局页脚部分用于添加脚本:
- 转到设置 > 内容和设计 > 全局模板偏好设置
- 如果您的 EE 配置有全局页脚部分,请将 Asyntai 嵌入代码粘贴到那里
- 如果没有全局页脚部分,请直接编辑主布局模板并在
</body>闭合标签之前添加嵌入代码:<!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body> - 保存更改
替代方法 3:使用 config.php
对于高级用户,您可以通过 ExpressionEngine 的配置或创建自定义附加组件来注入聊天机器人脚本:
- 通过 FTP、SSH 或代码编辑器访问 ExpressionEngine 项目文件
- 导航到
system/user/config/目录并打开config.php - 对于自定义 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; } - 将
YOUR_WIDGET_ID替换为仪表板中的实际小部件 ID
重要提示: config.php 和附加组件方法适用于熟悉 ExpressionEngine 开发的高级用户。对于大多数用户,建议使用模板布局方法(步骤 2)或模板片段方法(替代方法 1)。
步骤3:验证安装
保存更改后,在新的浏览器标签页或无痕窗口中访问您的 ExpressionEngine 网站。您应该会在右下角看到聊天小部件按钮。点击它以确保能正常打开和使用。
看不到小部件? 请确保您已保存模板,并且正在编辑页面所使用的正确布局模板。清除浏览器缓存或在无痕窗口中查看。如果启用了 ExpressionEngine 模板缓存,请从控制面板的 开发者 > 实用工具 > 缓存管理器 中清除缓存。
Weebly