Come aggiungere il chatbot IA Asyntai a Kirby

Guida passo passo per i siti web Kirby CMS

Piattaforma:

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

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

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Passaggio 2: Aggiungi allo Snippet Kirby (consigliato)

Kirby è un CMS PHP basato su file flat che utilizza gli snippet per parti di template riutilizzabili. L'approccio consigliato è creare uno snippet dedicato per il chatbot:

Crea un nuovo file snippet in site/snippets/asyntai-widget.php
Incolla il tuo codice di integrazione nel file:

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

Quindi includi lo snippet nel tuo template principale (ad es., site/templates/default.php) o nel tuo layout, appena prima del tag di chiusura </body>:

<?php snippet('asyntai-widget') ?>
</body>
</html>

Suggerimento: Se utilizzi un layout condiviso o uno snippet footer, puoi aggiungere la chiamata allo snippet lì in modo che appaia automaticamente su ogni pagina. Ad esempio, aggiungilo al tuo snippet footer appena prima di </body>.

Metodo alternativo 1: Aggiungi allo Snippet Footer

Se il tuo sito Kirby utilizza uno snippet footer, puoi aggiungere il codice di integrazione direttamente lì:

Apri site/snippets/footer.php (crealo se non esiste)
Aggiungi il codice di integrazione prima del tag di chiusura </body>

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

Assicurati che i tuoi template includano lo snippet footer:

<?php snippet('footer') ?>

Nota: Se lo snippet footer è già incluso in tutti i tuoi template, aggiungere il chatbot qui garantisce che appaia su ogni pagina senza modificare i singoli file dei template.

Metodo alternativo 2: Utilizzo di un Plugin Kirby

Puoi creare un plugin Kirby per iniettare automaticamente lo script del chatbot in ogni pagina senza modificare alcun template:

Crea la directory e il file del plugin in site/plugins/asyntai/index.php
Aggiungi il seguente codice per iniettare lo script dinamicamente:

Kirby::plugin('custom/asyntai', [
    'hooks' => [
        'page.render:after' => function ($contentType, $body) {
            $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
            return str_replace('</body>', $script . '</body>', $body);
        }
    ]
]);

Suggerimento: L'approccio tramite plugin è ideale se desideri che il chatbot si carichi automaticamente su ogni pagina senza modificare alcun file di template o snippet. Mantiene inoltre la tua integrazione chatbot modulare e facile da abilitare o disabilitare.

Metodo alternativo 3: Utilizzo dell'Helper js() di Kirby

Kirby fornisce un helper js() integrato per caricare file JavaScript. Puoi utilizzarlo nel tuo template o snippet:

<?= js('https://asyntai.com/static/js/chat-widget.js', ['async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID']) ?>

Oppure aggiungi lo script direttamente nel tuo file PHP del template prima di </body>:

<?php // site/templates/default.php ?>
<html>
<head>
    <!-- head content -->
</head>
<body>
    <!-- page content -->
    <?php snippet('header') ?>
    <main>
        <?= $page->text()->kirbytext() ?>
    </main>
    <?php snippet('footer') ?>

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

Nota: Se utilizzi l'helper js(), assicurati che sia posizionato all'interno della sezione <body> del tuo template per garantire che il chatbot si carichi correttamente.

Passaggio 3: verifica l'installazione

Dopo aver aggiunto il codice di integrazione al tuo sito Kirby, visita il tuo sito web in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di aver sostituito YOUR_WIDGET_ID con il tuo ID widget effettivo dalla dashboard. Verifica che il file dello snippet o del plugin sia salvato nella directory corretta. Se utilizzi il metodo plugin, assicurati che la struttura della directory del plugin sia site/plugins/asyntai/index.php. Svuota la cache del browser o testa in modalità incognito. Controlla la console sviluppatore del browser (F12) per eventuali errori.