Natrag na nadzornu ploču

Dokumentacija

Naučite kako koristiti Asyntai

Kako dodati Asyntai AI chatbot na TYPO3

Vodic korak po korak za TYPO3 web stranice

Nabavite kod za ugradnju

Korak 1: Nabavite svoj kod za ugradnju

Prvo idite na svoju Asyntai nadzornu ploču i pomaknite se prema dolje do odjeljka "Kod za ugradnju". Kopirajte svoj jedinstveni kod za ugradnju koji će izgledati ovako:

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

Napomena: Gornji kod je samo primjer. Morate kopirati svoj vlastiti jedinstveni kod za ugradnju sa svoje Nadzorne ploče jer sadrži vaš osobni ID widgeta.

Korak 2: Koristenje TypoScript footerData (Preporuceno)

Najlaksi nacin za dodavanje chatbota na sve stranice je koristenje TypoScript footerData:

  1. Prijavite se u svoj TYPO3 Backend
  2. Idite na Web → Template
  3. Odaberite korijensku stranicu u stablu stranica
  4. Kliknite na "Edit the whole template record" (ili odaberite "Info/Modify" pa "Setup")
  5. U polje Setup dodajte sljedeci 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. Zamijenite YOUR_WIDGET_ID svojim stvarnim ID-jem widgeta s nadzorne ploce
  7. Kliknite "Spremi"
  8. Ocistite TYPO3 predmemoriju: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Savjet: Koristenje footerData smjesta skriptu neposredno prije zavrsne oznake </body>, sto je preporuceno za widgete za razgovor jer nece usporiti ucitavanje stranice.

Alternativa: Koristenje paketa stranice (Za pakete stranica)

Ako koristite paket stranice, mozete dodati skriptu putem svoje TypoScript konfiguracijske datoteke:

  1. Navigirajte do mape paketa stranice: packages/vas_paketstranice/Configuration/TypoScript/
  2. Otvorite ili izradite setup.typoscript
  3. Dodajte sljedeci 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. Zamijenite YOUR_WIDGET_ID svojim stvarnim ID-jem widgeta
  5. Ocistite predmemoriju u TYPO3 backendu

Alternativa: Koristenje Fluid predloska (FooterAssets)

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

  1. Navigirajte do svoje Fluid datoteke predloska (obicno u Resources/Private/Templates/)
  2. Dodajte odjeljak FooterAssets u svoj raspored ili predlozak:
    <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. Provjerite prikazuje li vas raspored stranice odjeljak FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. Ocistite TYPO3 predmemoriju

Važno: Znacajka FooterAssets zahtijeva TYPO3 v8 ili noviji. Za starije verzije koristite metodu TypoScript footerData.

Alternativa: Koristenje AssetCollectora (Za programere)

Za programere prosirenja, TYPO3 v10.3+ nudi AssetCollector API:

  1. U svom PHP kodu (npr. kontroleru ili middlewareu) ubacite AssetCollector
  2. Dodajte skriptu s prilagodenim atributima:
    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']
    );

Korak 3: Provjerite instalaciju

Nakon spremanja promjena i ciscenja predmemorije, posjetite svoju web stranicu u novoj kartici preglednika ili anonimnom prozoru. Trebali biste vidjeti gumb widgeta za razgovor u donjem desnom kutu. Kliknite ga kako biste provjerili otvara li se i radi li ispravno.

Ne vidite widget? Obavezno ocistite sve predmemorije: idite na Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Takoder pokusajte ocistiti predmemoriju preglednika ili pregledavati u anonimnom prozoru. Ako koristite TypoScript, potvrdite da je vas predlozak ispravno ukljucen u hijerarhiju stranica.