كيفية إضافة روبوت الدردشة Asyntai AI إلى Bagisto

دليل خطوة بخطوة لمنصة التجارة الإلكترونية Bagisto

المنصة:

الخطوة 1: احصل على كود التضمين

أولاً، انتقل إلى لوحة تحكم Asyntai وانتقل لأسفل إلى قسم "Embed Code". انسخ كود التضمين الفريد الذي سيبدو هكذا:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

ملاحظة: الكود أعلاه مجرد مثال. يجب عليك نسخ كود التضمين الفريد الخاص بك من لوحة التحكم لأنه يحتوي على معرف الأداة الشخصي الخاص بك.

الخطوة 2: الإضافة إلى قالب تخطيط Blade (موصى به)

يستخدم Bagisto قوالب Laravel Blade. الطريقة الموصى بها هي إضافة كود التضمين مباشرة إلى ملف تخطيط المتجر:

افتح ملف تخطيط المتجر:
- مصدر الحزمة: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- النسخة المنشورة: resources/views/vendor/shop/layouts/master.blade.php (إذا قمت بنشر العروض)
ابحث عن وسم الإغلاق </body>
أضف كود التضمين قبل </body> مباشرة، بعد @stack('scripts'):

@stack('scripts')
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
</body>

نصيحة: إذا قمت بنشر عروض المورد، عدّل النسخة المنشورة في resources/views/vendor/shop/. وإلا، انشرها أولاً باستخدام php artisan vendor:publish --tag=shop-views لتجنب فقدان التغييرات أثناء تحديثات الحزمة.

الطريقة البديلة 1: استخدام @push('scripts') في عرض

في أي عرض أو مكون Blade، يمكنك استخدام مكدس البرامج النصية لحقن برنامج روبوت الدردشة:

@push('scripts')
    <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</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
    });
}

أو أنشئ مكون 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>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

ملاحظة: يحافظ نهج نظام الأحداث على تغييراتك بشكل وحدوي ومنفصل عن ملفات التخطيط الأساسية، مما يسهل إدارتها أثناء ترقيات Bagisto.

الخطوة 3: مسح ذاكرة التخزين المؤقت والتحقق

بعد إضافة كود التضمين، امسح ذاكرة التخزين المؤقت للتطبيق لضمان تطبيق التغييرات:

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

قم بزيارة متجر Bagisto الخاص بك في علامة تبويب جديدة أو نافذة تصفح خاص. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح.

لا ترى الأداة؟ تأكد من تشغيل كل من php artisan cache:clear و php artisan view:clear. جرب أيضاً مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص. إذا عدّلت مصدر الحزمة مباشرة، تحقق من عدم وجود عروض منشورة تتجاوز تغييراتك. تأكد من وضع كود التضمين بشكل صحيح قبل وسم الإغلاق </body>.