Az Asyntai AI Chatbot hozzáadása a ProcessWire-hez

Lépésről lépésre útmutató a ProcessWire CMS weboldalakhoz

Platform:

1. lépés: Szerezze be a beágyazási kódját

Először lépjen az Asyntai Irányítópultra és görgessen le a „Beágyazási kód" szekcióhoz. Másolja le az egyedi beágyazási kódját, amely így fog kinézni:

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

Megjegyzés: A fenti kód csak egy példa. Le kell másolnia saját egyedi beágyazási kódját az Irányítópultról, mivel az tartalmazza személyes widget-azonosítóját.

2. lépés: Hozzáadás a sablonfájlhoz (ajánlott)

A ProcessWire a site/templates/ könyvtárban található PHP sablonfájlokat használja. A legegyszerűbb megközelítés a beágyazó kód közvetlen hozzáadása a fő sablonfájlhoz:

Nyissa meg a ProcessWire telepítési fájlokat FTP-n, SSH-n vagy a fájlkezelőn keresztül
Navigáljon a site/templates/ könyvtárhoz
Nyissa meg a fő sablonfájlt — ez általában _main.php vagy basic-page.php az oldalprofiltól függően
Ha a késleltetett kimeneti stratégiát használja (a legtöbb oldalprofil alapértelmezése), nyissa meg a _main.php fájlt
Keresse meg a záró </body> taget
Illessze be az Asyntai beágyazó kódját közvetlenül elé:

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

Tipp: A szkript elhelyezése közvetlenül a záró </body> tag elé biztosítja, hogy a chatbot az oldal tartalma után töltődjön be, ami az optimális teljesítmény érdekében ajánlott, és nem lassítja az oldal megjelenítését.

Alternatív módszer 1: _foot.inc vagy _main.php hozzáfűzési fájl használata

Ha a ProcessWire webhelye a hozzáfűzési fájl megközelítést alkalmazza (sok oldalprofil esetén megszokott), hozzáadhatja a beágyazó kódot a megosztott lábléc include-hoz:

Navigáljon a site/templates/ könyvtárhoz
Nyissa meg a _foot.inc fájlt (vagy az ezzel egyenértékű lábléc include fájlt)
Illessze be az Asyntai beágyazási kódot közvetlenül a záró </body> tag elé
Mentse el a fájlt

A ProcessWire késleltetett kimeneti stratégiája általában három kulcsfájllal működik:

_init.php — minden sablon előtt fut, inicializálja a változókat
Az Ön sablonfájlja (pl. basic-page.php) — feltölti a tartalomváltozókat
_main.php — kiadja a végső HTML-kódot ezekkel a változókkal

Ha a webhelye ezt a megközelítést alkalmazza, a szkript _main.php fájlhoz való hozzáadása a </body> elé biztosítja, hogy minden oldalon megjelenjen.

Megjegyzés: Az _init.php és _main.php fájlneveket a site/config.php fájlban a $config->prependTemplateFile és $config->appendTemplateFile beállításokon keresztül konfigurálják. Ellenőrizze a konfigurációt, ha a fájljai eltérő névvel rendelkeznek.

Alternatív módszer 2: $config->scripts tömb használata

A ProcessWire biztosít egy $config->scripts FilenameArray-t, amelyet JavaScript fájlok kezelésére használhat. Az _init.php fájlban vagy az egyedi sablonfájlban adja hozzá:

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

Ezután a _main.php fájlban (vagy a lábléc include-ban) iteráljon végig a szkripttömbön a kimenethez:

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

Fontos: A $config->scripts megközelítés kezeli a szkript src attribútumát, de a data-asyntai-id attribútumot külön kell kezelni. A ciklusos kimenetnél manuálisan kell hozzáadnia az adatattribútumot, vagy a legegyszerűbb beállításhoz a 2. lépés közvetlen szkripttag módszerét kell használnia.

Alternatív módszer 3: Hook használata (ready.php)

Haladóbb megközelítéshez a ProcessWire hook rendszerét használhatja a chatbot szkript automatikus beillesztéséhez minden oldalra. Adja hozzá a következőket a site/ready.php fájlhoz:

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

Ez a hook elfogja minden oldal megjelenített HTML kimenetét, és automatikusan beilleszti az Asyntai szkriptet közvetlenül a záró </body> tag elé.

Tipp: A ready.php hook megközelítés ideális, ha minden oldalon szeretné a chatbotot sablonfájlok módosítása nélkül. Ez az eljárás megmarad a sablon- és témafrissítések után is, mivel a sablonfájlokon kívül helyezkedik el.

3. lépés: Telepítés ellenőrzése

A változtatások mentése után látogassa meg a ProcessWire weboldalát egy új böngészőlapon vagy inkognító ablakban. A jobb alsó sarokban meg kell jelennie a chat widget gombnak. Kattintson rá, hogy megbizonyosodjon arról, hogy megnyílik és megfelelően működik.

Nem látja a widgetet? Győződjön meg róla, hogy minden módosított fájlt mentett. Próbálja meg törölni a böngészőgyorsítótárat, vagy tekintse meg inkognító ablakban. Ha a ProcessWire sablongyorsítótára engedélyezve van, előfordulhat, hogy törölnie kell a Modulok → Mag → Sablonmotor gyorsítótár menüponton keresztül, vagy a ?nocache=1 hozzáadásával az URL-hez. Ellenőrizze azt is, hogy a sablonfájlt valóban a megtekintett oldalak használják-e.