Jak přidat Asyntai AI chatbota do ProcessWire

Průvodce krok za krokem pro weby ProcessWire CMS

Platforma:

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Přidání do souboru šablony (doporučeno)

ProcessWire používá PHP soubory šablon umístěné v adresáři site/templates/. Nejjednodušší přístup je přidat vložený kód přímo do hlavního souboru šablony:

Přistupte k souborům instalace ProcessWire přes FTP, SSH nebo správce souborů
Přejděte do site/templates/
Otevřete svůj hlavní soubor šablony — obvykle je to _main.php nebo basic-page.php v závislosti na profilu webu
Pokud používáte strategii zpožděného výstupu (výchozí pro většinu profilů webu), otevřete _main.php
Najděte uzavírací značku </body>
Vložte svůj kód Asyntai těsně před něj:

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

Tip: Umístění skriptů těsně před uzavírací tag </body> zajistí, že se chatbot načte až po obsahu stránky, což je doporučeno pro optimální výkon a nezpomalí vykreslování stránky.

Alternativní metoda 1: Použití souboru _foot.inc nebo _main.php Append File

Pokud váš web ProcessWire používá přístup s připojovaným souborem (běžný u mnoha profilů webu), můžete vložený kód přidat do sdíleného include zápatí:

Přejděte do site/templates/
Otevřete _foot.inc (nebo váš ekvivalentní include soubor zápatí)
Vložte svůj vložený kód Asyntai těsně před uzavírací tag </body>
Uložte soubor

Strategie zpožděného výstupu ProcessWire typicky pracuje se třemi klíčovými soubory:

_init.php — spouští se před každou šablonou, inicializuje proměnné
Váš soubor šablony (např. basic-page.php) — naplní proměnné obsahu
_main.php — vypisuje finální HTML markup pomocí těchto proměnných

Pokud váš web používá tento přístup, přidání skriptů do _main.php před </body> zajistí, že se zobrazí na každé stránce.

Poznámka: Názvy souborů _init.php a _main.php se konfigurují ve vašem site/config.php prostřednictvím nastavení $config->prependTemplateFile a $config->appendTemplateFile. Zkontrolujte svou konfiguraci, pokud se vaše soubory jmenují jinak.

Alternativní metoda 2: Použití pole $config->scripts

ProcessWire poskytuje $config->scripts FilenameArray, které můžete použít ke správě souborů JavaScript. Ve svém _init.php nebo individuálním souborů šablony přidejte:

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

Poté ve svém _main.php (nebo include zápatí) projděte pole skriptů a vypište je:

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

Důležité: Přístup $config->scripts zpracovává atribut src skriptů, ale atribut data-asyntai-id je třeba zpracovat zvlášť. Budete muset buď přidat datový atribut ručně ve výstupu smyčky, nebo pro nejjednodušší nastavení použít metodu přímého tagu script z Kroku 2.

Alternativní metoda 3: Použití hooku (ready.php)

Pro pokročilejší přístup můžete použít systém hooků ProcessWire k automatickému vložení skriptu chatbota na každou stránku. Přidejte následující do svého souboru 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í vykreslený HTML výstup každé stránky a automaticky vloží skript Asyntai těsně před uzavírací tag </body>.

Tip: Přístup s hookem ready.php je ideální, pokud chcete chatbota na každé stránce bez úpravy jakýchkoli souborů šablon. Přežije také změny šablon a aktualizace motivů, protože existuje mimo soubory šablon.

Krok 3: Ověřte instalaci

Po uložení změn navštivte svůj web ProcessWire v nové záložce prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatovacího widgetu. Klikněte na něj a ujistěte se, že se správně otevírá a funguje.

Nevidíte widget? Ujistěte se, že jste uložili všechny upravené soubory. Zkuste vymazat mezipaměť prohlížeče nebo web zobrazit v anonymním okně. Pokud je povolena mezipaměť šablon ProcessWire, možná ji budete muset vymazat přechodem na Modules → Core → Template Engine Cache nebo přidáním ?nocache=1 do URL. Ověřte také, že soubor šablony je skutečně využíván stránkami, které si prohlížíte.