Hur du lägger till Asyntai AI-chattbot i Concrete CMS

Steg-för-steg-guide för Concrete CMS (tidigare Concrete5) webbplatser

Plattform:

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din Dashboard eftersom den innehåller ditt personliga widget-ID.

Steg 2: Lägg till kod i temats sidfot (rekommenderas)

Det bästa sättet att lägga till chattboten på alla sidor på din Concrete CMS-webbplats är att redigera ditt temas sidfotsfil:

Åtkomst till din Concrete CMS-installation via FTP eller filhanteraren
Navigera till katalogen /application/themes/your_theme_name/
Hitta och öppna filen footer.php (eller motsvarande sidfotsmall)
Hitta raden med den avslutande taggen </body>
Klistra in din Asyntai-inbäddningskod precis före taggen </body>
Spara filen och ladda upp den till din server om du redigerar lokalt
Rensa Concrete CMS-cache: Dashboard → System & Settings → Clear Cache

Tips: Att lägga till koden före det avslutande </body>-taggen säkerställer att chattboten laddas efter sidinnehållet, vilket ger bättre sidladdningsprestanda. Den här metoden lägger automatiskt till chattboten på varje sida som använder det här temat.

Alternativ metod 1: HTML-block (enklast för icke-utvecklare)

Om du föredrar att inte redigera temafiler kan du använda Concrete CMS inbyggda HTML-block:

Logga in på din Concrete CMS-instrumentpanel
Navigera till sidan där du vill lägga till chattbotten
Klicka på Redigera sida (pennikon i verktygsfältet)
Klicka på Lägg till block i det område där du vill placera koden
Sök efter och välj blocket HTML
Klistra in din Asyntai-inbäddningskod i HTML-redigeraren
Klicka på Lägg till för att spara blocket
Klicka på Publicera för att göra ändringarna aktiva

Obs! Metoden med HTML-block är bra för att lägga till chattboten på specifika sidor. För installation på hela webbplatsen måste du lägga till HTML-blocket på varje sida eller använda temasidfotens metod som beskrivs ovan. Den visuella placeringen av blocket påverkar inte var chattboten visas – den visas fortfarande i det nedre högra hörnet.

Alternativ metod 2: Temats sidhuvudsfil

Du kan också lägga till koden i ditt temas headerfil för installation på hela webbplatsen:

Åtkomst till dina Concrete CMS-filer via FTP eller filhanteraren
Navigera till /application/themes/your_theme_name/
Öppna filen header.php (eller elements/header.php)
Hitta den avslutande taggen </head>
Klistra in din Asyntai-inbäddningskod precis före taggen </head>
Spara och ladda upp filen
Rensa cachen från instrumentpanelen

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

Tips: Se till att inkludera de nödvändiga huvudelementen med <?php View::element('header_required'); ?> i din header.php-fil för att Concrete CMS ska fungera korrekt.

Alternativ metod 3: Anpassad mall (avancerat)

För utvecklare som vill ha mer kontroll kan du skapa en anpassad sidmall:

Skapa en ny sidmallfil i /application/themes/your_theme_name/
Eller kopiera en befintlig mall (t.ex. default.php) och byt namn på den
Lägg till din Asyntai-inbäddningskod i mallfilen före </body>
I Concrete CMS Dashboard, gå till Pages & Themes
Klicka på Sidtyper
Välj den sidtyp du vill använda den här mallen med
Tilldela din anpassade mall till sidtypen
Alla sidor som använder denna sidtyp inkluderar nu chattboten

Viktigt: Säkerhetskopiera alltid dina temafiler innan du gör ändringar. Testa dina ändringar på en staging-webbplats om möjligt. Felaktiga ändringar i temafiler kan förstöra webbplatsens layout eller funktionalitet.

Steg 3: Verifiera installationen

Efter att du har gjort dina ändringar och rensat cachen, öppna din webbplats i en ny webbläsarflik eller ett inkognitofönster. Du bör se widgetknappen för chatten i det nedre högra hörnet. Klicka på den för att säkerställa att den öppnas och fungerar korrekt.

Ser du inte widgeten? Se till att du rensat Concrete CMS cache (Dashboard → System & Settings → Clear Cache). Prova att visa din webbplats i ett inkognitofönster. Kontrollera att du sparat och laddat upp alla filändringar. Öppna webbläsarkonsolen (F12) för att kontrollera eventuella JavaScript-fel.