Kako dodati Asyntai AI chatbot na Sylius
Vodič korak po korak za Sylius platformu za e-trgovinu
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 Twig predložak rasporeda (Preporučeno)
Sylius je izgraden na Symfonyju i koristi Twig sustav predlozaka. Preporuceni pristup je nadjacavanje predloska rasporeda trgovine za ukljucivanje chatbota na svim stranicama trgovine.
- U svom Sylius projektu navigirajte do direktorija
templates/bundles/SyliusShopBundle/(izradite ga ako ne postoji) - Izradite ili uredite datoteku layout.html.twig za nadjacavanje zadanog rasporeda trgovine
- Ako datoteka već postoji, pronađite
{% block javascripts %}blok - Dodajte Asyntai ugradni kod prosirivanjem bloka javascripts:
{% block javascripts %} {{ parent() }} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endblock %} - Zamijenite
YOUR_WIDGET_IDsvojim stvarnim ID-jem widgeta s nadzorne ploce - Spremite datoteku
Savjet: 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.
Alternativna metoda 1: Korištenje Sylius događaja predložaka
Sylius pruza mocni sustav dogadaja predlozaka koji vam omogucuje ubacivanje sadrzaja u specificne dijelove rasporeda bez nadjacavanja cijelih predlozaka. Mozete ga koristiti za dodavanje chatbot widgeta u podrucje podnozja.
- Izradite novu datoteku predloska na
templates/bundles/SyliusShopBundle/Event/asyntai_widget.html.twigsa sljedecim sadrzajem:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Registrirajte dogadaj predloska u svojoj konfiguracijskoj datoteci
config/packages/sylius_ui.yaml:sylius_ui:
events:
sylius.shop.layout.after_body:
blocks:
asyntai_chatbot:
template: "@SyliusShop/Event/asyntai_widget.html.twig"
priority: 0 - Zamijenite
YOUR_WIDGET_IDsvojim stvarnim ID-jem widgeta - Očistite Symfony predmemoriju (pogledajte Korak 3 ispod)
Napomena: Pristup dogadaja predlozaka je najneinvazivnija metoda. Ne zahtijeva nadjacavanje postojecih predlozaka i cisto se integrira sa Sylius arhitekturom. Vrijednost priority kontrolira redoslijed prikazivanja ako je vise blokova registrirano za isti dogadaj.
Alternativna metoda 2: Korištenje Webpack Encorea
Ako vas Sylius projekt koristi Webpack Encore za upravljanje resursima, mozete integrirati skriptu chatbota putem vaseg JavaScript cjevovoda za izgradnju.
- Izradite novu JavaScript datoteku na
assets/shop/js/asyntai-chatbot.jssa sljedecim sadrzajem:(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);
})(); - Uvezite ovu datoteku u ulaznu tocku trgovine (npr.
assets/shop/entry.jsiliassets/shop/js/app.js):import './js/asyntai-chatbot'; - Ponovno izgradite resurse pokretanjem:
yarn encore devIli za produkciju:
yarn encore production - Zamijenite
YOUR_WIDGET_IDsvojim stvarnim ID-jem widgeta
Savjet: Koristenje Webpack Encorea osigurava da je skripta chatbota pakirana s vasim ostalim resursima i ima koristi od predmemoriranja i optimizacije koje pruza alat za izgradnju.
Alternativna metoda 3: Korištenje Sonata Block Bundlea
Ako vasa Sylius instalacija koristi Sonata Block Bundle (ukljucen prema zadanim postavkama u nekim Sylius konfiguracijama), mozete izraditi prilagodenu uslugu bloka za prikazivanje chatbot widgeta.
- Izradite novu klasu usluge bloka u svom projektu, na primjer
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);
}
} - Izradite predlozak bloka na
templates/block/asyntai_chatbot.html.twig:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Registrirajte uslugu bloka u svom
config/services.yaml:services:
app.block.asyntai_chatbot:
class: App\Block\AsyntaiChatbotBlockService
arguments:
- '@twig'
tags:
- { name: sonata.block, context: footer } - Postavite blok u kontekst podnozja putem Sonata admina ili dodavanjem u konfiguraciju rasporeda
- Zamijenite
YOUR_WIDGET_IDsvojim stvarnim ID-jem widgeta
Važno: Pristup Sonata bloka zahtijeva vise postavljanja, ali pruza fleksibilnost za upravljanje blokom chatbota putem administratorskog sucelja. Provjerite je li Sonata Block Bundle instaliran i konfiguriran u vasem Sylius projektu prije koristenja ove metode.
Korak 3: Očistite predmemoriju i provjerite
Nakon izmjena trebate ocistiti Symfony predmemoriju i provjeriti instalaciju:
- Ocistite Symfony predmemoriju pokretanjem sljedece naredbe iz korijena projekta:
bin/console cache:clear - Ako ste u produkcijskom okruženju, također zagrijte predmemoriju:
bin/console cache:clear --env=prod
bin/console cache:warmup --env=prod - Otvorite svoju živu trgovinu u novoj kartici preglednika
- Trebali biste vidjeti gumb chat widgeta u donjem desnom kutu
- Kliknite ga kako biste provjerili otvara li se i radi li ispravno
Ne vidite widget? Provjerite jeste li ocistili Symfony predmemoriju s bin/console cache:clear. Potvrdite da je nadjacavanje predloska u ispravnom direktoriju (templates/bundles/SyliusShopBundle/). Pokusajte ocistiti predmemoriju preglednika ili pregledavati u anonimnom prozoru. Provjerite konzolu za programere u pregledniku za JavaScript greske. Ako koristite Webpack Encore, provjerite jeste li ponovno izgradili resurse.
Napomena o verziji Syliusa: Putanje nadjacavanja predlozaka mogu se neznatno razlikovati izmedu verzija Syliusa. U Syliusu 1.x predlosci paketa trgovine nalaze se pod templates/bundles/SyliusShopBundle/. Provjerite dokumentaciju Syliusa za ispravnu putanju nadjacavanja ako koristite drugu verziju.
Weebly