Hur du lägger till Asyntai AI-chattbot i ProcessWire

Steg-för-steg-guide för ProcessWire CMS-webbplatser

Plattform:

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din Dashboard eftersom den innehåller ditt personliga widget-ID.

Steg 2: Lägg till i mallfilen (rekommenderas)

ProcessWire använder PHP-mallfiler som finns i katalogen site/templates/. Det enklaste sättet är att lägga till embed-koden direkt i din huvudmallfil:

Åtkomst till dina ProcessWire-installationsfiler via FTP, SSH eller filhanteraren
Navigera till site/templates/
Öppna din huvudmallfil — detta är ofta _main.php eller basic-page.php beroende på din webbplatsprofil
Om du använder strategin för fördröjd utdata (standard för de flesta webbplatsprofiler), öppna _main.php
Hitta den avslutande taggen </body>
Klistra in din Asyntai-inbäddningskod precis före den:

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

Tips: Att placera skriptet precis före den avslutande </body>-taggen säkerställer att chattboten laddas efter sidinnehållet, vilket rekommenderas för optimal prestanda och inte bromsar sidrendering.

Alternativ metod 1: Använda _foot.inc eller _main.php Append-fil

Om din ProcessWire-webbplats använder metoden med bifogade filer (vanlig i många webbplatsprofiler) kan du lägga till inbäddningskoden i den delade sidfotinkluderingen:

Navigera till site/templates/
Öppna _foot.inc (eller din motsvarande sidfots-include-fil)
Klistra in din Asyntai-inbäddningskod precis före den avslutande taggen </body>
Spara filen

ProcessWires fördröjda utmatningsstrategi fungerar vanligtvis med tre nyckelfiler:

_init.php — körs innan varje mall, initialiserar variabler
Din mallfil (t.ex. basic-page.php) — fyller i innehållsvariabler
_main.php — matar ut det slutliga HTML-märkspråket med dessa variabler

Om din webbplats använder det här tillvägagångssättet säkerställer du att skriptet visas på varje sida genom att lägga till det i _main.php innan </body>.

Obs! Filnamnen _init.php och _main.php konfigureras i din site/config.php via inställningarna $config->prependTemplateFile och $config->appendTemplateFile. Kontrollera din konfiguration om dina filer har andra namn.

Alternativ metod 2: Använda $config->scripts-array

ProcessWire tillhandahåller ett $config->scripts FilenameArray som du kan använda för att hantera JavaScript-filer. I din _init.php eller individuell mallfil, lägg till:

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

I din _main.php (eller sidfotsinclusion) itererar du sedan igenom skriptarrayen för att skriva ut dem:

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

Viktigt: Metoden med $config->scripts hanterar skriptets src-attribut, men attributet data-asyntai-id måste hanteras separat. Du behöver antingen lägga till dataattributet manuellt i loopresultatet eller använda metoden med direkta skripttaggar från steg 2 för den enklaste konfigurationen.

Alternativ metod 3: Använda en hook (ready.php)

För ett mer avancerat tillvägagångssätt kan du använda ProcessWires hook-system för att automatiskt injicera chattbotskriptet på varje sida. Lägg till följande i din fil 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;
});
?>

Den här hooken fångar upp den renderade HTML-utdatan från varje sida och injicerar Asyntai-skriptet precis före den avslutande </body>-taggen automatiskt.

Tips: Hook-metoden med ready.php är idealisk om du vill ha chattboten på varje sida utan att ändra några mallfiler. Den överlever också malländringar och temauppdateringar eftersom den finns utanför mallfilerna.

Steg 3: Verifiera installationen

Efter att du har sparat dina ändringar, besök din ProcessWire-webbplats i en ny webbläsarflik eller ett inkognitofönster. Du bör se widgetknappen för chatten i det nedre högra hörnet. Klicka på den för att kontrollera att den öppnas och fungerar korrekt.

Ser du inte widgeten? Se till att du sparat alla ändrade filer. Prova att rensa webbläsarens cache eller visa sidan i ett inkognitofönster. Om ProcessWires mallcache är aktiverad kan du behöva rensa den via Modules → Core → Template Engine Cache eller genom att lägga till ?nocache=1 i din URL. Kontrollera också att din mallfil faktiskt används av de sidor du visar.