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

Žingsnis po žingsnio vadovas Statamic CMS svetainėms

Platforma:

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: Pasirinkite diegimo metodą

Statamic palaiko ir Antlers, ir Blade šablonų sistemas. Pasirinkite metodą pagal tai, kurią šablonų sistemą naudojate:

Metodas 1: Antlers išdėstymas (rekomenduojama)

Paprasčiausias būdas pridėti pokalbių robotą yra įtraukti jį į pagrindinį išdėstymo failą. Statamic naudoja Antlers kaip numatytąjį šablonų variklį.

Eikite į savo Statamic projekto resources/views katalogą
Open your layout file (usually layout.antlers.html)
Raskite uždaromąjį </body> žymą
Įklijuokite savo Asyntai įterpimo kodą prieš </body> žymą
Išsaugokite failą

<!DOCTYPE html>
<html lang="{{ site:short_locale }}">
<head>
  <meta charset="utf-8">
  <title>{{ title }} | {{ site:name }}</title>
  {{ vite src="resources/js/site.js|resources/css/site.css" }}
</head>
<body>
  {{ template_content }}

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

Patarimas: The {{ template_content }} variable is where Statamic injects your page content. Always add the chatbot script after this, just before </body>.

Metodas 2: Blade išdėstymas

Jei naudojate Blade šablonus vietoj Antlers, atlikite šiuos žingsnius:

Eikite į savo Statamic projekto resources/views katalogą
Open your Blade layout file (e.g., layout.blade.php)
Raskite uždaromąjį </body> žymą
Įklijuokite savo Asyntai įterpimo kodą prieš </body> žymą
Išsaugokite failą

<!DOCTYPE html>
<html lang="{{ $site->shortLocale() }}">
<head>
  <meta charset="utf-8">
  <title>{{ $title }} | {{ $site->name() }}</title>
  @vite(['resources/js/site.js', 'resources/css/site.css'])
</head>
<body>
  {!! $template_content !!}

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

Pastaba: In Blade templates, use {!! $template_content !!} to render the page content. The !! syntax prevents HTML escaping.

Metodas 3: dalinio šablono naudojimas

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

1 žingsnis: Dalinio šablono kūrimas

Sukurkite naują failą resources/views/partials/_chatbot.antlers.html
Pridėkite savo Asyntai įterpimo kodą į šį failą:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

2 žingsnis: Įtraukimas į savo išdėstymą

Atidarykite savo išdėstymo failą (layout.antlers.html)
Pridėkite dalinio šablono žymą prieš </body>:
{{ partial:chatbot }} </body>

Kodėl naudoti dalinį šabloną? Daliniai šablonai palengvina išorinių scenarijų valdymą vienoje vietoje. Jei kada nors reikės atnaujinti pokalbių roboto kodą, reikės redaguoti tik vieną failą.

Kelių išdėstymų naudojimas

Jei jūsų Statamic svetainė naudoja kelis išdėstymus (pvz., skirtingus išdėstymus tinklaraščio įrašams, nukreipimo puslapiams ir kt.), būtinai pridėkite pokalbių roboto scenarijų prie kiekvieno išdėstymo failo, kuriame norite rodyti valdiklį.

Galite nustatyti, kurį išdėstymą naudoja puslapis, keliais būdais:

Įraše: Pridėkite layout: your_layout prie antraštės duomenų
Kolekcijoje: Nustatykite numatytąjį išdėstymą savo kolekcijos konfigūracijos YAML faile
Projekte: Pridėkite išdėstymo lauką, kurį redaktoriai gali pasirinkti

Statamic pradiniams rinkiniais

Jei naudojate Statamic pradinį rinkinį, išdėstymo vieta gali skirtis. Įprastos vietos apima:

Default Statamic

resources/views/layout.antlers.html

Peak Starter

resources/views/layout.antlers.html su daliniais šablonais resources/views/snippets/

Cool Writings

resources/views/layout.antlers.html

Starter's Creek

resources/views/layout.blade.php

3 žingsnis: Išvalykite talpyklą ir patikrinkite

Pridėję kodą, išvalykite Statamic talpyklą, kad pakeitimai įsigaliotų:

php artisan cache:clear
php please stache:refresh

Tada apsilankykite savo 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švalėte ir Laravel talpyklą, ir Statamic Stache. Jei naudojate statinę talpyklą, taip pat paleiskite php please static:clear. Patikrinkite naršyklės konsolę (F12) dėl JavaScript klaidų.

Svarbu: Jei naudojate Statamic statinių svetainių generatorių (ssg), būtinai iš naujo sugeneruokite statinius failus pridėję pokalbių roboto scenarijų paleisdami php please ssg:generate.

Dokumentacija