Kā pievienot Asyntai AI tērzēšanas robotu Statamic

Soli pa solim ceļvedis Statamic CMS tīmekļa vietnēm

Platforma:

1. solis: Iegūstiet savu iegulto kodu

Vispirms dodieties uz savu Asyntai vadības paneli un ritiniet uz leju līdz sadaļai "Iegultais kods". Nokopējiet savu unikālo iegulto kodu, kas izskatīsies šādi:

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

Piezīme: Iepriekš minētais kods ir tikai piemērs. Jums jānokopē savs unikālais iegultais kods no sava Vadības paneļa, jo tas satur jūsu personīgo logrīka ID.

2. solis: Izvēlieties instalēšanas metodi

Statamic atbalsta gan Antlers, gan Blade veidņu dzinējus. Izvēlieties metodi atkarībā no izmantotā veidņu dzinēja:

1. metode: Antlers izkārtojums (ieteicams)

Vienkāršākais veids, kā pievienot tērzēšanas robotu, ir iekļaut to savā galvenajā izkārtojuma failā. Statamic izmanto Antlers kā savu noklusējuma veidņu dzinēju.

Dodieties uz sava Statamic projekta direktoriju resources/views
Open your layout file (usually layout.antlers.html)
Atrodiet noslēdzošo </body> tagu
Ielīmējiet savu Asyntai iegulto kodu tieši pirms </body> taga
Saglabājiet failu

<!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>

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

2. metode: Blade izkārtojums

Ja izmantojat Blade veidnes Antlers vietā, izpildiet šīs darbības:

Dodieties uz sava Statamic projekta direktoriju resources/views
Open your Blade layout file (e.g., layout.blade.php)
Atrodiet noslēdzošo </body> tagu
Ielīmējiet savu Asyntai iegulto kodu tieši pirms </body> taga
Saglabājiet failu

<!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>

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

3. metode: Daļējās veidnes izmantošana

Labākai organizācijai varat izveidot atkārtoti izmantojamu daļējo veidni tērzēšanas robotam:

1. solis: Izveidojiet daļējo veidni

Izveidojiet jaunu failu resources/views/partials/_chatbot.antlers.html
Pievienojiet savu Asyntai iegulto kodu šim failam:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

2. solis: Iekļaušana izkārtojumā

Atveriet savu izkārtojuma failu (layout.antlers.html)
Pievienojiet daļējās veidnes tagu pirms </body>:
{{ partial:chatbot }} </body>

Kāpēc izmantot daļējo veidni? Daļējās veidnes atvieglo ārējo skriptu pārvaldīšanu vienā vietā. Ja kādreiz būs jāatjaunina tērzēšanas robota kods, jums vajadzēs rediģēt tikai vienu failu.

Vairāku izkārtojumu izmantošana

Ja jūsu Statamic vietne izmanto vairākus izkārtojumus (piem., dažādus izkārtojumus emuāra ierakstiem, galvenajām lapām u.c.), noteikti pievienojiet tērzēšanas robota skriptu katram izkārtojuma failam, kur vēlaties, lai logrīks parādītos.

Varat iestatīt, kuru izkārtojumu lapa izmanto, vairākos veidos:

Ierakstā: Pievienojiet layout: your_layout priekšējiem metadatiem
Kolekcijā: Iestatiet noklusējuma izkārtojumu savas kolekcijas konfigurācijas YAML failā
Projektā: Pievienojiet izkārtojuma lauku, no kura redaktori var izvēlēties

Statamic sākuma komplektiem

Ja izmantojat Statamic sākuma komplektu, izkārtojuma atrašanās vieta var atšķirties. Biežāk sastopamās vietas:

Default Statamic

resources/views/layout.antlers.html

Peak Starter

resources/views/layout.antlers.html ar daļējām veidnēm mapē resources/views/snippets/

Cool Writings

resources/views/layout.antlers.html

Starter's Creek

resources/views/layout.blade.php

3. solis: Notīriet kešatmiņu un pārbaudiet

Pēc koda pievienošanas iztīriet savu Statamic kešatmiņu, lai nodrošinātu, ka izmaiņas stājas spēkā:

php artisan cache:clear
php please stache:refresh

Pēc tam apmeklējiet savu tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā. Apakšējā labajā stūrī vajadzētu redzēt tērzēšanas logrīka pogu. Noklikšķiniet uz tās, lai pārliecinātos, ka tā atveras un darbojas pareizi.

Neredzat logrīku? Pārliecinieties, ka esat iztīrījis gan Laravel, gan Statamic Stache kešatmiņu. Ja izmantojat statisko kešatmiņu, palaidiet arī php please static:clear. Pārbaudiet pārlūkprogrammas konsoli (F12), vai nav JavaScript kļūdu.

Svarīgi: Ja izmantojat Statamic statisko vietņu ģeneratoru (ssg), noteikti atģenerējiet statiskos failus pēc tērzēšanas robota skripta pievienošanas, palaižot php please ssg:generate.

Dokumentācija