Atpakaļ uz informācijas paneli

Dokumentācija

Uzziniet, kā lietot Asyntai

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

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

Iegūt iegulšanas kodu

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: Pievienošana MODX veidnei (ieteicams)

Ieteicamais veids, kā pievienot tērzēšanas robotu, ir rediģēt savu MODX veidni tieši MODX pārvaldniekā:

  1. Piesakieties savā MODX pārvaldniekā (administratora panelī)
  2. Kreisajā sānjoslā dodieties uz Elements > Templates
  3. Atveriet savas vietnes veidni (parasti saukta "BaseTemplate" vai jūsu aktīvā veidne)
  4. Atrodiet noslēdzošo </body> tagu veidnes kodā
  5. Ielīmējiet savu Asyntai iegulšanas kodu tieši pirms noslēdzošā </body> taga
  6. Noklikšķiniet uz "Save", lai saglabātu veidni
<!-- Your existing template content -->

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

Padoms: Koda pievienošana tieši pirms noslēdzošā </body> taga nodrošina, ka tērzēšanas robots tiek ielādēts pēc visa lapas satura, kas ir ieteicamais izvietojums tērzēšanas logrīkiem un nepalēninās jūsu lapas ielādi.

1. alternatīvā metode: MODX fragmenta (Chunk) izmantošana

Varat izmantot MODX Chunk, lai iegulšanas kods būtu atsevišķs un atkārtoti izmantojams:

  1. MODX pārvaldniekā dodieties uz Elements > Chunks
  2. Noklikšķiniet uz \"New Chunk\", lai izveidotu jaunu fragmentu
  3. Nosauciet fragmentu "asyntaiWidget"
  4. Ielīmējiet savu Asyntai iegulšanas kodu fragmenta satura laukā
  5. Noklikšķiniet uz "Saglabāt"
  6. Atveriet savu veidni (sadaļā Elements > Templates)
  7. Pievienojiet fragmenta izsaukumu [[$asyntaiWidget]] tieši pirms noslēdzošā </body> taga
  8. Saglabājiet veidni
<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Padoms: Fragmenta izmantošana atvieglo iegulšanas koda pārvaldību un atjaunināšanu vienā vietā, īpaši ja izmantojat vairākas veidnes savā vietnē.

2. alternatīvā metode: MODX sistēmas iestatījumu izmantošana (HTML galvene/kājene)

Dažas MODX konfigurācijas ietver vietturus kājenes skriptiem, izmantojot sistēmas iestatījumus:

  1. MODX pārvaldniekā dodieties uz System > System Settings
  2. Filtrējiet pēc "htmlhead" vai meklējiet pielāgotu sistēmas iestatījumu kājenes skriptiem
  3. Ja jūsu konfigurācijai ir vietturis kājenes skriptiem (piemēram, [[++footer_scripts]]), varat to izmantot
  4. Iestatiet sistēmas iestatījuma vērtību uz savu Asyntai iegulšanas kodu
  5. Pārliecinieties, ka atbilstošais vietturis [[++footer_scripts]] ir jūsu veidnē pirms noslēdzošā </body> taga
  6. Saglabājiet sistēmas iestatījumu
<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Piezīme: Šī metode ir atkarīga no tā, vai jūsu MODX konfigurācijai ir pielāgots sistēmas iestatījums kājenes skriptiem. Ja tāds neeksistē, varat izveidot pielāgotu sistēmas iestatījumu un atsaukties uz to savā veidnē, izmantojot [[++setting_key]] sintaksi.

3. alternatīvā metode: MODX spraudņa izmantošana (OnWebPagePrerender)

Papildu pieejā varat izveidot MODX spraudni, kas automātiski ievada tērzēšanas robota kodu katrā lapā:

  1. MODX pārvaldniekā dodieties uz Elements > Plugins
  2. Noklikšķiniet uz "New Plugin", lai izveidotu jaunu spraudni
  3. Nosauciet spraudni "AsyntaiChatbot"
  4. Ielīmējiet šādu PHP kodu spraudņa koda laukā:
$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);
  1. Noklikšķiniet uz cilnes "System Events"
  2. Atzīmējiet izvēles rūtiņu blakus "OnWebPagePrerender", lai izsauktu šo spraudni attiecīgajā notikumā
  3. Noklikšķiniet uz "Saglabāt"

Svarīgi: Aizstājiet YOUR_WIDGET_ID ar savu faktisko logrīka ID no Asyntai vadības paneļa. Šis spraudnis automātiski ievadīs tērzēšanas robota skriptu katrā jūsu MODX vietnes lapā pirms tās atveidošanas.

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

Pēc iegulšanas koda pievienošanas, izmantojot jebkuru no iepriekš minētajām metodēm, jums jāiztīra MODX kešatmiņa un jāpārbauda instalācija:

  1. MODX pārvaldniekā dodieties uz Manage > Clear Cache (vai noklikšķiniet uz kešatmiņas tīrīšanas ikonas augšējā izvēlnē)
  2. Atveriet savu tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā
  3. Lapas apakšējā labajā stūrī vajadzētu redzēt tērzēšanas logrīka pogu
  4. 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 MODX kešatmiņu no Manage > Clear Cache MODX pārvaldniekā. Mēģiniet arī notīrīt pārlūkprogrammas kešatmiņu vai skatīt vietni inkognito logā. Ja izmantojāt spraudņa metodi, pārbaudiet, vai jūsu spraudnim ir atzīmēts sistēmas notikums "OnWebPagePrerender".