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

Bagisto电商平台的分步指南

获取嵌入代码

平台：

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

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

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

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

步骤2：添加到Blade布局模板（推荐）

Bagisto使用Laravel Blade模板。推荐的方法是将嵌入代码直接添加到商店布局文件中：

打开商店布局文件：
- 包源文件： packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- 已发布版本： resources/views/vendor/shop/layouts/master.blade.php（如果您已发布视图）
找到</body>闭合标签
在@stack('scripts')之后、</body>之前添加嵌入代码：

@stack('scripts')
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>

提示： 如果您已发布供应商视图，请编辑resources/views/vendor/shop/中的已发布版本。否则，请先使用php artisan vendor:publish --tag=shop-views发布它们，以避免在包更新时丢失更改。

替代方法1：在视图中使用@push('scripts')

在任何Blade视图或组件中，您可以使用scripts栈来注入聊天机器人脚本：

@push('scripts')
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
@endpush

注意： 此方法要求主布局文件中存在@stack('scripts')。它默认包含在Bagisto的布局中。

替代方法2：使用服务提供者

您可以使用服务提供者以编程方式使脚本在所有视图中可用。创建自定义服务提供者或使用AppServiceProvider：

public function boot()
{
    view()->composer('shop::layouts.master', function ($view) {
        // The script will be available in the layout
    });
}

或者创建一个渲染script标签的Blade组件，并将其包含在您的布局中。

提示： 如果您想根据配置值或环境设置有条件地加载聊天机器人，服务提供者方法非常有用。

替代方法3：使用Bagisto事件系统

Bagisto在布局的各个位置触发视图事件。您可以监听bagisto.shop.layout.body.after来注入聊天机器人脚本：

Event::listen('bagisto.shop.layout.body.after', function($viewRenderEventManager) {
    $viewRenderEventManager->addTemplate('shop::partials.asyntai-widget');
});

然后在packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php（或已发布的等效位置）创建部分模板，包含您的嵌入代码：

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

注意： 事件系统方法使您的更改保持模块化，与核心布局文件分离，便于在Bagisto升级期间进行管理。

步骤3：清除缓存并验证

添加嵌入代码后，清除应用程序缓存以确保更改生效：

php artisan cache:clear && php artisan view:clear

在新的浏览器标签页或无痕窗口中访问您的Bagisto商店。您应该在右下角看到聊天小部件按钮。点击它以确保其正常打开和运行。

看不到小部件？ 确保您已运行php artisan cache:clear和php artisan view:clear。也请尝试清除浏览器缓存或在无痕窗口中查看。如果您直接编辑了包源文件，请验证没有已发布的视图覆盖您的更改。检查您的嵌入代码是否正确放置在</body>闭合标签之前。