Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

Cum să adăugați chatbotul AI Asyntai pe TYPO3

Ghid pas cu pas pentru site-uri TYPO3

Obține codul de încorporare

Pasul 1: Obțineți codul de încorporare

Mai întâi, accesați Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:

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

Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.

Pasul 2: Utilizarea TypoScript footerData (recomandat)

Cea mai ușoară modalitate de a adăuga chatbotul pe toate paginile este utilizarea TypoScript footerData:

  1. Conectați-vă la Backend-ul TYPO3
  2. Accesați Web → Șablon
  3. Selectați pagina rădăcină în arborele de pagini
  4. Faceți clic pe "Editați întreaga înregistrare de șablon" (sau selectați "Informații/Modificare" și apoi "Configurare")
  5. În câmpul Setup, adăugați următorul cod 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. Înlocuiți YOUR_WIDGET_ID cu ID-ul real al widget-ului din tabloul de bord
  7. Faceți clic pe "Salvare"
  8. Goliți memoria cache TYPO3: Instrumente admin → Întreținere → Golire cache TYPO3 și PHP

Sfat: Utilizarea footerData plasează scriptul chiar înainte de eticheta de închidere </body>, ceea ce este recomandat pentru widgeturile de chat deoarece nu va încetini încărcarea paginii.

Alternativă: Utilizarea pachetului de site (pentru pachete de site)

Dacă utilizați un pachet de site, puteți adăuga scriptul prin fișierul de configurare TypoScript:

  1. Navigați la folderul pachetului de site: packages/your_sitepackage/Configuration/TypoScript/
  2. Deschideți sau creați setup.typoscript
  3. Adăugați următorul cod:
    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. Înlocuiți YOUR_WIDGET_ID cu ID-ul real al widget-ului dvs.
  5. Goliți memoria cache în backend-ul TYPO3

Alternativă: Utilizarea șablonului Fluid (FooterAssets)

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

  1. Navigați la fișierul șablonului Fluid (de obicei în Resources/Private/Templates/)
  2. Adăugați o secțiune FooterAssets în layout-ul sau șablonul dvs.:
    <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. Asigurați-vă că layout-ul paginii dvs. randează secțiunea FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. Goliți memoria cache TYPO3

Important: Funcționalitatea FooterAssets necesită TYPO3 v8 sau mai recent. Pentru versiuni mai vechi, utilizați metoda TypoScript footerData.

Alternativă: Utilizarea AssetCollector (pentru dezvoltatori)

Pentru dezvoltatorii de extensii, TYPO3 v10.3+ oferă API-ul AssetCollector:

  1. În codul dvs. PHP (de ex., un controller sau middleware), injectați AssetCollector
  2. Adăugați scriptul cu atribute personalizate:
    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']
    );

Pasul 3: Verificați instalarea

După ce ați salvat modificările și ați golit cache-ul, vizitați site-ul dvs. într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.

Nu vedeți widgetul? Asigurați-vă că goliți toate cache-urile: accesați Instrumente admin → Întreținere → Golire cache TYPO3 și PHP. De asemenea, încercați să goliți memoria cache a browserului sau să vizualizați într-o fereastră incognito. Dacă utilizați TypoScript, verificați dacă șablonul dvs. este inclus corect în ierarhia paginilor.