Kako dodati klepetalnik Asyntai AI v ProcessWire

Vodič po korakih za spletna mesta ProcessWire CMS

Platforma:

Korak 1: Pridobite svojo vdelovalno kodo

Najprej pojdite na svojo Nadzorno ploščo Asyntai in se pomaknite navzdol do razdelka "Vdelovalna koda". Kopirajte svojo edinstveno vdelovalno kodo, ki bo videti takole:

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

Opomba: Zgornja koda je le primer. Svojo edinstveno vdelovalno kodo morate kopirati iz svoje Nadzorne plošče, saj vsebuje vaš osebni ID klepetalnika.

Korak 2: Dodajte v datoteko predloge (priporočeno)

ProcessWire uporablja datoteke predlog PHP, ki se nahajajo v imeniku site/templates/. Najlažji pristop je dodajanje vdelane kode neposredno v vašo glavno datoteko predloge:

Dostopite do datotek svoje namestitve ProcessWire prek FTP, SSH ali upravitelja datotek
Pojdite do site/templates/
Odprite svojo glavno datoteko predloge — to je pogosto _main.php ali basic-page.php, odvisno od profila vašega spletnega mesta
Če uporabljate strategijo zakasnjenega izpisa (privzeto za večino profilov spletnih mest), odprite _main.php
Poiščite zaključno oznako </body>
Prilepite svojo vdelano kodo Asyntai tik pred njo:

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

Nasvet: Umestitev skripte tik pred zaključno oznako </body> zagotavlja, da se klepetalnik naloži po vsebini strani, kar je priporočeno za optimalno zmogljivost in ne bo upočasnilo upodabljanja vaše strani.

Alternativni način 1: Uporaba datoteke _foot.inc ali _main.php za dodajanje

Če vaše spletno mesto ProcessWire uporablja pristop z datoteko za dodajanje (pogost v številnih profilih spletnih mest), lahko dodate vdelano kodo v skupni vkljucek noge:

Pojdite do site/templates/
Odprite _foot.inc (ali svojo enakovredno datoteko vkljucka noge)
Prilepite svojo vdelano kodo Asyntai tik pred zaključno oznako </body>
Shranite datoteko

Strategija zakasnjenega izpisa ProcessWire običajno deluje s tremi ključnimi datotekami:

_init.php — se zažene pred vsako predlogo, inicializira spremenljivke
Vaša datoteka predloge (npr. basic-page.php) — napolni spremenljivke vsebine
_main.php — izpiše končno oznacbo HTML z uporabo teh spremenljivk

Če vaše spletno mesto uporablja ta pristop, dodajanje skripte v _main.php pred </body> zagotavlja, da se prikaže na vsaki strani.

Opomba: Imena datotek _init.php in _main.php so konfigurirana v vašem site/config.php prek nastavitev $config->prependTemplateFile in $config->appendTemplateFile. Preverite svojo konfiguracijo, če imajo vaše datoteke drugacna imena.

Alternativni način 2: Uporaba polja $config->scripts

ProcessWire zagotavlja polje $config->scripts FilenameArray, ki ga lahko uporabite za upravljanje datotek JavaScript. V svojem _init.php ali posamezni datoteki predloge dodajte:

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

Nato v svojem _main.php (ali vkljucku noge) preglejte polje skript za njihov izpis:

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

Pomembno: Pristop $config->scripts obravnava atribut src skripte, vendar je treba atribut data-asyntai-id obravnavati loceno. Morali boste bodisi rocno dodati podatkovni atribut v izpis zanke ali pa za najpreprostejšo nastavitev uporabiti način z neposredno oznako skripte iz koraka 2.

Alternativni način 3: Uporaba kavlja (ready.php)

Za naprednejši pristop lahko uporabite sistem kavljev ProcessWire za samodejno vstavljanje skripte klepetalnika na vsako stran. Dodajte naslednje v svojo datoteko site/ready.php:

<?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;
});
?>

Ta kavelj prestreže upodobljeni izhod HTML vsake strani in samodejno vstavi skripto Asyntai tik pred zaključno oznako </body>.

Nasvet: Pristop s kavljem ready.php je idealen, če želite klepetalnik na vsaki strani, ne da bi spreminjali kakršne koli datoteke predlog. Preživi tudi spremembe predlog in posodobitve tem, saj obstaja zunaj datotek predlog.

Korak 3: Preverite namestitev

Po shranjevanju sprememb obiščite svoje spletno mesto ProcessWire v novem zavihku brskalnika ali oknu brez beleženja. V spodnjem desnem kotu bi morali videti gumb pripomocka za klepet. Kliknite nanj, da se prepričajte, da se odpre in pravilno deluje.

Ne vidite klepetalnika? Prepričajte se, da ste shranili vse spremenjene datoteke. Poskusite pocistiti predpomnilnik brskalnika ali stran ogledati v oknu brez beleženja. Če je predpomnjenje predlog ProcessWire omogoceno, ga boste morda morali pocistiti tako, da pojdete na Moduli → Jedro → Predpomnilnik mehanizma predlog ali tako, da dodate ?nocache=1 k svojemu URL-ju. Preverite tudi, da vaše datoteke predloge dejansko uporabljajo strani, ki si jih ogledujete.