Asyntai AI -chatbotin lisääminen Syliukseen
Vaiheittainen opas Sylius-verkkokauppa-alustalle
Vaihe 1: Hanki upotuskoodisi
Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.
Vaihe 2: Lisää Twig-asettelumalliin (suositeltu)
Sylius on rakennettu Symfonyn päälle ja käyttää Twig-mallipohjamootoria. Suositeltu tapa on ylikirjoittaa kaupan asettelumalli chatbotin sisällyttämiseksi kaikille kauppasivuille.
- Siirry Sylius-projektissasi
templates/bundles/SyliusShopBundle/-hakemistoon (luo se tarvittaessa) - Luo tai muokkaa tiedostoa layout.html.twig ylikirjoittaaksesi kaupan oletusasettelun
- Jos tiedosto on jo olemassa, etsi
{% block javascripts %}lohko - Lisää Asyntai-upotuskoodi laajentamalla javascripts-lohkoa:
{% block javascripts %} {{ parent() }} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endblock %} - Korvaa
YOUR_WIDGET_IDtodellisella widget-tunnuksellasi hallintapaneelista - Tallenna tiedosto
Vinkki: By using {{ parent() }} inside the block, you preserve all existing JavaScript includes from the parent template while appending the chatbot script at the end, ensuring it loads after the page content.
Vaihtoehtoinen menetelmä 1: Sylius-mallitapahtumien käyttö
Sylius tarjoaa tehokkaan mallitapahtumajärjestelmän, joka mahdollistaa sisällön lisäämisen tiettyihin asettelun osiin ilman kokonaisten mallien ylikirjoittamista. Voit käyttää tätä chatbot-widgetin lisäämiseen alatunnistealueelle.
- Luo uusi mallitiedosto polkuun
templates/bundles/SyliusShopBundle/Event/asyntai_widget.html.twigseuraavalla sisällöllä:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Rekisteröi mallitapahtuma
config/packages/sylius_ui.yaml-konfiguraatiotiedostossasi:sylius_ui:
events:
sylius.shop.layout.after_body:
blocks:
asyntai_chatbot:
template: "@SyliusShop/Event/asyntai_widget.html.twig"
priority: 0 - Korvaa
YOUR_WIDGET_IDtodellisella widget-tunnuksellasi - Tyhjennä Symfony-välimuisti (katso vaihe 3 alla)
Huomautus: Mallitapahtuma-lähestymistapa on vähiten invasiivinen menetelmä. Se ei vaadi olemassa olevien mallien ylikirjoittamista ja integroituu puhtaasti Syliuksen arkkitehtuuriin. priority-arvo ohjaa renderöintijärjestystä, jos samalle tapahtumalle on rekisteröity useita lohkoja.
Vaihtoehtoinen menetelmä 2: Webpack Encoren käyttö
Jos Sylius-projektisi käyttää Webpack Encore -työkalua resurssien hallintaan, voit integroida chatbot-skriptin JavaScript-buildausputken kautta.
- Luo uusi JavaScript-tiedosto polkuun
assets/shop/js/asyntai-chatbot.jsseuraavalla sisällöllä:(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Tuo tämä tiedosto kaupan aloituspisteeseen (esim.
assets/shop/entry.jstaiassets/shop/js/app.js):import './js/asyntai-chatbot'; - Rakenna resurssisi uudelleen suorittamalla:
yarn encore devTai tuotantoympäristöä varten:
yarn encore production - Korvaa
YOUR_WIDGET_IDtodellisella widget-tunnuksellasi
Vinkki: Webpack Encoren käyttö varmistaa, että chatbot-skripti paketoidaan muiden resurssien kanssa ja hyötyy buildaustyökalun tarjoamasta välimuistista ja optimoinnista.
Vaihtoehtoinen menetelmä 3: Sonata Block Bundlen käyttö
Jos Sylius-asennuksesi käyttää Sonata Block Bundlea (sisältyy oletusarvoisesti joihinkin Sylius-konfiguraatioihin), voit luoda mukautetun lohkopalvelun chatbot-widgetin renderöimiseksi.
- Luo uusi lohkopalveluluokka projektiisi, esimerkiksi
src/Block/AsyntaiChatbotBlockService.php:<?php
namespace App\Block;
use Sonata\BlockBundle\Block\BlockContextInterface;
use Sonata\BlockBundle\Block\Service\AbstractBlockService;
use Symfony\Component\HttpFoundation\Response;
class AsyntaiChatbotBlockService extends AbstractBlockService
{
public function execute(BlockContextInterface $blockContext, Response $response = null): Response
{
return $this->renderResponse('block/asyntai_chatbot.html.twig', [
'block' => $blockContext->getBlock(),
], $response);
}
} - Luo lohkomalli polkuun
templates/block/asyntai_chatbot.html.twig:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Rekisteröi lohkopalvelu
config/services.yaml-tiedostossasi:services:
app.block.asyntai_chatbot:
class: App\Block\AsyntaiChatbotBlockService
arguments:
- '@twig'
tags:
- { name: sonata.block, context: footer } - Sijoita lohko alatunnistekontekstiisi Sonata-hallintapaneelin kautta tai lisäämällä se asettelukonfiguraatioosi
- Korvaa
YOUR_WIDGET_IDtodellisella widget-tunnuksellasi
Tärkeää: Sonata Block -lähestymistapa vaatii enemmän asennusta, mutta tarjoaa joustavuutta chatbot-lohkon hallintaan hallintapaneelin kautta. Varmista, että Sonata Block Bundle on asennettu ja konfiguroitu Sylius-projektissasi ennen tämän menetelmän käyttöä.
Vaihe 3: Tyhjennä välimuisti ja vahvista
Muutosten tekemisen jälkeen sinun on tyhjennettävä Symfony-välimuisti ja varmistettava asennus:
- Tyhjennä Symfony-välimuisti suorittamalla seuraava komento projektisi juurihakemistosta:
bin/console cache:clear - Jos olet tuotantoympäristössä, lämmitä myös välimuisti:
bin/console cache:clear --env=prod
bin/console cache:warmup --env=prod - Avaa Sylius-kauppasi uudessa selaimen välilehdessä tai incognito-ikkunassa
- Chat-widget-painikkeen pitäisi näkyä oikeassa alakulmassa
- Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein
Etkö näe widgetiä? Varmista, että tyhjensit Symfony-välimuistin komennolla bin/console cache:clear. Tarkista, että mallin ylikirjoitus on oikeassa hakemistossa (templates/bundles/SyliusShopBundle/). Kokeile tyhjentää selaimen välimuisti tai tarkastella incognito-ikkunassa. Tarkista selaimen kehittäjäkonsolista mahdolliset JavaScript-virheet. Jos käytät Webpack Encore -työkalua, varmista, että olet rakentanut resurssit uudelleen.
Sylius-versiohuomautus: Mallin ylikirjoituspolut voivat vaihdella hieman Sylius-versioiden välillä. Sylius 1.x:ssä kauppabundlen mallit sijaitsevat templates/bundles/SyliusShopBundle/-hakemistossa. Tarkista Sylius-dokumentaatiosta oikea ylikirjoituspolku, jos käytät eri versiota.
Weebly