Slik legger du til Asyntai AI-chatbot i ProcessWire

Trinn-for-trinn-guide for ProcessWire CMS-nettsteder

Plattform:

Trinn 1: Hent innbyggingskoden din

Gå først til Asyntai-dashbordet ditt og bla ned til «Innbyggingskode»-seksjonen. Kopier din unike innbyggingskode som vil se slik ut:

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

Merk: Koden ovenfor er bare et eksempel. Du må kopiere din egen unike innbyggingskode fra Dashbordet ditt, da den inneholder din personlige widget-ID.

Trinn 2: Legg til i malfil (anbefalt)

ProcessWire bruker PHP-malfiler som ligger i site/templates/-katalogen. Den enkleste tilnærmingen er å legge til innbyggingskoden direkte i hovedmalfilen din:

Få tilgang til ProcessWire-installasjonsfilene dine via FTP, SSH eller filbehandleren din
Naviger til site/templates/
Åpne hovedmalfilen din — dette er ofte _main.php eller basic-page.php avhengig av nettstedsprofilen din
Hvis du bruker forsinket utdatastrategi (standard for de fleste nettstedsprofiler), åpne _main.php
Finn den avsluttende </body>-taggen
Lim inn Asyntai-innbyggingskoden din rett før den:

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

Tips: Å plassere skriptet rett før den avsluttende </body>-taggen sikrer at chatboten lastes inn etter sideinnholdet, noe som anbefales for optimal ytelse og ikke vil bremse sidevisningen din.

Alternativ metode 1: Bruk av _foot.inc eller _main.php tilleggsfil

Hvis ProcessWire-nettstedet ditt bruker tilleggsfil-tilnærmingen (vanlig i mange nettstedsprofiler), kan du legge til innbyggingskoden i den delte bunntekstinkluderingen:

Naviger til site/templates/
Åpne _foot.inc (eller tilsvarende bunntekstinkluderingsfil)
Lim inn Asyntai-innbyggingskoden din rett før den avsluttende </body>-taggen
Lagre filen

ProcessWires forsinkede utdatastrategi fungerer vanligvis med tre nøkkelfiler:

_init.php — kjøres før hver mal, initialiserer variabler
Malfilen din (f.eks. basic-page.php) — fyller ut innholdsvariabler
_main.php — skriver ut den endelige HTML-markeringen med disse variablene

Hvis nettstedet ditt bruker denne tilnærmingen, vil det å legge til skriptet i _main.php før </body> sikre at det vises på alle sider.

Merk: Filnavnene _init.php og _main.php konfigureres i site/config.php via innstillingene $config->prependTemplateFile og $config->appendTemplateFile. Sjekk konfigurasjonen din hvis filene dine har andre navn.

Alternativ metode 2: Bruk av $config->scripts-array

ProcessWire tilbyr en $config->scripts FilenameArray som du kan bruke til å administrere JavaScript-filer. I _init.php eller den individuelle malfilen din, legg til:

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

Deretter i _main.php (eller bunntekstinkluderingen), gå gjennom skript-arrayet for å skrive dem ut:

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

Viktig: $config->scripts-tilnærmingen håndterer skriptets src-attributt, men data-asyntai-id-attributtet må håndteres separat. Du må enten legge til data-attributtet manuelt i løkkeutskriften, eller bruke den direkte skripttagg-metoden fra trinn 2 for det enkleste oppsettet.

Alternativ metode 3: Bruk av en hook (ready.php)

For en mer avansert tilnærming kan du bruke ProcessWires hook-system til å automatisk injisere chatbot-skriptet på alle sider. Legg til følgende i site/ready.php-filen din:

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

Denne hooken fanger opp den rendrede HTML-utskriften på alle sider og injiserer Asyntai-skriptet automatisk rett før den avsluttende </body>-taggen.

Tips: ready.php-hook-tilnærmingen er ideell hvis du vil ha chatboten på alle sider uten å endre noen malfiler. Den overlever også malendringer og temaoppdateringer siden den ligger utenfor malfilene.

Trinn 3: Bekreft installasjonen

Etter at du har lagret endringene, besøk ProcessWire-nettstedet ditt i en ny nettleserfane eller inkognitovindu. Du bør se chatwidget-knappen i nedre høyre hjørne. Klikk på den for å forsikre deg om at den åpnes og fungerer riktig.

Ser du ikke widgeten? Forsikre deg om at du har lagret alle endrede filer. Prøv å tømme nettleserbufferen eller se siden i et inkognitovindu. Hvis ProcessWires malbuffer er aktivert, må du kanskje tømme den ved å gå til Modules → Core → Template Engine Cache eller ved å legge til ?nocache=1 i URL-en din. Verifiser også at malfilen din faktisk brukes av sidene du ser på.