Kako dodati Asyntai AI chatbot na ProcessWire

Vodič korak po korak za ProcessWire CMS web stranice

Platforma:

Korak 1: Nabavite svoj kod za ugradnju

Prvo idite na svoju Asyntai nadzornu ploču i pomaknite se prema dolje do odjeljka "Kod za ugradnju". Kopirajte svoj jedinstveni kod za ugradnju koji će izgledati ovako:

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

Napomena: Gornji kod je samo primjer. Morate kopirati svoj vlastiti jedinstveni kod za ugradnju sa svoje Nadzorne ploče jer sadrži vaš osobni ID widgeta.

Korak 2: Dodajte u datoteku predloška (Preporučeno)

ProcessWire koristi PHP datoteke predlozaka smjestene u direktoriju site/templates/. Najlaksi pristup je dodati ugradni kod izravno u svoju glavnu datoteku predloska:

Pristupite datotekama ProcessWire instalacije putem FTP-a, SSH-a ili upravitelja datoteka
Navigirajte do site/templates/
Otvorite svoju glavnu datoteku predloska — to je cesto _main.php ili basic-page.php ovisno o profilu stranice
Ako koristite strategiju odgodenog ispisa (zadanu za vecinu profila stranica), otvorite _main.php
Pronađite zatvarajuću oznaku </body>
Zalijepite svoj Asyntai ugradni kod neposredno prije njega:

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

Savjet: Postavljanje skripte neposredno prije zavrsne oznake </body> osigurava ucitavanje chatbota nakon sadrzaja stranice, sto je preporuceno za optimalne performanse i nece usporiti prikazivanje stranice.

Alternativna metoda 1: Korištenje _foot.inc ili _main.php Append datoteke

Ako vasa ProcessWire stranica koristi pristup s datotekom za dodavanje (uobicajen u mnogim profilima stranica), mozete dodati ugradni kod u zajednicki ukljuceni podnozje:

Navigirajte do site/templates/
Otvorite _foot.inc (ili vasu ekvivalentnu datoteku za ukljucivanje podnozja)
Zalijepite svoj Asyntai ugradni kod neposredno prije zavrsne oznake </body>
Spremite datoteku

ProcessWireova strategija odgodenog ispisa obicno radi s tri kljucne datoteke:

_init.php — pokrece se prije svakog predloska, inicijalizira varijable
Vasa datoteka predloska (npr. basic-page.php) — popunjava varijable sadrzaja
_main.php — ispisuje zavrsni HTML koristeci te varijable

Ako vasa stranica koristi ovaj pristup, dodavanje skripte u _main.php prije </body> osigurava pojavljivanje na svakoj stranici.

Napomena: Nazivi datoteka _init.php i _main.php konfigurirani su u vasem site/config.php putem postavki $config->prependTemplateFile i $config->appendTemplateFile. Provjerite svoju konfiguraciju ako se vase datoteke drugacije zovu.

Alternativna metoda 2: Korištenje polja $config->scripts

ProcessWire pruza $config->scripts FilenameArray koji mozete koristiti za upravljanje JavaScript datotekama. U svom _init.php ili pojedinacnoj datoteci predloska dodajte:

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

Zatim u svom _main.php (ili ukljucivanju podnozja) prodite kroz polje skripti za njihov ispis:

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

Važno: Pristup $config->scripts obradu atribut src skripte, ali atribut data-asyntai-id treba obraditi zasebno. Morat cete ili rucno dodati atribut podataka u ispis petlje ili koristiti metodu izravne oznake skripte iz Koraka 2 za najjednostavniju postavku.

Alternativna metoda 3: Korištenje kukice (ready.php)

Za napredniji pristup mozete koristiti ProcessWireov sustav kukica za automatsko ubacivanje skripte chatbota na svaku stranicu. Dodajte sljedece u svoju datoteku 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;
});
?>

Ova kukica presrece prikazani HTML ispis svake stranice i automatski ubacuje Asyntai skriptu neposredno prije zavrsne oznake </body>.

Savjet: Pristup kukicom ready.php idealan je ako zelite chatbot na svakoj stranici bez mijenjanja datoteka predlozaka. Takoder prezivljava promjene predlozaka i azuriranja tema jer zivi izvan datoteka predlozaka.

Korak 3: Provjerite instalaciju

Nakon spremanja promjena, posjetite svoju ProcessWire stranicu u novoj kartici preglednika ili anonimnom prozoru. Trebali biste vidjeti gumb widgeta za razgovor u donjem desnom kutu. Kliknite ga kako biste provjerili otvara li se i radi li ispravno.

Ne vidite widget? Provjerite jeste li spremili sve izmijenjene datoteke. Pokusajte ocistiti predmemoriju preglednika ili pregledavati u anonimnom prozoru. Ako je omogucena predmemorija predlozaka ProcessWirea, mozda je trebate ocistiti odlaskom na Modules → Core → Template Engine Cache ili dodavanjem ?nocache=1 u URL. Takoder potvrdite da vasu datoteku predloska stvarno koriste stranice koje pregledavate.