Sådan tilføjer du Asyntai AI-chatbot til ProcessWire

Trin-for-trin vejledning til ProcessWire CMS-websteder

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Tilføj til skabelonfil (anbefalet)

ProcessWire bruger PHP-skabelonfiler placeret i mappen site/templates/. Den nemmeste metode er at tilføje indlejringskoden direkte til din primære skabelonfil:

Få adgang til dine ProcessWire-installationsfiler via FTP, SSH eller din filhåndtering
Naviger til site/templates/
Åbn din primære skabelonfil — dette er ofte _main.php eller basic-page.php afhængigt af din webstedsprofil
Hvis du bruger forsinket outputstrategi (standarden for de fleste webstedsprofiler), skal du åbne _main.php
Find det afsluttende </body>-tag
Indsæt din Asyntai-indlejringskode lige før det:

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

Tip: Placering af scriptet lige før det afsluttende </body>-tag sikrer, at chatbotten indlæses efter sideindholdet, hvilket anbefales for optimal ydeevne og ikke vil bremse din sidegenerering.

Alternativ metode 1: Brug af _foot.inc eller _main.php tilføjelsesfil

Hvis dit ProcessWire-websted bruger tilgangen med tilføjelsesfiler (almindelig i mange webstedsprofiler), kan du tilføje indlejringskoden til den delte sidefodsinddragelse:

Naviger til site/templates/
Åbn _foot.inc (eller din tilsvarende sidefods-inddragelsesfil)
Indsæt din Asyntai-indlejringskode lige før det afsluttende </body>-tag
Gem filen

ProcessWires forsinkede outputstrategi fungerer typisk med tre nøglefiler:

_init.php — køres før hver skabelon, initialiserer variabler
Din skabelonfil (f.eks. basic-page.php) — udfylder indholdsvariabler
_main.php — genererer den endelige HTML-opmærkning ved hjælp af disse variabler

Hvis dit websted bruger denne tilgang, sikrer tilføjelse af scriptet til _main.php før </body>, at det vises på hver side.

Bemærk: Filnavnene _init.php og _main.php er konfigureret i din site/config.php via indstillingerne $config->prependTemplateFile og $config->appendTemplateFile. Tjek din konfiguration, hvis dine filer har andre navne.

Alternativ metode 2: Brug af $config->scripts-array

ProcessWire tilbyder et $config->scripts FilenameArray, som du kan bruge til at administrere JavaScript-filer. Tilføj følgende i din _init.php eller individuelle skabelonfil:

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

Derefter gennemløber du scripts-arrayet i din _main.php (eller sidefodsinddragelse) for at generere dem:

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

Vigtigt: $config->scripts-tilgangen håndterer script-attributten src, men data-asyntai-id-attributten skal håndteres separat. Du skal enten tilføje dataattributten manuelt i løkkens output eller bruge den direkte script-tag-metode fra trin 2 for den enkleste opsætning.

Alternativ metode 3: Brug af en hook (ready.php)

For en mere avanceret tilgang kan du bruge ProcessWires hook-system til automatisk at injicere chatbot-scriptet på hver side. Tilføj følgende til din site/ready.php-fil:

<?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 hook opfanger det renderede HTML-output fra hver side og injicerer automatisk Asyntai-scriptet lige før det afsluttende </body>-tag.

Tip: ready.php-hook-tilgangen er ideel, hvis du ønsker chatbotten på hver side uden at ændre nogen skabelonfiler. Den overlever også skabelonændringer og temaopdateringer, da den lever uden for skabelonfilerne.

Trin 3: Verificér installationen

Efter at have gemt dine ændringer, besøg dit ProcessWire-websted i en ny browserfane eller inkognitovindue. Du bør se chat-widget-knappen i nederste højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for, at du har gemt alle ændrede filer. Prøv at rydde browsercachen eller se siden i et inkognitovindue. Hvis ProcessWires skabeloncache er aktiveret, skal du muligvis rydde den ved at gå til Modules → Core → Template Engine Cache eller ved at tilføje ?nocache=1 til din URL. Bekræft også, at din skabelonfil faktisk bruges af de sider, du ser.