Drupal
Telepítsd a Yaplet chat widgetet Drupal 10 vagy 11 alapú weboldalra az ingyenes Asset Injector modullal. Az oldal adminisztrátorainak és fejlesztőinek.
Áttekintés
A Drupal alapból nem tud szkriptet tenni minden oldalra. Az ingyenes Asset Injector modul ad ehhez egy beállítást: illeszd be a Yaplet kódot egy JS injectorba, és a chat widget az egész oldalon megjelenik. Az Asset Injector a Drupal 10.3-as és újabb verzióival működik, a Drupal 11-gyel is, és a stabil kiadásaira a Drupal biztonsági figyelmeztetési szabályzata vonatkozik.
Telepítési lépések
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'
Ezután 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, minden oldalra tehet JavaScriptet.
Másold ki a Yaplet kódodat
A Yaplet vezérlőpulton menj a Márka → Chat widget menüpontra, és nyisd meg a Telepítés fület. 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.
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, és kattints az Add JS Injector (JS injector hozzáadása) gombra.
Írj a Label (Név) mezőbe egy nevet, amelyről később is ráismersz (például Yaplet chat), illeszd be a 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, hogy a kód minden oldalon betöltődjön, majd 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 oldalon szeretnéd látni, a Current Theme (Jelenlegi téma) feltételnél válaszd ki az oldal nyilvános témáját.
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.
Hibaelhárítás
- 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 oldal 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 egy privát ablakban.