Kuidas lisada Asyntai AI vestlusrobotit Gravile

Samm-sammuline juhend Grav CMS-i jaoks

Platvorm:

1. samm: hankige oma manuskood

Esmalt minge oma Asyntai juhtpaneelile ja kerige alla jaotiseni "Manuskood". Kopeerige oma unikaalne manuskood, mis näeb välja selline:

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

Märkus: Ülalolev kood on vaid näide. Peate kopeerima oma unikaalse manuskoodi oma juhtpaneelilt, kuna see sisaldab teie isiklikku vidina ID-d.

Samm 2: lisage Gravi teemamallile (soovitatav)

Parim viis vestlusroboti lisamiseks kõikidele oma Grav saidi lehtedele on muuta oma teema Twig põhimalli:

Navigeerige oma Grav projekti kataloogi user/themes/teieteema/templates/ ja avage default.html.twig (või teie teema kasutatav põhimall)
Lisage oma Asyntai manuskood enne sulgevat </body> silti:

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

Salvestage fail

Vihje: Grav kasutab Twigi oma mallimootrina. Põhimall on tavaliselt default.html.twig või partials/base.html.twig olenevalt teie teemast. Kontrollige oma teema struktuuri, et leida õige fail, mis sisaldab sulgevat </body> silti.

Alternatiivne meetod 1: Gravi varahalduri kasutamine

Gravi sisseehitatud Asset Manager pakub puhast viisi JavaScripti varade lisamiseks Twigi kaudu:

Avage oma teema Twig põhimall (nt user/themes/teieteema/templates/partials/base.html.twig)
Kasutage varahaldurit JavaScripti lisamiseks:

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

Või lisage oma põhimallile sisene JavaScript, et luua skriptielement dünaamiliselt:

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

Märkus: Asset Manageri meetod on Gravi poolt soovitatav lähenemine JavaScripti varade haldamiseks. See pakub sisseehitatud tuge varade torustiku loomiseks, järjestamiseks ja grupeerimiseks.

Alternatiivne meetod 2: kohandatud JS pistikprogrammi kasutamine

Kui eelistate pistikprogrammipõhist lähenemist ilma teemafaile muutmata:

Paigaldage "Custom JS" pistikprogramm Gravi halduspaneelilt või CLI kaudu:

bin/gpm install custom-js

Minge Admin > Plugins > Custom JS
Lisage manusskripti kood:

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

Salvestage pistikprogrammi seadistus

Vihje: Pistikprogrammi kasutamine skriptide süstimiseks tähendab, et te ei pea ühtegi teemafaili muutma. See muudab teemade vahetamise või uuendamise lihtsamaks, ilma et kaotaksite vestlusroboti integratsiooni.

Alternatiivne meetod 3: ploki ülekirjutamine alammallis

Kui teie Grav teema kasutab Twigi plokipärimist, saate alumise ploki alammallis üle kirjutada:

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

Looge või avage alammall, mis laiendab teie teema põhimalli
Lisage ülalpool näidatud ploki ülekirjutamine
Kutse parent() tagab, et kogu olemasolev sisu plokis säilib

Märkus: See meetod kasutab Twigi mallipärimise süsteemi. Veenduge, et ploki nimi (nt bottom) vastab teie teema põhimallis määratletud plokile. Levinud plokinimed on bottom, javascripts või footer.

Alternatiivne meetod 4: Gravi Custom Head pistikprogrammi kasutamine

Teine pistikprogrammipõhine valik on Custom Head pistikprogramm:

Paigaldage custom-head pistikprogramm CLI või halduspaneeli kaudu:

bin/gpm install custom-head

Minge Admin > Plugins > Custom Head
Lisage oma Asyntai manusskripti kood pistikprogrammi seadistusse:

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

Salvestage seadistus

Vihje: Custom Head pistikprogramm võimaldab süstida koodi oma saidi päise või keha jaotistesse ilma teemafaile puutumata. Kontrollige pistikprogrammi dokumentatsiooni, et leida õige paigutusvalik skripti sisestamiseks enne sulgevat </body> silti.

3. samm: Tühjendage vahemälu ja kontrollige

Pärast koodi lisamist tühjendage oma Grav vahemälu ja kontrollige paigaldust:

# Clear cache via CLI
bin/grav clearcache

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

Avage oma Grav sait uues brauseri vahekaardil. Peaksite nägema vestlusvidina nuppu alumises paremas nurgas. Klõpsake sellel, et veenduda, et see avaneb ja töötab korrektselt.

Ei näe vidinat? Veenduge, et tühjendasite Grav vahemälu käsuga bin/grav clearcache või halduspaneelilt. Kontrollige, et asendasite YOUR_WIDGET_ID oma tegeliku vidina ID-ga juhtpaneelilt. Tühjendage brauseri vahemälu või vaadake inkognito režiimis. Avage brauseri konsool (F12), et kontrollida JavaScripti vigasid. Kontrollige skripti olemasolu lehe lähtekoodis, paremklõpsates ja valides "Vaata lehe lähtekoodi".

Dokumentatsioon

Kuidas lisada Asyntai AI vestlusrobotit Gravile

1. samm: hankige oma manuskood

Samm 2: lisage Gravi teemamallile (soovitatav)

Alternatiivne meetod 1: Gravi varahalduri kasutamine

Alternatiivne meetod 2: kohandatud JS pistikprogrammi kasutamine

Alternatiivne meetod 3: ploki ülekirjutamine alammallis

Alternatiivne meetod 4: Gravi Custom Head pistikprogrammi kasutamine

3. samm: Tühjendage vahemälu ja kontrollige