Kā pievienot Asyntai MI tērzēšanas robotu Grav

Soli pa solim ceļvedis Grav CMS

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: Pievienojiet Grav motīva veidnei (ieteicams)

Labākais veids, kā pievienot tērzēšanas robotu visām jūsu Grav vietnes lapām, ir rediģēt motīva bāzes Twig veidni:

Pārejiet uz sava Grav projekta direktoriju user/themes/yourtheme/templates/ un atveriet default.html.twig (vai bāzes veidni, ko izmanto jūsu motīvs)
Pievienojiet savu Asyntai iegulto kodu pirms noslēdzošā </body> taga:

<!-- user/themes/yourtheme/templates/default.html.twig -->
...
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  </body>
</html>

Saglabājiet failu

Padoms: Grav izmanto Twig kā savu veidņu dzinēju. Bāzes veidne parasti ir default.html.twig vai partials/base.html.twig atkarībā no jūsu motīva. Pārbaudiet sava motīva struktūru, lai atrastu pareizo failu, kas satur noslēdzošo </body> tagu.

Alternatīvā metode 1: Grav aktīvu pārvaldnieka izmantošana

Grav iebūvētais aktīvu pārvaldnieks nodrošina tīru veidu, kā pievienot JavaScript aktīvus caur Twig:

Atveriet sava motīva bāzes Twig veidni (piemēram, user/themes/yourtheme/templates/partials/base.html.twig)
Izmantojiet aktīvu pārvaldnieku JavaScript pievienošanai:

{% do assets.addJs('https://asyntai.com/static/js/chat-widget.js', {group: 'bottom', loading: 'async', 'data-asyntai-id': 'YOUR_WIDGET_ID'}) %}

Vai pievienojiet iekļauto JavaScript, lai dinamiski izveidotu skripta elementu savā bāzes veidnē:

<!-- user/themes/yourtheme/templates/partials/base.html.twig -->
...
{% block bottom %}
    {{ assets.js('bottom') }}
{% endblock %}

<script>
(function() {
  var script = document.createElement('script');
  script.src = 'https://asyntai.com/static/js/chat-widget.js';
  script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
  script.async = true;
  document.body.appendChild(script);
})();
</script>
</body>
</html>

Piezīme: Aktīvu pārvaldnieka metode ir Grav ieteiktā pieeja JavaScript aktīvu pārvaldīšanai. Tā nodrošina iebūvētu atbalstu aktīvu cauruļvadīšanai, secībai un grupēšanai.

Alternatīvā metode 2: Custom JS spraudņa izmantošana

Ja dodat priekšroku pieejai, kas balstīta uz spraudņiem, nerediģējot motīva failus:

Instalējiet \"Custom JS\" spraudni no Grav administrācijas paneļa vai caur CLI:

bin/gpm install custom-js

Dodieties uz Administrācija > Spraudņi > Custom JS
Pievienojiet iegultā skripta kodu:

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

Saglabājiet spraudņa konfigurāciju

Padoms: Spraudņa izmantošana skriptu injicēšanai nozīmē, ka nav jāmodificē nekādi motīva faili. Tas atvieglo motīvu maiņu vai atjaunināšanu, nezaudējot tērzēšanas robota integrāciju.

Alternatīvā metode 3: Bloku pārrakstīšana bērnu veidnē

Ja jūsu Grav motīvs izmanto Twig bloku mantošanu, varat pārrakstīt apakšējo bloku bērnu veidnē:

{% block bottom %}
    {{ parent() }}
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
{% endblock %}

Izveidojiet vai atveriet bērnu veidni, kas paplašina jūsu tēmas bāzes veidni
Pievienojiet iepriekš parādīto bloka pārrakstīšanu
Izsaukums parent() nodrošina, ka viss esošais saturs blokā tiek saglabāts

Piezīme: Šī metode izmanto Twig veidņu mantošanas sistēmu. Pārliecinieties, ka bloka nosaukums (piemēram, bottom) atbilst blokam, kas definēts jūsu motīva bāzes veidnē. Bieži sastopami bloku nosaukumi ietver bottom, javascripts vai footer.

Alternatīvā metode 4: Grav Custom Head spraudņa izmantošana

Vēl viena uz spraudņiem balstīta opcija ir Custom Head spraudnis:

Instalējiet custom-head spraudni caur CLI vai administrācijas paneli:

bin/gpm install custom-head

Dodieties uz Administrācija > Spraudņi > Custom Head
Pievienojiet savu Asyntai iegultā skripta kodu spraudņa konfigurācijā:

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

Saglabājiet konfigurāciju

Padoms: Custom Head spraudnis ļauj injicēt kodu jūsu vietnes galvenes vai pamatteksta sadaļās, nepieskaroties motīva failiem. Pārbaudiet spraudņa dokumentāciju, lai atrastu pareizo izvietojuma opciju skripta ievietošanai pirms noslēdzošā </body> taga.

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

Pēc koda pievienošanas notīriet Grav kešatmiņu un pārbaudiet instalēšanu:

# Clear cache via CLI
bin/grav clearcache

# Or clear cache from Admin Panel:
# Admin > Tools > Clear Cache

Atveriet savu Grav vietni jaunā pārlūkprogrammas cilnē. Jums vajadzētu redzēt tērzēšanas logrīka pogu apakšējā labajā stūrī. Noklikšķiniet uz tās, lai pārliecinātos, ka tā atveras un darbojas pareizi.

Neredzat logrīku? Pārliecinieties, ka notīrījāt Grav kešatmiņu ar bin/grav clearcache vai no administrācijas paneļa. Pārbaudiet, vai aizstājāt YOUR_WIDGET_ID ar savu reālo logrīka ID no vadības paneļa. Notīriet pārlūkprogrammas kešatmiņu vai skatiet inkognito režīmā. Atveriet pārlūkprogrammas konsoli (F12), lai pārbaudītu JavaScript kļūdas. Pārbaudiet, vai skripts ir klāt lapas avotā, ar peles labo pogu noklikšķinot un atlasot "Skatīt lapas avotu".

Dokumentācija

Kā pievienot Asyntai MI tērzēšanas robotu Grav

1. solis: Iegūstiet savu iegulto kodu

2. solis: Pievienojiet Grav motīva veidnei (ieteicams)

Alternatīvā metode 1: Grav aktīvu pārvaldnieka izmantošana

Alternatīvā metode 2: Custom JS spraudņa izmantošana

Alternatīvā metode 3: Bloku pārrakstīšana bērnu veidnē

Alternatīvā metode 4: Grav Custom Head spraudņa izmantošana

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