Grįžti į valdymo skydą

Dokumentacija

Sužinokite, kaip naudoti Asyntai

Kaip pridėti Asyntai DI pokalbių robotą prie Backdrop CMS

Žingsnis po žingsnio vadovas Backdrop CMS 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: Pridėkite prie temos šablono (Rekomenduojama)

Backdrop CMS naudoja .tpl.php šablonų failus savo temose. Rekomenduojamas būdas yra pridėti įterpimo kodą tiesiai į aktyvios temos puslapio šabloną:

  1. Prisijunkite prie savo Backdrop CMS diegimo per FTP arba Failų tvarkyklę
  2. Eikite į aktyvios temos katalogą: themes/yourtheme/
  3. Atidarykite page.tpl.php failą (arba layout.tpl.php priklausomai nuo temos)
  4. Raskite uždaromąją </body> žymą arba eilutę <?php print $page_bottom; ?>
  5. Įklijuokite savo Asyntai įterpimo kodą prieš pat tą eilutę
  6. Išsaugokite failą
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Patarimas: Kodo įdėjimas prieš pat <?php print $page_bottom; ?> arba uždaromąją </body> žymą užtikrina, kad pokalbių robotas krausis po puslapio turinio, suteikdamas geresnį puslapio įkrovimo našumą. Šis metodas automatiškai prideda pokalbių robotą prie kiekvieno puslapio, naudojančio šią temą.

Alternatyvus metodas 1: Pasirinktinio modulio naudojimas

Galite sukurti paprastą Backdrop CMS modulį, kuris įterpia pokalbių roboto skriptą naudojant backdrop_add_js():

  1. Sukurkite modulio katalogą: modules/custom/asyntai_widget/
  2. Sukurkite modulio failą asyntai_widget.module su šiuo kodu:
    // modules/custom/asyntai_widget/asyntai_widget.module
    function asyntai_widget_init() {
      backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
        'type' => 'external',
        'scope' => 'footer',
        'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
      ));
    }
  3. Sukurkite asyntai_widget.info failą:
    name = Asyntai AI Chatbot Widget
    description = Adds the Asyntai AI chatbot widget to all pages.
    backdrop = 1.x
    package = Custom
    type = module
  4. Eikite į Funkcionalumas (admin/modules) savo Backdrop administravimo skydelyje
  5. Raskite "Asyntai AI Chatbot Widget" po Pasirinktinių paketų ir įjunkite
  6. Spustelėkite "Išsaugoti konfigūraciją"

Pastaba: Pakeiskite YOUR_WIDGET_ID modulio kode savo tikruoju valdiklio ID iš Asyntai valdymo skydelio. Pasirinktinio modulio būdas yra saugus atnaujinant ir nebus perrašytas atnaujinant temą.

Alternatyvus metodas 2: Backdrop "Add to Head" modulio naudojimas

Bendruomenės "Add to Head" modulis suteikia lengvą būdą įterpti skriptus neredaguojant kodo:

  1. Atsisiųskite ir įdiekite "Add to Head" bendruomenės modulį iš Backdrop CMS svetainės
  2. Eikite į Konfigūracija > Kūrimas > Add to Head
  3. Pridėkite savo Asyntai įterpimo kodą poraštės skyriuje
  4. Spustelėkite "Išsaugoti konfigūraciją"

Patarimas: "Add to Head" modulio naudojimas yra paprasčiausias metodas, jei nenorite redaguoti temos failų ar kurti pasirinktinių modulių. Jis suteikia paprastą administravimo sąsają įterptų skriptų valdymui.

Alternatyvus metodas 3: Blokų sistemos naudojimas

Backdrop CMS išdėstymo ir blokų sistema taip pat gali būti naudojama pokalbių robotui pridėti:

  1. Prisijunkite prie savo Backdrop CMS administravimo skydelio
  2. Eikite į Struktūra > Išdėstymai
  3. Pasirinkite išdėstymą, kurį norite redaguoti (pvz., numatytąjį išdėstymą)
  4. Spustelėkite "Pridėti bloką" poraštės srityje
  5. Pasirinkite "Pasirinktinis blokas"
  6. Nustatykite bloko formatą kaip "Pilnas HTML" arba "Neapdorotas HTML"
  7. Įklijuokite savo Asyntai įterpimo kodą į bloko turinį
  8. Suteikite blokui pavadinimą (pvz., "Asyntai pokalbių robotas") ir pasirinktinai pažymėkite "Slėpti pavadinimą"
  9. Spustelėkite "Išsaugoti bloką" ir tada "Išsaugoti išdėstymą"

Svarbu: Įsitikinkite, kad teksto formatas nustatytas kaip "Pilnas HTML" arba "Neapdorotas HTML", kad skripto žyma nebūtų pašalinta. Numatytasis "Filtruotas HTML" formatas pašalins skripto žymas saugumo sumetimais.

3 žingsnis: Išvalykite talpyklą ir patikrinkite

Atlikę pakeitimus, išvalykite Backdrop CMS talpyklą ir patikrinkite diegimą:

  1. Eikite į Konfigūracija > Našumas administravimo skydelyje
  2. Spustelėkite "Išvalyti visas talpyklas"
  3. Atidarykite svetainę naujame naršyklės skirtuke arba inkognito lange
  4. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe
  5. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai

Nematote valdiklio? Įsitikinkite, kad išvalėte Backdrop CMS talpyklą Konfigūracija > Našumas. Pabandykite peržiūrėti svetainę inkognito lange arba išvalykite naršyklės talpyklą. Atidarykite naršyklės konsolę (F12) ir patikrinkite, ar nėra JavaScript klaidų. Jei naudojote pasirinktinio modulio metodą, patikrinkite, ar modulis įjungtas Funkcionalume.