A Yaplet telepítése Joomla weboldalra

A Joomla alapértelmezett sablonja, a Cassiopeia, minden oldalon betölt egy user.js nevű fájlt, és a Yaplet widgetnek csak erre van szüksége. Ezt a fájlt a Joomla adminban hozod létre, beilleszted bele a Yaplet kódrészletét, és megjelenik a chat gomb az oldaladon. Nem kell hozzá bővítmény.

Ez az útmutató a Cassiopeia sablont használó oldalakhoz szól, Joomla 4-től felfelé. Ha az oldalad más sablont használ, kérdezd meg a sablon fejlesztőjét, hová kerülhet saját JavaScript. A menüpontokat angolul írjuk, ahogy az angol nyelvű adminban szerepelnek, zárójelben a jelentésükkel.

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, és kapcsold ki ezt a kapcsolót: A <script> és a </script> sorral együtt. Másold ki a kódot a kódblokk másolás gombjával.

A kódnak sima JavaScriptnek kell lennie, amely így kezdődik: !function (Yaplet, és nincs körülötte <script> tag. Ha a kimásolt kód egy <script> sorral kezdődik, hagyd ki ezt az első sort és az utolsó, </script> sort. A user.js JavaScript fájl, ezért a kód tagek nélkül kerül bele.

2. Nyisd meg a sablon fájljait

A Joomla adminban menj a System → Site Templates → Cassiopeia Details and Files (Rendszer → Webhelysablonok → a Cassiopeia részletei és fájljai) menüpontra. Ez megnyitja a Templates: Customise (Cassiopeia) oldalt a sablon mappáival és fájljaival.

Ha az oldalad a Cassiopeia egyik gyereksablonját használja, ugyanezt megteheted annak a sablonnak a Details and Files oldalán is.

3. Hozd létre a user.js fájlt

1. Válaszd ki a js mappát. Ha már van benne user.js, válaszd ki, és ugorj a 4. lépésre.
2. Válaszd a New File (Új fájl) lehetőséget.
3. A felugró ablakban válaszd ki a js mappát, különben a fájl rossz helyre kerül.
4. A user nevet írd a File Name (Fájlnév) mezőbe, a File Type (Fájltípus) mezőben pedig válaszd a .js típust.
5. Válaszd a Create (Létrehozás) gombot, majd nyisd meg az új user.js fájlt.

4. Illeszd be a kódot, és mentsd

Illeszd be a Yaplet kódot a user.js fájlba. Ha a fájlban már van kód, a Yaplet kódot a végére tedd, egy új sorba. Ezután válaszd a Save (Mentés) gombot.

5. Nézd meg az oldaladat

Nyisd meg az oldaladat egy új böngészőfülön, és frissítsd. 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.

Ha nem jelenik meg a chat

• A fájl rossz mappába került. A user.js fájlnak a sablon js mappájában kell lennie (a szerveren: media/templates/site/cassiopeia/js/user.js). Ha máshová került, hozd létre újra a js mappában.
• <script> tageket tettél a kód köré. Töröld őket. A user.js sima JavaScriptet vár, a tagek miatt a kód nem fut le.
• Az oldalad más sablont használ. A Cassiopeia betölti a user.js fájlt, más sablonok viszont nem feltétlenül. Kérdezd meg a sablon fejlesztőjét, hová kerülhet saját JavaScript.
• A Joomla gyorsítótára még a régi oldalakat tárolja. Menj a System → Clear Cache (Rendszer → Gyorsítótár ürítése, a Maintenance panelen) menüpontra, jelölj ki mindent az oszlopfejléc jelölőnégyzetével, és válaszd a Delete (Törlés) gombot. Ezután nyisd meg az oldaladat egy privát 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.