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

Soli pa solim ceļvedis ProcessWire 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: Pievienošana veidnes failam (ieteicams)

ProcessWire izmanto PHP veidņu failus, kas atrodas direktorijā site/templates/. Vienkāršākā pieeja ir pievienot iegulšanas kodu tieši savam galvenajam veidnes failam:

Piekļūstiet saviem ProcessWire instalācijas failiem, izmantojot FTP, SSH vai failu pārvaldnieku
Dodieties uz site/templates/
Atveriet savu galveno veidnes failu — tas bieži ir _main.php vai basic-page.php atkarībā no jūsu vietnes profila
Ja izmantojat aizkavētas izvades stratēģiju (noklusējums lielākajai daļai vietņu profilu), atveriet _main.php
Atrodiet noslēdzošo </body> tagu
Ielīmējiet savu Asyntai iegulšanas kodu tieši pirms tā:

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

Padoms: Skripta ievietošana tieši pirms noslēdzošā </body> taga nodrošina, ka tērzēšanas robots tiek ielādēts pēc lapas satura, kas ir ieteicams optimālai veiktspējai un nepalēninās jūsu lapas atveidošanu.

Alternatīvā metode 1: _foot.inc vai _main.php pievienošanas faila izmantošana

Ja jūsu ProcessWire vietne izmanto pievienošanas faila pieeju (izplatīta daudzos vietņu profilos), varat pievienot iegulšanas kodu kopīgajai kājenes iekļaušanai:

Dodieties uz site/templates/
Atveriet _foot.inc (vai jūsu ekvivalento kājenes iekļaušanas failu)
Ielīmējiet savu Asyntai iegulšanas kodu tieši pirms noslēdzošā </body> taga
Saglabājiet failu

ProcessWire aizkavētas izvades stratēģija parasti darbojas ar trim galvenajiem failiem:

_init.php — tiek palaists pirms katras veidnes, inicializē mainīgos
Jūsu veidnes fails (piem., basic-page.php) — aizpilda satura mainīgos
_main.php — izvada galīgo HTML iezīmējumu, izmantojot šos mainīgos

Ja jūsu vietne izmanto šo pieeju, skripta pievienošana failam _main.php pirms </body> nodrošina, ka tas parādās katrā lapā.

Piezīme: Failu nosaukumi _init.php un _main.php ir konfigurēti jūsu site/config.php failā, izmantojot iestatījumus $config->prependTemplateFile un $config->appendTemplateFile. Pārbaudiet savu konfigurāciju, ja jūsu faili ir nosaukti citādi.

2. alternatīvā metode: $config->scripts masīva izmantošana

ProcessWire nodrošina $config->scripts FilenameArray, ko varat izmantot JavaScript failu pārvaldīšanai. Savā _init.php vai individuālajā veidnes failā pievienojiet:

<?php
$config->scripts->add('https://asyntai.com/static/js/chat-widget.js');
?>

Pēc tam savā _main.php (vai kājenes iekļaušanā) izejiet cauri skriptu masīvam, lai tos izvadītu:

<?php foreach($config->scripts as $file): ?>
<script src="<?php echo $file; ?>"></script>
<?php endforeach; ?>

Svarīgi: Pieeja $config->scripts apstrādā skripta src atribūtu, bet atribūts data-asyntai-id ir jāapstrādā atsevišķi. Jums būs vai nu manuāli jāpievieno datu atribūts cilpas izvadē, vai vienkāršākajam iestatījumam jāizmanto tiešā skripta taga metode no 2. soļa.

3. alternatīvā metode: Āķa izmantošana (ready.php)

Progresīvākai pieejai varat izmantot ProcessWire āķu sistēmu, lai automātiski ievadītu tērzēšanas robota skriptu katrā lapā. Pievienojiet šo savam site/ready.php failam:

<?php
$wire->addHookAfter('Page::render', function(HookEvent $event) {
    $html = $event->return;
    $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
    $html = str_replace('</body>', $script . '</body>', $html);
    $event->return = $html;
});
?>

Šis āķis pārtver katras lapas atveidoto HTML izvadi un automātiski ievada Asyntai skriptu tieši pirms noslēdzošā </body> taga.

Padoms: Pieeja ar ready.php āķi ir ideāla, ja vēlaties tērzēšanas robotu katrā lapā, nemodificējot nevienu veidnes failu. Tā arī saglabājas pēc veidņu izmaiņām un tēmu atjauninājumiem, jo atrodas ārpus veidņu failiem.

3. solis: Pārbaudiet instalēšanu

Pēc izmaiņu saglabāšanas apmeklējiet savu ProcessWire 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 saglabājis visus modificētos failus. Mēģiniet notīrīt pārlūkprogrammas kešatmiņu vai skatīt inkognito logā. Ja ProcessWire veidņu kešatmiņa ir iespējota, iespējams, to vajadzēs iztīrīt, dodoties uz Modules → Core → Template Engine Cache vai pievienojot ?nocache=1 savam URL. Pārbaudiet arī, vai jūsu veidnes failu patiešām izmanto lapas, kuras skatāt.