איך להוסיף צ'אטבוט AI של Asyntai ל-Bagisto

מדריך צעד אחר צעד לפלטפורמת האי-קומרס Bagisto

פלטפורמה:

שלב 1: קבל את קוד ההטמעה שלך

ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:

<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: שימוש ב-Service Provider

אתה יכול להשתמש ב-service provider כדי להפוך את הסקריפט לזמין בכל התצוגות באופן תוכניתי. צור service provider מותאם אישית או השתמש ב-AppServiceProvider:

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

או צור רכיב Blade שמרנדר את תג הסקריפט וכלול אותו בפריסה שלך.

טיפ: גישת ה-service provider שימושית אם אתה רוצה לטעון את הצ'אטבוט בהתאם לערכי תצורה או הגדרות סביבה.

שיטה חלופית 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>.