Atpakaļ uz informācijas paneli

Dokumentācija

Uzziniet, kā lietot Asyntai

Kā pievienot Asyntai AI tērzēšanas robotu Sylius

Soli pa solim ceļvedis Sylius e-komercijas platformai

Iegūt iegulšanas kodu

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.

  1. Savā Sylius projektā dodieties uz direktoriju templates/bundles/SyliusShopBundle/ (izveidojiet to, ja tā neeksistē)
  2. Izveidojiet vai rediģējiet failu layout.html.twig, lai pārrakstītu noklusējuma veikala izkārtojumu
  3. Ja fails jau eksistē, atrodiet {% block javascripts %} bloku
  4. 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 %}
  5. Aizstājiet YOUR_WIDGET_ID ar savu reālo logrīka ID no vadības paneļa
  6. 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.

  1. Izveidojiet jaunu veidnes failu templates/bundles/SyliusShopBundle/Event/asyntai_widget.html.twig ar šādu saturu:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  2. 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
  3. Aizstājiet YOUR_WIDGET_ID ar savu reālo logrīka ID
  4. 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.

  1. Izveidojiet jaunu JavaScript failu assets/shop/js/asyntai-chatbot.js ar šā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);
    })();
  2. Importējiet šo failu savā veikala ievades punktā (piem., assets/shop/entry.js vai assets/shop/js/app.js):
    import './js/asyntai-chatbot';
  3. Pārbūvējiet savus resursus, palaižot:
    yarn encore dev

    Vai ražošanai:

    yarn encore production
  4. Aizstājiet YOUR_WIDGET_ID ar 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.

  1. 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);
        }
    }
  2. 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>
  3. 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 }
  4. Ievietojiet bloku kājenes kontekstā, izmantojot Sonata admin vai pievienojot to savai izkārtojuma konfigurācijai
  5. Aizstājiet YOUR_WIDGET_ID ar 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:

  1. Iztīriet Symfony kešatmiņu, palaižot šādu komandu no sava projekta saknes:
    bin/console cache:clear
  2. Ja esat ražošanas vidē, arī uzsildiet kešatmiņu:
    bin/console cache:clear --env=prod
    bin/console cache:warmup --env=prod
  3. Atveriet savu aktīvo veikalu jaunā pārlūkprogrammas cilnē
  4. Jums vajadzētu redzēt tērzēšanas logrīka pogu apakšējā labajā stūrī
  5. 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.