Kā pievienot Asyntai MI tērzēšanas robotu Craft CMS

Soli pa solim ceļvedis Craft 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: Rediģējiet savu izkārtojuma veidni (ieteicams)

Vienkāršākais veids, kā pievienot tērzēšanas robotu visām lapām, ir rediģēt galveno izkārtojuma veidni:

Access your Craft CMS project files via FTP, SSH, or your code editor
Pārejiet uz direktoriju templates/
Atrodiet savu galveno izkārtojuma failu (parasti nosaukts _layout.twig, _layout.html vai atrodas templates/_layouts/)
Atrodiet noslēdzošo </body> tagu
Ielīmējiet savu Asyntai iegulto kodu tieši pirms </body> taga
Saglabājiet failu

Padoms: Skripta pievienošana pirms noslēdzošā </body> taga nodrošina, ka tas ielādējas pēc lapas satura, kas ir ieteicams tērzēšanas logrīkiem un nepalēninās jūsu lapas ielādi.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS nodrošina iebūvētu Twig tagu JavaScript reģistrēšanai:

Atveriet savu galveno izkārtojuma veidni
Pievienojiet šādu kodu pirms noslēdzošā </body> taga:
{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %}
Aizstājiet YOUR_WIDGET_ID ar savu reālo logrīka ID
Saglabājiet failu

Piezīme: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternatīva: Izveidojiet atsevišķu iekļaušanas failu

Labākai organizācijai izveidojiet speciālu iekļaušanas failu:

Izveidojiet jaunu failu: templates/_includes/chatbot.twig (vai .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>
Savā galvenajā izkārtojuma veidnē iekļaujiet šo failu pirms </body>:
{% include '_includes/chatbot' %}
Saglabājiet abus failus

Padoms: Iekļaušanas faila izmantošana atvieglo tērzēšanas robota iespējošanu/atspējošanu visā jūsu vietnē, komentējot vienu rindu.

Alternatīva: Nosacīta ielāde

Lai ielādētu tērzēšanas robotu tikai konkrētās lapās vai sadaļās:

Savā izkārtojuma vai lapas veidnē izmantojiet Twig nosacījumus:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Vai pārbaudiet konkrētas sadaļas:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

3. solis: Pārbaudiet instalēšanu

Pēc izmaiņu saglabāšanas apmeklējiet savu Craft CMS tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā. 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 saglabājāt veidnes failu un rediģējat pareizo izkārtojuma veidni, ko izmanto jūsu lapas. Notīriet pārlūkprogrammas kešatmiņu vai skatiet inkognito logā. Ja izmantojat veidņu kešošanu, notīriet Craft CMS kešatmiņu no vadības paneļa zem Utilītas > Notīrīt kešatmiņas.

Veidnes atrašanās vieta: Craft CMS veidņu atrašanās vietas var atšķirties atkarībā no jūsu projekta iestatījumiem. Bieži sastopamas vietas ietver templates/_layout.twig, templates/_layouts/main.twig vai templates/_base.twig. Pārbaudiet esošās veidnes, lai atrastu, kur ir definēts </body> tags.