Grįžti į valdymo skydą

Dokumentacija

Sužinokite, kaip naudoti Asyntai

Kaip pridėti Asyntai AI pokalbių robotą prie TYPO3

Žingsnis po žingsnio vadovas TYPO3 svetainėms

Gauti įterpimo kodą

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

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

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: TypoScript footerData naudojimas (rekomenduojama)

Paprasčiausias būdas pridėti pokalbių robotą visuose puslapiuose yra naudoti TypoScript footerData:

  1. Prisijunkite prie savo TYPO3 administravimo aplinkos
  2. Eikite į Web → Template
  3. Pasirinkite savo šakninį puslapį puslapių medyje
  4. Spustelėkite "Edit the whole template record" (arba pasirinkite "Info/Modify" ir tada "Setup")
  5. Setup lauke pridėkite šį TypoScript kodą:
    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. Pakeiskite YOUR_WIDGET_ID savo tikruoju valdiklio ID iš valdymo skydelio
  7. Spustelėkite "Išsaugoti"
  8. Išvalykite TYPO3 talpyklą: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Patarimas: footerData naudojimas patalpina scenarijų prieš pat uždaromąjį </body> žymą, kas yra rekomenduojama pokalbių valdikliams, nes tai nesulėtins puslapio įkėlimo.

Alternatyva: svetainės paketo naudojimas (svetainių paketams)

Jei naudojate svetainės paketą, galite pridėti scenarijų per savo TypoScript konfigūracijos failą:

  1. Eikite į savo svetainės paketo aplanką: packages/your_sitepackage/Configuration/TypoScript/
  2. Atidarykite arba sukurkite setup.typoscript
  3. Pridėkite šį kodą:
    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. Pakeiskite YOUR_WIDGET_ID savo tikruoju valdiklio ID
  5. Išvalykite talpyklą TYPO3 administravimo aplinkoje

Alternatyva: Fluid šablono naudojimas (FooterAssets)

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

  1. Eikite į savo Fluid šablono failą (paprastai Resources/Private/Templates/)
  2. Pridėkite FooterAssets skiltį savo išdėstyme arba šablone:
    <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. Įsitikinkite, kad jūsų puslapio išdėstymas atvaizduoja FooterAssets skiltį:
    <f:render section="FooterAssets" optional="true" />
  4. Išvalykite TYPO3 talpyklą

Svarbu: FooterAssets funkcija reikalauja TYPO3 v8 arba naujesnės versijos. Senesnėms versijoms naudokite TypoScript footerData metodą.

Alternatyva: AssetCollector naudojimas (kūrėjams)

Plėtinių kūrėjams TYPO3 v10.3+ siūlo AssetCollector API:

  1. Savo PHP kode (pvz., valdiklyje ar tarpinėje programinėje įrangoje) įterpkite AssetCollector
  2. Pridėkite scenarijų su individualiais atributais:
    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 žingsnis: Patikrinkite diegimą

Išsaugoję pakeitimus ir išvalę talpyklą, apsilankykite svetainėje naujame naršyklės skirtuke arba inkognito lange. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai.

Nematote valdiklio? Būtinai išvalykite visas talpyklas: eikite į Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Taip pat pabandykite išvalyti naršyklės talpyklą arba peržiūrėti inkognito lange. Jei naudojate TypoScript, patikrinkite, ar jūsų šablonas tinkamai įtrauktas į puslapių hierarchiją.