A Drupalban alapból nincs olyan beállítás, amellyel szkriptet tehetnél minden oldalra, de az ingyenes Asset Injector modul ad ilyet, és a Yaplet widgetnek csak erre van szüksége. Telepíted a modult, beilleszted a Yaplet kódrészletét egy új JS injectorba, és megjelenik a chat gomb az oldaladon. Az Asset Injector a Drupal 10.3-as és újabb verzióival működik, a Drupal 11-gyel is, és a stabil kiadásait a Drupal biztonsági csapata felügyeli.
Modul telepítéséhez adminisztrátori fiók kell, és általában Composer a szerveren. Ha nem te kezeled az oldalt, küldd el ezt az útmutatót a fejlesztődnek. A menüpontokat angolul írjuk, ahogy az angol nyelvű adminban szerepelnek, zárójelben a jelentésükkel.
1. Telepítsd az Asset Injector modult
- A szerveren, a Drupal projektedben futtasd a modul oldalán megadott Composer parancsot:
composer require 'drupal/asset_injector:^2.21'- A Drupalban menj az Extend (Bővítés) oldalra, jelöld be az Asset Injector modult, és kattints az Install (Telepítés) gombra.
Az Administer JS Assets jogosultságot csak olyan szerepköröknek add meg, amelyekben teljesen megbízol: aki megkapja, az oldalad minden oldalára tehet JavaScriptet.
2. 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. Az Asset Injector tagek nélkül várja a kódot, és tagekkel el sem menti.
3. Adj hozzá egy JS injectort
- Menj a Configuration → Development → Asset Injector → JS Injector (Beállítások → Fejlesztés → Asset Injector → JS Injector) menüpontra.
- Kattints az Add JS Injector (JS injector hozzáadása) gombra.
- A Label (Név) mezőbe írj egy nevet, amelyről később is ráismersz, például Yaplet chat.
- Illeszd be a kimásolt kódot a Code (Kód) mezőbe.
- Ellenőrizd, hogy az Enabled (Engedélyezve) be van-e jelölve.
- A feltételeket hagyd üresen, így a kód minden oldalon betöltődik.
- Kattints a Save (Mentés) gombra.
A speciális beállításokat hagyhatod úgy, ahogy vannak: a chatnek nem kell jQuery, és a szkript betöltése az oldal alján (a Drupal alapbeállítása) jól működik. Feltételek nélkül a chat az admin oldalakon is megjelenik. Ha csak a nyilvános oldaladon szeretnéd látni, a Current Theme (Jelenlegi téma) feltételnél válaszd ki az oldalad nyilvános témáját.
4. Nézd meg az oldaladat
Az Asset Injector mentéskor üríti a Drupal gyorsítótárát. 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 Drupal azt írja, hogy a kód elején és végén nem lehet
<script>tag. Töröld az első,<script>sort és az utolsó,</script>sort, hogy a kód így kezdődjön:!function (Yaplet. - Az injector ki van kapcsolva. Szerkeszd, jelöld be az Enabled mezőt, és mentsd.
- Egy feltétel elrejti a chatet. A feltételek korlátozzák, mely oldalakon töltődik be a kód. Ha beállítottad a Current Theme feltételt, ellenőrizd, hogy a nyilvános oldalad témája van-e kiválasztva.
- A böngésző az oldal régi változatát mutatja. Frissítsd az oldalt, vagy 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.