Kā pievienot Asyntai AI tērzēšanas robotu Sylius
Soli pa solim ceļvedis Sylius e-komercijas platformai
1. solis: Iegūstiet savu iegulto kodu
Vispirms dodieties uz savu Asyntai vadības paneli un ritiniet uz leju līdz sadaļai "Iegultais kods". Nokopējiet savu unikālo iegulto kodu, kas izskatīsies šādi:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Piezīme: Iepriekš minētais kods ir tikai piemērs. Jums jānokopē savs unikālais iegultais kods no sava Vadības paneļa, jo tas satur jūsu personīgo logrīka ID.
2. solis: Pievienošana Twig izkārtojuma veidnei (ieteicams)
Sylius ir veidots uz Symfony un izmanto Twig veidņu dzinēju. Ieteicamā pieeja ir pārrakstīt veikala izkārtojuma veidni, lai iekļautu tērzēšanas robotu visās veikala lapās.
- Savā Sylius projektā dodieties uz direktoriju
templates/bundles/SyliusShopBundle/(izveidojiet to, ja tā neeksistē) - Izveidojiet vai rediģējiet failu layout.html.twig, lai pārrakstītu noklusējuma veikala izkārtojumu
- Ja fails jau eksistē, atrodiet
{% block javascripts %}bloku - Pievienojiet Asyntai iegulšanas kodu, paplašinot javascripts bloku:
{% block javascripts %} {{ parent() }} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endblock %} - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID no vadības paneļa - Saglabājiet failu
Padoms: 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.
1. alternatīvā metode: Sylius veidņu notikumu izmantošana
Sylius nodrošina jaudīgu veidņu notikumu sistēmu, kas ļauj ievadīt saturu noteiktās izkārtojuma daļās, nepārrakstot visas veidnes. Varat to izmantot, lai pievienotu tērzēšanas robota logrīku kājenes zonai.
- Izveidojiet jaunu veidnes failu
templates/bundles/SyliusShopBundle/Event/asyntai_widget.html.twigar šādu saturu:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Reģistrējiet veidnes notikumu savā konfigurācijas failā
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 - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID - Iztīriet Symfony kešatmiņu (skatiet 3. soli tālāk)
Piezīme: Veidņu notikumu pieeja ir vismazāk invazīvā metode. Tā neprasa pārrakstīt nevienu esošo veidni un tīri integrējas ar Sylius arhitektūru. Vērtība priority kontrolē atveidošanas secību, ja vienā notikumā ir reģistrēti vairāki bloki.
2. alternatīvā metode: Webpack Encore izmantošana
Ja jūsu Sylius projekts izmanto Webpack Encore resursu pārvaldīšanai, varat integrēt tērzēšanas robota skriptu caur savu JavaScript būvēšanas cauruļvadu.
- Izveidojiet jaunu JavaScript failu
assets/shop/js/asyntai-chatbot.jsar šādu saturu:(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);
})(); - Importējiet šo failu savā veikala ievades punktā (piem.,
assets/shop/entry.jsvaiassets/shop/js/app.js):import './js/asyntai-chatbot'; - Pārbūvējiet savus resursus, palaižot:
yarn encore devVai ražošanai:
yarn encore production - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID
Padoms: Webpack Encore izmantošana nodrošina, ka tērzēšanas robota skripts ir apvienots ar citiem resursiem un gūst labumu no kešatmiņas un optimizācijas, ko nodrošina būvēšanas rīks.
3. alternatīvā metode: Sonata Block Bundle izmantošana
Ja jūsu Sylius instalācija izmanto Sonata Block Bundle (iekļauts pēc noklusējuma dažās Sylius konfigurācijās), varat izveidot pielāgotu bloka servisu, lai atveidotu tērzēšanas robota logrīku.
- Izveidojiet jaunu bloka servisa klasi savā projektā, piemēram,
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);
}
} - Izveidojiet bloka veidni
templates/block/asyntai_chatbot.html.twig:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Reģistrējiet bloka servisu savā
config/services.yaml:services:
app.block.asyntai_chatbot:
class: App\Block\AsyntaiChatbotBlockService
arguments:
- '@twig'
tags:
- { name: sonata.block, context: footer } - Ievietojiet bloku kājenes kontekstā, izmantojot Sonata admin vai pievienojot to savai izkārtojuma konfigurācijai
- Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID
Svarīgi: Sonata Block pieeja prasa vairāk iestatīšanas, bet nodrošina elastību tērzēšanas robota bloka pārvaldīšanai caur administrēšanas saskarni. Pārliecinieties, ka Sonata Block Bundle ir instalēts un konfigurēts jūsu Sylius projektā pirms šīs metodes izmantošanas.
3. solis: Notīriet kešatmiņu un pārbaudiet
Pēc izmaiņu veikšanas jums jāiztīra Symfony kešatmiņa un jāpārbauda instalācija:
- Iztīriet Symfony kešatmiņu, palaižot šādu komandu no sava projekta saknes:
bin/console cache:clear - Ja esat ražošanas vidē, arī uzsildiet kešatmiņu:
bin/console cache:clear --env=prod
bin/console cache:warmup --env=prod - Atveriet savu aktīvo veikalu jaunā pārlūkprogrammas cilnē
- Jums vajadzētu redzēt tērzēšanas logrīka pogu apakšējā labajā stūrī
- Noklikšķiniet uz tās, lai pārliecinātos, ka tā atveras un darbojas pareizi
Neredzat logrīku? Pārliecinieties, ka esat iztīrījis Symfony kešatmiņu ar bin/console cache:clear. Pārbaudiet, vai veidnes pārrakstīšana ir pareizajā direktorijā (templates/bundles/SyliusShopBundle/). Mēģiniet notīrīt pārlūkprogrammas kešatmiņu vai skatīt inkognito logā. Pārbaudiet pārlūkprogrammas izstrādātāja konsoli, vai nav JavaScript kļūdu. Ja izmantojat Webpack Encore, pārliecinieties, ka esat pārbūvējis resursus.
Sylius versijas piezīme: Veidņu pārrakstīšanas ceļi var nedaudz atšķirties starp Sylius versijām. Sylius 1.x veikala komplekta veidnes atrodas zem templates/bundles/SyliusShopBundle/. Pārbaudiet savu Sylius dokumentāciju pareizajam pārrakstīšanas ceļam, ja izmantojat citu versiju.
Weebly