Ako pridať Asyntai AI Chatbot do ProcessWire

Podrobný návod pre webové stránky ProcessWire CMS

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

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

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Pridanie do súboru šablóny (Odporúčané)

ProcessWire používa PHP súbory šablón umiestnené v adresári site/templates/. Najjednoduchší prístup je pridať vkladací kód priamo do vášho hlavného súboru šablóny:

Pristúpte k súborom inštalácie ProcessWire cez FTP, SSH alebo správcu súborov
Prejdite na site/templates/
Otvorte svoj hlavný súbor šablóny — zvyčajne je to _main.php alebo basic-page.php v závislosti od profilu vášho webu
Ak používate stratégiu oneskoreného výstupu (predvolená pre väčšinu profilov webov), otvorte _main.php
Nájdite uzatvárací tag </body>
Vložte svoj vkladací kód Asyntai tesne pred ňu:

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

Tip: Umiestnenie skriptu tesne pred uzatváraciu značku </body> zabezpečuje, že sa chatbot načíta po obsahu stránky, čo sa odporúča pre optimálny výkon a nespomalí vykresľovanie vašej stránky.

Alternatívna metóda 1: Použitie súboru _foot.inc alebo _main.php Append File

Ak váš web ProcessWire používa prístup prídavného súboru (bežný v mnohých profiloch webov), môžete pridať vkladací kód do zdieľaného zahrnutia pätičky:

Prejdite na site/templates/
Otvorte _foot.inc (alebo váš ekvivalentný súbor zahrnutia pätičky)
Vložte svoj vkladací kód Asyntai tesne pred uzatváraciu značku </body>
Uložte súbor

Stratégia oneskoreného výstupu ProcessWire zvyčajne pracuje s troma kľúčovými súbormi:

_init.php — spúšťa sa pred každou šablónou, inicializuje premenné
Váš súbor šablóny (napr. basic-page.php) — napĺňa premenné obsahu
_main.php — vytvára finálne HTML označenie pomocou týchto premenných

Ak váš web používa tento prístup, pridanie skriptu do _main.php pred </body> zabezpečuje, že sa zobrazí na každej stránke.

Poznámka: Názvy súborov _init.php a _main.php sú konfigurované vo vašom site/config.php cez nastavenia $config->prependTemplateFile a $config->appendTemplateFile. Skontrolujte svoju konfiguráciu, ak sú vaše súbory pomenované inak.

Alternatívna metóda 2: Pomocou poľa $config->scripts

ProcessWire poskytuje pole FilenameArray $config->scripts, ktoré môžete použiť na správu JavaScript súborov. Vo vašom _init.php alebo individuálnom súbore šablóny pridajte:

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

Potom vo vašom _main.php (alebo zahrnutí pätičky) prechádzajte cyklom cez pole skriptov a vypíšte ich:

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

Dôležité: Prístup $config->scripts spracováva atribút src skriptu, ale atribút data-asyntai-id je potrebné spracovať samostatne. Budete musieť buď pridať dátový atribút manuálne vo výstupe cyklu, alebo použiť metódu priamej značky script z Kroku 2 pre najjednoduchšie nastavenie.

Alternatívna metóda 3: Pomocou hooku (ready.php)

Pre pokročilejší prístup môžete použiť systém hookov ProcessWire na automatické vloženie skriptu chatbota na každú stránku. Pridajte nasledujúce do svojho súboru 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;
});
?>

Tento hook zachytáva vykreslený HTML výstup každej stránky a automaticky vkladá skript Asyntai tesne pred uzatváraciu značku </body>.

Tip: Prístup hooku ready.php je ideálny, ak chcete chatbota na každej stránke bez úpravy akýchkoľvek súborov šablón. Tiež prežije zmeny šablón a aktualizácie tém, keďže sa nachádza mimo súborov šablón.

Krok 3: Overenie inštalácie

Po uložení zmien navštívte svoj web ProcessWire v novej záložke prehliadača alebo v okne inkognito. V pravom dolnom rohu by ste mali vidieť tlačidlo chatového widgetu. Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne.

Nevidíte widget? Uistite sa, že ste uložili všetky upravené súbory. Skúste vymazať vyrovnávaciu pamäť prehliadača alebo zobraziť stránku v okne inkognito. Ak je povolená vyrovnávacia pamäť šablón ProcessWire, možno ju budete musieť vymazať prejdením na Modules → Core → Template Engine Cache alebo pridaním ?nocache=1 do vašej URL. Tiež overte, že súbor šablóny, ktorý zobrazujete, sa skutočne používa na stránkach.