กลับไปที่แดชบอร์ด

เอกสาร

เรียนรู้วิธีใช้ Asyntai

วิธีเพิ่มแชทบอท AI Asyntai ไปยัง TYPO3

คู่มือทีละขั้นตอนสำหรับเว็บไซต์ TYPO3

รับโค้ดฝัง

ขั้นตอนที่ 1: รับโค้ดฝังตัวของคุณ

ก่อนอื่น ไปที่แดชบอร์ด Asyntai ของคุณและเลื่อนลงไปที่ส่วน "Embed Code" คัดลอกโค้ดฝังตัวเฉพาะของคุณซึ่งจะมีลักษณะดังนี้:

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

หมายเหตุ: โค้ดด้านบนเป็นเพียงตัวอย่าง คุณต้องคัดลอกโค้ดฝังตัวเฉพาะของคุณจากแดชบอร์ดเนื่องจากมี widget ID ส่วนตัวของคุณ

ขั้นตอนที่ 2: การใช้ TypoScript footerData (แนะนำ)

วิธีที่ง่ายที่สุดในการเพิ่มแชทบอทไปยังทุกหน้าคือใช้ TypoScript footerData:

  1. เข้าสู่ระบบ TYPO3 Backend ของคุณ
  2. ไปที่ Web → Template
  3. เลือกหน้ารากในโครงสร้างหน้า
  4. คลิก "Edit the whole template record" (หรือเลือก "Info/Modify" แล้ว "Setup")
  5. ในฟิลด์ Setup ให้เพิ่มโค้ด TypoScript ต่อไปนี้:
    page.footerData.99 = TEXT
    page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  6. แทนที่ YOUR_WIDGET_ID ด้วย widget ID จริงของคุณจากแดชบอร์ด
  7. คลิก "Save"
  8. ล้างแคช TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

เคล็ดลับ: การใช้ footerData วางสคริปต์ก่อนแท็กปิด </body> ซึ่งแนะนำสำหรับวิดเจ็ตแชทเนื่องจากจะไม่ทำให้หน้าโหลดช้าลง

ทางเลือก: การใช้ Site Package (สำหรับ Site Packages)

หากคุณใช้ site package คุณสามารถเพิ่มสคริปต์ผ่านไฟล์การกำหนดค่า TypoScript:

  1. นำทางไปยังโฟลเดอร์ site package ของคุณ: packages/your_sitepackage/Configuration/TypoScript/
  2. เปิดหรือสร้าง setup.typoscript
  3. เพิ่มโค้ดต่อไปนี้:
    page.footerData {
      99 = TEXT
      99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }
  4. แทนที่ YOUR_WIDGET_ID ด้วย widget ID จริงของคุณ
  5. ล้างแคชใน TYPO3 backend

ทางเลือก: การใช้ Fluid Template (FooterAssets)

สำหรับเว็บไซต์ที่ใช้ Fluid templates คุณสามารถใช้ส่วน FooterAssets:

  1. นำทางไปยังไฟล์ Fluid template ของคุณ (โดยปกติอยู่ใน Resources/Private/Templates/)
  2. เพิ่มส่วน FooterAssets ใน layout หรือเทมเพลตของคุณ:
    <f:section name="FooterAssets">
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    </f:section>
  3. ตรวจสอบให้แน่ใจว่า page layout ของคุณแสดงผลส่วน FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. ล้างแคช TYPO3

สำคัญ: ฟีเจอร์ FooterAssets ต้องการ TYPO3 v8 หรือใหม่กว่า สำหรับเวอร์ชันเก่า ให้ใช้วิธี TypoScript footerData

ทางเลือก: การใช้ AssetCollector (สำหรับนักพัฒนา)

สำหรับนักพัฒนา extension TYPO3 v10.3+ มี AssetCollector API:

  1. ในโค้ด PHP ของคุณ (เช่น controller หรือ middleware) ให้ inject AssetCollector
  2. เพิ่มสคริปต์พร้อม custom attributes:
    use TYPO3\CMS\Core\Page\AssetCollector;

    $this->assetCollector->addJavaScript(
      'asyntai_chatbot',
      'https://asyntai.com/static/js/chat-widget.js',
      ['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
    );

ขั้นตอนที่ 3: ยืนยันการติดตั้ง

หลังจากบันทึกการเปลี่ยนแปลงและล้างแคชแล้ว ให้เยี่ยมชมเว็บไซต์ของคุณในแท็บเบราว์เซอร์ใหม่หรือหน้าต่างส่วนตัว คุณควรเห็นปุ่มวิดเจ็ตแชทที่มุมขวาล่าง คลิกเพื่อตรวจสอบว่าเปิดและทำงานได้อย่างถูกต้อง

ไม่เห็นวิดเจ็ต? ตรวจสอบให้แน่ใจว่าล้างแคชทั้งหมดแล้ว: ไปที่ Admin Tools → Maintenance → Flush TYPO3 and PHP Cache ลองล้างแคชเบราว์เซอร์หรือดูในหน้าต่างไม่ระบุตัวตน หากใช้ TypoScript ให้ตรวจสอบว่าเทมเพลตของคุณถูกรวมอย่างถูกต้องในลำดับชั้นของหน้า