A Magento Open Source-ban és az Adobe Commerce-ben van egy lábléc-beállítás azoknak a szkripteknek, amelyek minden oldal legvégén töltődnek be, és a Yaplet widgetnek csak erre van szüksége. Kimásolsz egy kódrészletet a Yapletből, beilleszted ebbe a beállításba, frissíted a gyorsítótárat, és megjelenik a chat gomb a boltodban. Nem kell hozzá bővítmény.
Ezek a lépések a saját szerveren futó boltokra és az Adobe Commerce on cloud infrastructure-re vonatkoznak; az Adobe útmutatója erre a két esetre írja le ezt a beállítást. A Magento 2.4.7-es és újabb verzióiban a chat nem fut a pénztár oldalain, hacsak egy fejlesztő nem engedélyezi (lásd lent). Az admin menüpontjait angolul írjuk, ahogy az Adobe dokumentációja mutatja, zárójelben magyar fordítással; magyar nyelvi csomaggal a nevük eltérhet.
1. Másold ki a Yaplet kódodat
A Yaplet bal oldali menüjében menj a Márka → (a márkád) → Chat widget → Telepítés útvonalra. Ha a fül megkérdezi, min fut a weboldalad, válaszd a Más weboldal lehetőséget. Másold ki a kódot a kódblokk másolás gombjával.
A Miscellaneous HTML mező HTML-t vár, ezért a kódnak egy <script> és egy </script> sor között kell lennie. Ha a Más weboldal lehetőséget választottad, a kódban már benne vannak ezek a sorok. Ha a fül nem kérdezett rá, a kód sima JavaScript, amely így kezdődik: !function (Yaplet, és a 3. lépésben adod hozzá a sorokat.
2. Nyisd meg a lábléc beállításait
Az admin oldalsávjában menj a Content → Design → Configuration (Tartalom → Dizájn → Konfiguráció) menüpontra. Keresd meg azt a store view-t (áruházi nézetet), ahol chatet szeretnél, és kattints az Edit (Szerkesztés) gombra az Action (Művelet) oszlopban. Az Other Settings (Egyéb beállítások) alatt nyisd ki a Footer (Lábléc) részt.
3. Add hozzá a Yaplet kódot
- Kattints a Miscellaneous HTML (Egyéb HTML) mezőbe. Ha már van benne kód, menj a végére, és kezdj egy új sort. A meglévő kódot hagyd úgy, ahogy van.
- Illeszd be a Yaplet kódot az új sorba. A kódnak egy
<script>sorral kell kezdődnie, és egy</script>sorral kell végződnie. Ha a kimásolt kód ehelyett így kezdődik:!function (Yaplet, írd elé egy új sorba, hogy<script>, utána pedig egy új sorba, hogy</script>. - Kattints a Save Configuration (Konfiguráció mentése) gombra.
- Ha a boltodnak több store view-ja van, ismételd meg ezeket a lépéseket minden olyan store view-nál, ahol chatet szeretnél.
4. Frissítsd a gyorsítótárat
Ha a Magento üzenetben jelzi, hogy egy gyorsítótárat frissíteni kell, kattints az üzenetben lévő Cache Management (Gyorsítótár-kezelés) linkre (vagy menj a System → Tools → Cache Management menüpontra). Jelöld ki az érvénytelenként jelölt gyorsítótárakat, az Actions (Műveletek) mezőben válaszd a Refresh (Frissítés) lehetőséget, és kattints a Submit (Küldés) gombra. A Flush Magento Cache (Magento gyorsítótár ürítése) gombra is kattinthatsz.
5. Nézd meg a boltodat
Nyisd meg a boltodat egy új böngészőfülön, és frissítsd az oldalt. A Yaplet chat gombja megjelenik a jobb alsó sarokban. Kattints rá, és nézd meg, hogy megnyílik-e a chat.
A teljes ellenőrzőlistát itt találod: Telepítés ellenőrzése.
A pénztár oldalai (Magento 2.4.7 és újabb)
A 2.4.7-es verziótól a Magento tartalombiztonsági szabályzata (Content Security Policy) „restrict” módban fut a fizetési oldalakon, például a pénztárban: csak azokat a beágyazott szkripteket engedi futni, amelyek rajta vannak a bolt engedélyezési listáján. Az Adobe útmutatója szerint a Miscellaneous HTML mezőbe tett szkriptek nem futnak a pénztárban, ha nincsenek a listán. A chat tehát a bolt többi részén működik, a pénztárban viszont nem. Ha ott is szeretnéd, egy fejlesztőnek kell felvennie a Yaplet kódot és a Yaplet címeit az engedélyezési listára egy saját modulban. A címeket a Telepítés ellenőrzése cikk sorolja fel, a tartalombiztonsági szabályzatról (CSP) szóló résznél.
Ha nem jelenik meg a chat
- A kód szövegként látszik az oldalak alján. Hiányoznak a
<script>tagek. Írd a kód elé egy új sorba, hogy<script>, a kód után egy új sorba, hogy</script>, mentsd, és frissítsd a gyorsítótárat. - Mentés után semmi sem változott. Az oldal-gyorsítótár még a régi oldalakat adja. Frissítsd az érvénytelen gyorsítótárakat a System → Tools → Cache Management menüpontban, és ürítsd a boltod minden más oldal-gyorsítótárát is.
- A chat az egyik store view-ban megjelenik, a másikban nem. A beállítás store view-nként mentődik. Add hozzá a kódot a másik store view-hoz is.
- A chat csak a pénztárban hiányzik. Ezt a Magento 2.4.7-es és újabb verzióinak tartalombiztonsági szabályzata okozza. Lásd a fenti részt.
- A böngésző az oldal egy régi változatát mutatja. A Magento gyorsítótárának ürítése nem üríti a böngésződ gyorsítótárát. Frissítsd az oldalt, vagy nyisd meg egy privát böngészőablakban.
Mi a következő lépés?
Ha meg szeretnéd tudni, mit csinál a kód, és hol találod a widget azonosítóját, olvasd el ezt: A Yaplet telepítése.