Grįžti į valdymo skydą

Dokumentacija

Sužinokite, kaip naudoti Asyntai

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

Žingsnis po žingsnio vadovas October 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ėjimas prie išdėstymo šablono (Rekomenduojama)

Rekomenduojamas būdas pridėti pokalbių robotą yra redaguoti numatytąjį išdėstymą October CMS administravimo aplinkoje:

  1. Prisijunkite prie savo October CMS administravimo aplinkos
  2. Eikite į CMS > Layouts pagrindiniame meniu
  3. Atidarykite savo numatytąjį išdėstymą (paprastai default.htm)
  4. Raskite uždaromąjį </body> žymą ir {% scripts %} vietos žymeklį
  5. Pridėkite savo Asyntai įterpimo kodą tiesiai prieš {% scripts %} ir </body>:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
  6. Spustelėkite "Išsaugoti", kad pritaikytumėte pakeitimus

Patarimas: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Galite naudoti October CMS scenarijų vietos žymeklį, kad įterptumėte pokalbių robotą iš puslapio ar dalinio šablono:

  1. Atidarykite bet kurį puslapį ar dalinį šabloną CMS redaktoriuje
  2. Pridėkite šį kodą naudodami {% put scripts %} bloką:
    {% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
  3. Pakeiskite YOUR_WIDGET_ID savo tikruoju valdiklio ID iš valdymo skydelio
  4. Spustelėkite "Išsaugoti"

Pastaba: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Alternatyvus metodas 2: Component PHP naudojimas

Jei pageidaujate programinio požiūrio, galite pridėti pokalbių roboto scenarijų per individualų komponentą:

  1. Sukurkite arba modifikuokite komponentą savo October CMS papildinyje
  2. Komponento onRun() metode naudokite addJs() metodą:
    public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
  3. Pakeiskite YOUR_WIDGET_ID savo tikruoju valdiklio ID
  4. Užregistruokite komponentą puslapiuose, kuriuose norite, kad pokalbių robotas būtų rodomas

Patarimas: Komponento naudojimas suteikia jums programinę kontrolę, kada ir kur pokalbių robotas įkeliamas. Galite pridėti sąlyginę logiką į onRun(), kad valdytumėte įkėlimą pagal naudotojų roles, puslapių tipus ar kitus kriterijus.

Alternatyvus metodas 3: dalinio šablono naudojimas

Geresniam organizavimui galite sukurti pakartotinai naudojamą dalinį šabloną pokalbių robotui:

  1. Eikite į CMS > Partials October CMS administravimo aplinkoje
  2. Spustelėkite \"+ Add\", kad sukurtumėte naują dalinį šabloną
  3. Pavadinkite jį asyntai-widget.htm
  4. Pridėkite savo Asyntai įterpimo kodą prie dalinio šablono:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  5. Spustelėkite "Išsaugoti"
  6. Atidarykite savo išdėstymo šabloną ir įtraukite dalinį šabloną prieš </body>:
    {% partial 'asyntai-widget' %}
  7. Išsaugokite išdėstymą

Patarimas: Dalinio šablono naudojimas palengvina pokalbių roboto įjungimą arba išjungimą visoje svetainėje tiesiog pridedant arba pašalinant dalinio šablono įtraukimą iš savo išdėstymo.

3 žingsnis: Patikrinkite diegimą

Išsaugoję pakeitimus, apsilankykite savo October CMS 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? Įsitikinkite, kad išsaugojote visus pakeitimus CMS administravimo aplinkoje. Išvalykite naršyklės talpyklą arba peržiūrėkite inkognito lange. Jei jūsų svetainė naudoja talpyklą, išvalykite October CMS talpyklą paleisdami php artisan cache:clear iš komandinės eilutės arba naudokite Settings > System > Clear Cache parinktį administravimo aplinkoje.

Išdėstymo pasirinkimas: Įsitikinkite, kad puslapiai, kuriuose norite rodyti pokalbių robotą, naudoja teisingą išdėstymą. Galite patikrinti, kurį išdėstymą naudoja puslapis, atidarydami puslapį CMS > Pages ir pažiūrėdami į Layout išskleidžiamąjį meniu puslapio nustatymuose.