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

פלטפורמה:

CrafterCMS

HTML/Custom WordPress Shopify WooCommerce BigCommerce Ecwid Wix Squarespace Webflow Weebly HubSpot Tilda Adobe Experience Manager Duda Google Sites Bludit Plesk Concrete CMS Docusaurus Hugo Kentico Volusion Craft CMS Contentful Strapi Joomla Drupal Magento Blogger Bitrix TYPO3 PrestaShop OpenCart Ghost Statamic Umbraco Moodle SilverStripe Grav October CMS ProcessWire Sanity ExpressionEngine Sylius Backdrop CMS MODX Bagisto PayloadCMS e107 CrafterCMS Kirby MedusaCMS DatoCMS GoDaddy Framer Bubble Carrd Jimdo Strikingly Kajabi Teachable Thinkific ClickFunnels Hostinger Unbounce Leadpages Systeme.io Instapage

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

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

שלב 2: הוספה לתבנית FreeMarker (מומלץ)

CrafterCMS משתמש בתבניות FreeMarker (.ftl) לעיבוד עמודים. הדרך הקלה ביותר להוסיף את הצ'אטבוט לכל העמודים היא על ידי עריכת תבנית העמוד הראשית שלך:

1. ב-Crafter Studio, עבור אל Site Dashboard > Content Types או נווט לתבניות
2. פתח את תבנית העמוד הראשית שלך (למשל, /templates/web/pages/home.ftl או פריסת הבסיס)
3. מצא את תג הסגירה </body>
4. הדבק את קוד ההטמעה של Asyntai ממש לפני תגית </body>:
   <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
5. שמור את הקובץ ופרסם דרך Crafter Studio

שיטה חלופית 1: שימוש ברכיבי תבנית של Crafter

לארגון טוב יותר, צור תבנית רכיב ייעודית עבור ווידג'ט הצ'אטבוט:

1. ב-Crafter Studio, צור קובץ תבנית חדש ב-/templates/web/components/asyntai-widget.ftl
2. הוסף את התוכן הבא לתבנית הרכיב:
   <!-- Asyntai AI Chatbot Component --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
3. כלול אותו בתבנית הפריסה הראשית שלך באמצעות הוראת include של FreeMarker:
   <#include "/templates/web/components/asyntai-widget.ftl" />
4. לחלופין, אם אתה משתמש במערכת עיבוד הרכיבים של Crafter, השתמש ב:
   <@renderComponent component=contentModel.asyntaiWidget />
5. שמור את שני הקבצים ופרסם דרך Crafter Studio

שיטה חלופית 2: שימוש בתצורת Head/Scripts של Crafter

CrafterCMS מאפשר לך להזריק סקריפטים באופן גלובלי דרך תצורת האתר:

1. ב-Crafter Studio, נווט אל Site Config > Configuration
2. פתח את קובץ Engine Site Configuration (site-config.xml)
3. הוסף תצורת הזרקת סקריפט מותאמת אישית:
   <site> <!-- Existing configuration... --> <!-- Custom Scripts --> <scripts> <script> <src>https://asyntai.com/static/js/chat-widget.js</src> <async>true</async> <data-asyntai-id>YOUR_WIDGET_ID</data-asyntai-id> </script> </scripts> </site>
4. לחלופין, ערוך את פריסת FreeMarker הבסיסית שלך כדי לקרוא מתצורת האתר ולהזריק סקריפטים באופן דינמי:
   <#if siteConfig.getString("scripts.script.src", "")?has_content> <script async src="${siteConfig.getString("scripts.script.src")}" data-asyntai-id="${siteConfig.getString("scripts.script.data-asyntai-id")}"></script> </#if>
5. שמור ופרסם את שינויי התצורה

שיטה חלופית 3: שימוש בבקר Groovy

CrafterCMS תומך בסקריפטי Groovy ללוגיקה בצד השרת. ניתן להשתמש בבקר כדי להוסיף את סקריפט הצ'אטבוט באופן דינמי:

1. צור סקריפט Groovy ב-/scripts/pages/ (למשל, /scripts/pages/home.groovy או הבקר הכללי של האתר שלך)
2. הוסף את הקוד הבא כדי להזריק את כתובת URL של הסקריפט למודל התבנית:
   // /scripts/pages/home.groovy import org.craftercms.engine.service.context.SiteContext def siteContext = SiteContext.current // Add Asyntai chatbot configuration to the model model.asyntaiEnabled = true model.asyntaiWidgetId = "YOUR_WIDGET_ID" model.asyntaiScriptSrc = "https://asyntai.com/static/js/chat-widget.js"
3. לאחר מכן הפנה למשתני המודל בתבנית FreeMarker שלך:
   <#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
4. שמור גם את סקריפט Groovy וגם את קובץ התבנית
5. פרסם את השינויים דרך Crafter Studio

שלב 3: פרסום ואימות

לאחר ביצוע השינויים שלך, פרסם אותם דרך Crafter Studio:

1. ב-Crafter Studio, עבור אל Site Dashboard
2. סקור את השינויים שלך בחלק My Recent Activity או Pending Approval
3. לחץ על Publish כדי לפרוס את השינויים באתר החי שלך
4. בקר באתר CrafterCMS שלך בכרטיסיית דפדפן חדשה או בחלון גלישה פרטית
5. אתה אמור לראות את כפתור ווידג'ט הצ'אט בפינה הימנית התחתונה
6. לחץ עליו כדי לוודא שהוא נפתח ועובד כראוי