Vissza az iranyitopultra

Dokumentacio

Ismerje meg az Asyntai hasznalatat

Az Asyntai AI Chatbot hozzáadása a TYPO3-hoz

Lépésről lépésre útmutató a TYPO3 weboldalakhoz

Beágyazási kód lekérése

1. lépés: Szerezze be a beágyazási kódját

Először lépjen az Asyntai Irányítópultra és görgessen le a „Beágyazási kód" szekcióhoz. Másolja le az egyedi beágyazási kódját, amely így fog kinézni:

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

Megjegyzés: A fenti kód csak egy példa. Le kell másolnia saját egyedi beágyazási kódját az Irányítópultról, mivel az tartalmazza személyes widget-azonosítóját.

2. lépés: TypoScript footerData használata (ajánlott)

A chatbot összes oldalhoz való hozzáadásának legegyszerűbb módja a TypoScript footerData használata:

  1. Jelentkezzen be a TYPO3 adminfelületére
  2. Lépjen a Web → Sablon menüponthoz
  3. Válassza ki a gyökéroldalt az oldafában
  4. Kattintson a „Teljes sablonrekord szerkesztése" gombra (vagy válassza az „Információ/Módosítás", majd a „Beállítás" opciót)
  5. In the Setup field, add the following TypoScript code:
    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. Cserélje ki a YOUR_WIDGET_ID értékét a tényleges widget azonosítójára az irányítópultról
  7. Kattintson a „Mentés" gombra
  8. Ürítse a TYPO3 gyorsítótárát: Admin eszközök → Karbantartás → TYPO3 és PHP gyorsítótár ürítése

Tipp: A footerData használata a szkriptet közvetlenül a záró </body> tag elé helyezi, ami chat widgetek esetén ajánlott, mivel nem lassítja az oldal betöltését.

Alternatíva: Site Package használata (Site Package-ekhez)

Ha site package-et használ, a szkriptet a TypoScript konfigurációs fájlon keresztül adhatja hozzá:

  1. Navigáljon a site package mappájához: packages/your_sitepackage/Configuration/TypoScript/
  2. Nyissa meg vagy hozza létre a setup.typoscript fájlt
  3. Adja hozzá a következő kódot:
    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. Replace YOUR_WIDGET_ID with your actual widget ID
  5. Ürítse a gyorsítótárat a TYPO3 adminfelületen

Alternatíva: Fluid sablon használata (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

  1. Navigáljon a Fluid sablonfájlhoz (általában a Resources/Private/Templates/ könyvtárban)
  2. Adjon hozzá FooterAssets szakaszt az elrendezéshez vagy sablonhoz:
    <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. Make sure your page layout renders the FooterAssets section:
    <f:render section="FooterAssets" optional="true" />
  4. Ürítse a TYPO3 gyorsítótárát

Fontos: A FooterAssets funkció TYPO3 v8 vagy újabb verziót igényel. Régebbi verziókhoz használja a TypoScript footerData módszert.

Alternatíva: AssetCollector használata (fejlesztőknek)

Bővítményfejlesztők számára a TYPO3 v10.3+ az AssetCollector API-t kínálja:

  1. A PHP kódjában (pl. egy vezérlőben vagy köztes rétegben) injektálja az AssetCollectort
  2. Adja hozzá a szkriptet egyéni attribútumokkal:
    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. lépés: Telepítés ellenőrzése

A módosítások mentése és a gyorsítótár ürítése után látogasson el webhelyére egy új böngészőlapon vagy inkognitóablakban. A jobb alsó sarokban meg kell jelennie a chat widget gombnak. Kattintson rá, hogy megbizonyosodjon arról, hogy megfelelően nyílik meg és működik.

Nem látja a widgetet? Győződjön meg róla, hogy törölt minden gyorsítótárat: lépjen az Admin eszközök → Karbantartás → TYPO3 és PHP gyorsítótár ürítése menüponthoz. Próbálja meg törölni a böngészőgyorsítótárat is, vagy tekintse meg inkognító ablakban. Ha TypoScriptet használ, ellenőrizze, hogy a sablon megfelelően szerepel-e az oldalak hierarchiájában.