Az Asyntai AI Chatbot hozzáadása a TYPO3-hoz
Lépésről lépésre útmutató a TYPO3 weboldalakhoz
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:
- Jelentkezzen be a TYPO3 adminfelületére
- Lépjen a Web → Sablon menüponthoz
- Válassza ki a gyökéroldalt az oldafában
- 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)
- 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> - Cserélje ki a
YOUR_WIDGET_IDértékét a tényleges widget azonosítójára az irányítópultról - Kattintson a „Mentés" gombra
- Ü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á:
- Navigáljon a site package mappájához:
packages/your_sitepackage/Configuration/TypoScript/ - Nyissa meg vagy hozza létre a setup.typoscript fájlt
- 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>
} - Replace
YOUR_WIDGET_IDwith your actual widget ID - Ü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:
- Navigáljon a Fluid sablonfájlhoz (általában a
Resources/Private/Templates/könyvtárban) - 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> - Make sure your page layout renders the FooterAssets section:
<f:render section="FooterAssets" optional="true" /> - Ü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:
- A PHP kódjában (pl. egy vezérlőben vagy köztes rétegben) injektálja az AssetCollectort
- 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.
Weebly