Kuidas lisada Asyntai AI vestlusrobotit ProcessWire'ile

Samm-sammuline juhend ProcessWire CMS-i veebisaitide jaoks

Platvorm:

1. samm: hankige oma manuskood

Esmalt minge oma Asyntai juhtpaneelile ja kerige alla jaotiseni "Manuskood". Kopeerige oma unikaalne manuskood, mis näeb välja selline:

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

Märkus: Ülalolev kood on vaid näide. Peate kopeerima oma unikaalse manuskoodi oma juhtpaneelilt, kuna see sisaldab teie isiklikku vidina ID-d.

Samm 2: lisage mallifaili (soovitatav)

ProcessWire kasutab PHP malli faile, mis asuvad kataloogis site/templates/. Lihtsaim lähenemine on lisada manuskood otse oma peamisse malli faili:

Juurdepääs oma ProcessWire'i paigalduse failidele FTP, SSH või failihalduri kaudu
Navigeerige kausta site/templates/
Avage oma peamine malli fail — see on sageli _main.php või basic-page.php sõltuvalt teie saidi profiilist
Kui kasutate viivitatud väljundi strateegiat (vaikimisi enamiku saidiprofiilide puhul), avage _main.php
Leidke sulgev </body> silt
Kleepige oma Asyntai manuskood vahetult enne seda:

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

Vihje: Skripti paigutamine vahetult enne sulgevat </body> märgendit tagab, et vestlusrobot laadib pärast lehe sisu, mis on soovitatav optimaalse jõudluse tagamiseks ega aeglusta teie lehe renderdamist.

Alternatiivne meetod 1: _foot.inc või _main.php lisamisfaili kasutamine

Kui teie ProcessWire'i sait kasutab lisamisfaili lähenemist (levinud paljudes saidiprofiilides), saate lisada manuskoodi jagatud jaluse kaasamisesse:

Navigeerige kausta site/templates/
Avage _foot.inc (või teie vastav jaluse kaasamisefail)
Kleepige oma Asyntai manuskood vahetult enne sulgevat </body> märgendit
Salvestage fail

ProcessWire'i viivitatud väljundi strateegia töötab tavaliselt kolme põhifailiga:

_init.php — käivitub enne igat malli, lähtestab muutujad
Teie malli fail (nt basic-page.php) — täidab sisu muutujad
_main.php — väljastab lõpliku HTML-märgistuse nende muutujate abil

Kui teie sait kasutab seda lähenemist, tagab skripti lisamine faili _main.php enne </body>, et see ilmub igale lehele.

Märkus: Failinimed _init.php ja _main.php on konfigureeritud teie failis site/config.php seadete $config->prependTemplateFile ja $config->appendTemplateFile kaudu. Kontrollige oma konfiguratsiooni, kui teie failid on teistmoodi nimetatud.

Alternatiivne meetod 2: $config->scripts massiivi kasutamine

ProcessWire pakub $config->scripts FilenameArray'd, mida saate kasutada JavaScripti failide haldamiseks. Oma failis _init.php või üksikus malli failis lisage:

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

Seejärel oma failis _main.php (või jaluse kaasamisefailis) käige skriptide massiiv läbi nende väljastamiseks:

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

Oluline: $config->scripts lähenemine haldab skripti src atribuuti, kuid data-asyntai-id atribuuti tuleb hallata eraldi. Peate kas lisama andmeatribuudi käsitsi tsükli väljundisse või kasutama lihtsaima seadistuse jaoks 2. sammu otsest skriptimärgendi meetodit.

Alternatiivne meetod 3: konksu kasutamine (ready.php)

Täpsema lähenemise jaoks saate kasutada ProcessWire'i konksusüsteemi vestlusroboti skripti automaatseks süstimiseks igale lehele. Lisage järgmine oma faili 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;
});
?>

See konks peatab iga lehe renderdatud HTML-väljundi ja süstib Asyntai skripti automaatselt vahetult enne sulgevat </body> märgendit.

Vihje: ready.php konksu lähenemine on ideaalne, kui soovite vestlusrobotit igale lehele ilma ühegi malli faili muutmiseta. See säilib ka malli muudatuste ja teema uuenduste ajal, kuna asub malli failidest väljaspool.

3. samm: kontrollige paigaldust

Pärast muudatuste salvestamist külastage oma ProcessWire'i saiti uuel brauseri vahekaardil või inkognito aknas. Peaksite nägema vestlusvidina nuppu paremas alanurgas. Klõpsake sellel, et veenduda selle avamises ja korrektses toimimises.

Ei näe vidinat? Veenduge, et salvestasite kõik muudetud failid. Proovige tühjendada brauseri vahemälu või vaadata inkognito aknas. Kui ProcessWire'i malli vahemälu on lubatud, peate võib-olla selle tühjendama, minnes jaotisesse Moodulid → Tuumik → Malli mootori vahemälu või lisades oma URL-ile ?nocache=1. Veenduge ka, et teie malli fail on tegelikult kasutusel lehtedel, mida vaatate.