Hoe voegt u de Asyntai AI-chatbot toe aan ProcessWire

Stapsgewijze handleiding voor ProcessWire CMS-websites

Platform:

Stap 1: Uw insluitcode ophalen

Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:

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

Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.

Stap 2: Toevoegen aan templatebestand (aanbevolen)

ProcessWire gebruikt PHP-templatebestanden in de map site/templates/. De eenvoudigste aanpak is de insluitcode rechtstreeks toe te voegen aan uw hoofd-templatebestand:

Open uw ProcessWire-installatiebestanden via FTP, SSH of uw bestandsbeheer
Navigeer naar site/templates/
Open uw hoofd-templatebestand — dit is vaak _main.php of basic-page.php afhankelijk van uw siteprofiel
Als u de delayed output strategy gebruikt (de standaard voor de meeste siteprofielen), open dan _main.php
Zoek de afsluitende </body>-tag
Plak uw Asyntai-insluitcode er net vóór:

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

Tip: Het plaatsen van het script net vóór de afsluitende </body>-tag zorgt ervoor dat de chatbot wordt geladen na de pagina-inhoud, wat wordt aanbevolen voor optimale prestaties en uw paginaweergave niet vertraagt.

Alternatieve methode 1: _foot.inc of _main.php-toevoegbestand gebruiken

Als uw ProcessWire-site de bijlagebestandsaanpak gebruikt (gebruikelijk in veel siteprofielen), kunt u de insluitcode toevoegen aan de gedeelde voettekst-include:

Navigeer naar site/templates/
Open _foot.inc (of uw equivalente voettekst-include-bestand)
Plak uw Asyntai-insluitcode net voor de afsluitende </body>-tag
Sla het bestand op

De delayed output strategy van ProcessWire werkt doorgaans met drie hoofdbestanden:

_init.php — wordt uitgevoerd vóór elke template, initialiseert variabelen
Uw templatebestand (bijv. basic-page.php) — vult inhoudsvariabelen
_main.php — geeft de uiteindelijke HTML-opmaak weer met deze variabelen

Als uw site deze aanpak gebruikt, zorgt het toevoegen van het script aan _main.php vóór </body> ervoor dat het op elke pagina verschijnt.

Opmerking: De bestandsnamen _init.php en _main.php worden geconfigureerd in uw site/config.php via de instellingen $config->prependTemplateFile en $config->appendTemplateFile. Controleer uw configuratie als uw bestanden anders zijn benoemd.

Alternatieve methode 2: De $config->scripts-array gebruiken

ProcessWire biedt een $config->scripts FilenameArray die u kunt gebruiken om JavaScript-bestanden te beheren. Voeg het volgende toe in uw _init.php of individueel templatebestand:

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

Doorloop vervolgens in uw _main.php (of voettekst-include) de scripts-array om ze weer te geven:

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

Belangrijk: De $config->scripts-aanpak verwerkt het src-attribuut van het script, maar het data-asyntai-id-attribuut moet apart worden verwerkt. U moet het data-attribuut handmatig toevoegen in de lusuitvoer, of in plaats daarvan de directe script-tag-methode uit Stap 2 gebruiken voor de eenvoudigste configuratie.

Alternatieve methode 3: Een hook gebruiken (ready.php)

Voor een meer geavanceerde aanpak kunt u het hook-systeem van ProcessWire gebruiken om het chatbotscript automatisch in elke pagina te injecteren. Voeg het volgende toe aan uw site/ready.php-bestand:

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

Deze hook onderschept de gerenderde HTML-uitvoer van elke pagina en injecteert het Asyntai-script automatisch net vóór de afsluitende </body>-tag.

Tip: De ready.php-hook-aanpak is ideaal als u de chatbot op elke pagina wilt zonder templatebestanden te wijzigen. Het overleeft ook templatewijzigingen en thema-updates aangezien het buiten de templatebestanden leeft.

Stap 3: Installatie verifiëren

Na het opslaan van uw wijzigingen, bezoek uw ProcessWire-site in een nieuw browsertabblad of incognitovenster. U zou de chatwidget-knop in de rechteronderhoek moeten zien. Klik erop om te controleren of deze correct opent en werkt.

Ziet u de widget niet? Zorg ervoor dat u alle gewijzigde bestanden hebt opgeslagen. Probeer uw browsercache te wissen of bekijk de site in een incognitovenster. Als de templatecache van ProcessWire is ingeschakeld, moet u deze mogelijk wissen door naar Modules → Core → Template Engine Cache te gaan of door ?nocache=1 aan uw URL toe te voegen. Controleer ook of uw templatebestand daadwerkelijk wordt gebruikt door de pagina's die u bekijkt.