Kaip pridėti Asyntai AI pokalbių robotą prie ProcessWire

Žingsnis po žingsnio vadovas ProcessWire CMS svetainėms

Platforma:

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

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

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: Pridėjimas prie šablono failo (rekomenduojama)

ProcessWire naudoja PHP šablonų failus, esančius site/templates/ kataloge. Paprasčiausias būdas yra pridėti įterpimo kodą tiesiogiai prie savo pagrindinio šablono failo:

Pasiekite savo ProcessWire diegimo failus per FTP, SSH arba failų tvarkyklę
Eikite į site/templates/
Atidarykite savo pagrindinį šablono failą — tai dažnai būna _main.php arba basic-page.php, priklausomai nuo jūsų svetainės profilio
Jei naudojate atidėto išvesties strategiją (numatytąją daugumai svetainių profilių), atidarykite _main.php
Raskite uždaromąją </body> žymą
Įklijuokite savo Asyntai įterpimo kodą prieš pat jį:

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

Patarimas: Scenarijaus patalpinimas prieš pat uždaromąjį </body> žymą užtikrina, kad pokalbių robotas įkeliamas po puslapio turinio, kas rekomenduojama optimaliam našumui ir nesulėtins puslapio atvaizdavimo.

Alternatyvus metodas 1: _foot.inc arba _main.php pridėjimo failo naudojimas

Jei jūsų ProcessWire svetainė naudoja pridėjimo failo metodą (įprastą daugelyje svetainių profilių), galite pridėti įterpimo kodą prie bendros poraštės įtraukimo:

Eikite į site/templates/
Atidarykite _foot.inc (arba lygiavertį poraštės įtraukimo failą)
Įklijuokite savo Asyntai įterpimo kodą prieš pat uždaromąjį </body> žymą
Išsaugokite failą

ProcessWire atidėto išvesties strategija paprastai veikia su trimis pagrindiniais failais:

_init.php — paleidžiamas prieš kiekvieną šabloną, inicializuoja kintamuosius
Jūsų šablono failas (pvz., basic-page.php) — užpildo turinio kintamuosius
_main.php — išveda galutinį HTML žymėjimą naudodamas tuos kintamuosius

Jei jūsų svetainė naudoja šį metodą, scenarijaus pridėjimas prie _main.php prieš </body> užtikrina, kad jis bus rodomas kiekviename puslapyje.

Pastaba: Failų pavadinimai _init.php ir _main.php yra sukonfigūruoti jūsų site/config.php per $config->prependTemplateFile ir $config->appendTemplateFile nustatymus. Patikrinkite savo konfigūraciją, jei jūsų failai pavadinti kitaip.

Alternatyvus metodas 2: $config->scripts masyvo naudojimas

ProcessWire suteikia $config->scripts FilenameArray, kurį galite naudoti JavaScript failams valdyti. Savo _init.php arba individualiame šablono faile pridėkite:

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

Tada savo _main.php (arba poraštės įtraukime) pereikite per scenarijų masyvą, kad juos išvestumėte:

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

Svarbu: $config->scripts metodas tvarko scenarijaus src atributą, tačiau data-asyntai-id atributas turi būti tvarkomas atskirai. Turėsite arba pridėti duomenų atributą rankiniu būdu ciklo išvestyje, arba naudoti tiesioginį script žymos metodą iš 2 žingsnio paprasčiausiam nustatymui.

Alternatyvus metodas 3: kabliuko (ready.php) naudojimas

Pažangesniam metodui galite naudoti ProcessWire kabliukų sistemą, kad automatiškai įterptumėte pokalbių roboto scenarijų į kiekvieną puslapį. Pridėkite šį kodą prie savo site/ready.php failo:

<?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 kabliukas perima kiekvieno puslapio atvaizduotą HTML išvestį ir automatiškai įterpia Asyntai scenarijų prieš pat uždaromąjį </body> žymą.

Patarimas: ready.php kabliuko metodas yra idealus, jei norite pokalbių roboto kiekviename puslapyje nekeisdami jokių šablonų failų. Jis taip pat išlieka po šablonų pakeitimų ir temos atnaujinimų, nes yra už šablonų failų ribų.

3 žingsnis: Patikrinkite diegimą

Išsaugoję pakeitimus, apsilankykite savo ProcessWire svetainėje naujame naršyklės skirtuke arba inkognito lange. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai.

Nematote valdiklio? Įsitikinkite, kad išsaugojote visus modifikuotus failus. Pabandykite išvalyti naršyklės talpyklą arba peržiūrėti inkognito lange. Jei ProcessWire šablonų talpykla yra įjungta, gali tekti ją išvalyti einant į Modules → Core → Template Engine Cache arba pridedant ?nocache=1 prie URL. Taip pat patikrinkite, ar jūsų šablono failą tikrai naudoja peržiūrimi puslapiai.