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

PrestaShop 网站的分步指南

获取嵌入代码

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

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

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

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

第 2 步:使用自定义代码模块(推荐)

添加聊天机器人最简单的方法是使用 PrestaShop Addons 市场中的免费"Custom Code"模块:

  1. 登录您的 PrestaShop 后台管理
  2. 前往 Modules → Module Manager
  3. 点击 \"Upload a module\" 或在市场中搜索 \"Custom Code\" 或 \"Header Footer Scripts\
  4. 安装类似 "Custom JS and CSS" 的模块
  5. 安装完成后,前往模块的配置页面
  6. 找到 "Footer Scripts""Before </body>" 部分
  7. 粘贴您的Asyntai嵌入代码
  8. 点击"保存"

提示: 常用的免费模块包括 "Custom JS and CSS Pro"、"Custom Code" 和 "Header and Footer Scripts"。这些模块在主题和 PrestaShop 更新后仍可正常使用。

替代方案:编辑主题模板(PrestaShop 1.7+/8)

您可以将代码直接添加到主题的页脚模板中:

  1. 通过 FTP 或文件管理器访问您的 PrestaShop 文件
  2. 导航到主题文件夹:themes/your_theme/templates/_partials/
  3. 打开文件 footer.tpl(或在某些主题中,检查 templates/layouts/layout-both-columns.tpl
  4. 找到闭合的 </body> 标签或 {block name='javascript_bottom'} 部分
  5. 将您的 Asyntai 嵌入代码粘贴到 </body> 闭合标签之前
  6. 保存文件
  7. 清除 PrestaShop 缓存:Advanced Parameters → Performance → Clear cache

重要提示: 更新主题时,主题文件的更改可能会被覆盖。建议使用子主题或模块以获得更持久的解决方案。

替代方案:使用主题的自定义 JavaScript 文件

许多 PrestaShop 主题包含一个 custom.js 文件用于您自己的脚本:

  1. 导航到:themes/your_theme/assets/js/
  2. 查找名为 custom.js 的文件(如果不存在则创建一个)
  3. 添加以下代码以动态加载聊天机器人:
    (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);
    })();
  4. YOUR_WIDGET_ID 替换为您的实际小部件 ID
  5. 清除 PrestaShop 缓存

替代方案:创建简单模块(面向开发者)

对于开发者,您可以使用 displayFooter 钩子创建一个简单模块:

  1. 创建文件夹:modules/asyntaichatbot/
  2. 创建 asyntaichatbot.php 并添加以下代码:
    <?php
    class AsyntaiChatbot extends Module {
      public function __construct() {
        $this->name = 'asyntaichatbot';
        $this->version = '1.0.0';
        $this->author = 'Your Name';
        parent::__construct();
        $this->displayName = 'Asyntai Chatbot';
      }
      public function install() {
        return parent::install() && $this->registerHook('displayFooter');
      }
      public function hookDisplayFooter($params) {
        return '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
      }
    }
  3. YOUR_WIDGET_ID 替换为您的实际小部件 ID
  4. 通过 Modules → Module Manager 安装模块

步骤3:验证安装

保存更改并清除缓存后,在新的浏览器标签页或无痕窗口中访问您的商店。您应该会在右下角看到聊天小部件按钮。点击它以确保它能正常打开和运行。

看不到小部件? 请确保清除 PrestaShop 缓存:前往 Advanced Parameters → Performance → Clear cache。同时尝试清除浏览器缓存或在无痕窗口中查看。如果使用自定义模块,请验证其在 Module Manager 中已启用。