Moodle/Elearning/KMOOC manual

Moodle/Elearnig/KMOOC manual

Ez a userscript Moodle/Elearnig/KMOOC tesztek megoldása során segítséget jelenít meg.

A válasz ablakban jobb felül lévő százalék jelzi, hogy mekkora eséllyel jó a megoldás. Ez sokszor jó viszonyítás, de semmi sem biztos! Bármikor előfordulhat, hogy nem jó a megjelenített válasz! Ezért csak saját felelőségedre használd! Sok kikerülhetetlen hibalehetőség van, amit egyszerű nem lehet scriptben lekezelni (Pl rosszul megadott kérdés tanár részéről). Kézzel is lehet keresni a elmentett kérdések között. Ezért mindég legyen egy letöltött verziód a kérdésekről, mert nem 100% hogy mindég elérhető a szerver! Továbbá ha a moodle oldalán a layout megváltozik, a script nem fog működni! Ez nem annyira gyakori, de bármikor megtörténhet! Érdemes nem kikapcsolni a tampermonkey-ban a userscript frissítést. Ez nem windows update, itt tényleg hibajavítások jönnek ki. Hiba, észrevétel esetén : Script Feedback (ezt gyakran még aznap megnézem.

Továbbá ez a userscript HTTP requestekket küldhet egy szerver felé (ha ezt engedélyezed), ahova az összes megoldott teszteid kérdéseit és (helyes)válaszait feltölti! Ezzel garantálja, hogy neked, és mindenki másnak a legfrissebb adatok állnak rendelkezésre. Ezt letilthatod, ha a menüben a helyi fájl használatát választod, vagy a userscript kiegészitődnél nem engeded meg ezeket a kéréseket továbbítani. Ez alapból engedélyezve van,

Tartalomjegyzék

Használat

Ha először használod, olvasd el a lenti beüzemelés részt.

Ha másodszor, és tesztet akarsz megoldani, akkor először nézd meg a menüben, hogy aktív-e a tárgyad. Teszt közben a script a megadott tárgy már lementett kérdéseiből próbál segíteni.

Teszt végén teendők ha helyi fájlban vannak az adatjaid: Ha egy teszt végére értél, akkor megjelenik a megoldásos oldal, ahol minden kérdés fel van sorolva. Itt a script szépen öszegyűjti a kérdés/válasz kombókat, aztán feldob egy ablakot, amire kattintva ezt megjeleníti. Az ott megjelenített kérdéseket be kell másolnod a .txt-be, a megfelelő tárgy után (+tárgynév...). Userscript nem tud fájlba írni.

Teszt közben még több dolog történhet:

  • Nem jó kérdésre ad választ a script: Ilyenkor az van, hogy nincs meg a kérdés a txt-ben, vagy több hasonló kéréds/válasz van. Ilyenkor a jobbra/balra gombal váltogathatsz azok a kérdés/válasz kombók közül, amit talált a script
  • Több teszt kérdés van egy odalon: Fel le gombal váltogathatsz a kérdések között. Ilyenkor is működik az előbb említett funkció. Az indexek, amit kiír a bal felső sarokban: aktuális kérdés száma / aktuális találat száma.
  • Nem jelenik meg semmi, vagy nem működik a script: Megesik az ilyesmi. Ekkor megnyithatd a kérdések filet, és oldschool CTRL-F el keresgethetsz. Na, azért még mindég jobb mint a semmi!

A script radiobuttonos, tickboxos, képes és szöveges kérdéseknél is jól működik. Egyéb típusú kérdésekre nincsen (nagyon) felkészítve.

Egyéb funkciók:
  • Ha esetleg videókat nézel, akkor spacel lehet play/pausolni, és jobra/balra gombbal ugrani a videóban.
  • Menüben el lehet rejteni a kérdéseket a felugró ablakról, így az kisebb helyet foglal, de így nem bírod ellenőrizni, hogy tényleg jó kérdés/választ talált-e.
  • Ugyanitt az üdvözlő üzenetet is el lehet rejteni. Ez frissítésnél vagy hibánál ígyis úgyis megjelenik, mert azok nagyából fontosak.
  • Ha bármikor nem kell a scirpt, simán kapcsold ki tampermonkeyban. Ha bármiért is el akarod tüntetni a következő oldalig az éppen megjelenő script ablakot, akkor középső egérgombal kattintva rajta ezt megteheted.

Fontos hogy kijelöld a tárgyat amit szeretnél "tanulni" mielőtt nekikezdesz. Ha egy olyan tárgynak kezdesz neki, ami még nincs benne az adatbázisban, akkor az új tárgyként fog bekerülni (obviously). De azt neked kell utánna aktívnak jelölnöd! Ha nem használsz egy tárgyat, akkor kapcsold ki, mert picit lassú lehet!

TL; DR:

Olvasd csak el. Az öszes bonyodalom abból adódik, hogy a tampermonkey API-je korlátozott, és néhány dolgot neked kell megcsinálni, megérteni. Ha az online kérdéseket használod, akkor nagy eséllyel semmi teendőd, de azért jó ha tudod hogy működik, ha esetleg valami elromlik teszt közben, tudd hogy lehet megcsinálni gyorsan. Legyen mindég nálad egy másolat az online kérdésekről, mert bármikor eltűnhet! 		img

Eddigi teszt kérdések:

Eddigi összes kérdés Használat: Ha régi módszerrel fájlból olvasod be a kérdéseket, akkor abba kell bemásolni az egészet. Továbbá ez még arra jó, hogy ha valamiért bug-os a script, akkor itt tudsz ctrl-f ezgetni, vagy ha lemented az összes kérdést, akkor még akkor is biztonságban vagy, ha netán leáll a szerver, vagy elmegy a neted.

Beüzemelés (online)

1.5-ben bekerült egy új feature, ez pedig az, hogy szervertől szedi a kérdéseket a script. Elküldött, és letöltött adatokról lentebb tudsz olvasni. 3 opció elérhető, amit a menüben lehet álligatni:

  • Helyi fájlból: a script a forráskódban általad megatodd útvonalon található fájlból olvassa be a kérdéseket, és ott keres. A tesztek végén mindég be kell másolnod az új kérdéseket. Erről a következő szekció mesél többet
  • Neteről: interneten hostolt adatbázis letöltése, és használata. Mindkét verzióhoz azonnal feltölti az éppen megoldott tesztek kérdés-válaszait, ezért azonnal látnod kell(ene) azokat.
    • Karbantartott: Ez garantáltan működik, válogatott kérdések vannak benne. Viszont nem a legfrissebb.
    • Szabadon szerkeszthető: Legfrisebb kérdések. Ezt bárki szerkesztheti, nem csak jó szándékból!
A weboldal működése:
Egyik oldalon egy szerkeszthető textbox található (bal). Ez a nem karbantartott adat. Ezt bárki szerkesztheti, és azonnal életbe lép minden változtatás, szóval óvatosan. Elvileg ellenőrzi, hogy helyes-e a bevitt adat, de ez nem bomba biztos. Másik oldaloni (jobb) egy read-only, stabil adatbázis van, ami manuálisan van karban tartva, és biztosan működik.

Ha online adatokat használsz, akkor a tesztek végén automatikusan el lesznek küldve az új kérdések, és hozzá lesznek adva a nyílt végére. Így azonnal frissül neked, és másoknak is az adatbázis. Ezért nem válalok felelősséget, és hibák is lehetnek benne. Ezeket nyugodtan kijavíthatod. Időnként ezek bekerülnek a stabilba. Ajánlott ezeket lementeni, mivel nincs garancia a szerver folyamatos működésére! Legalul egy textbox van, ahol minden lelki bánatodat elküldheted.

Beüzemelés (helyi adatokkal)

Ha netről használod a kérdéseket, akkor ezt a részt kiskippelheted. De csak ezt

Ezt minden frissítésnél el kell játszanod, mert az egész script (beleértve az elérési utadat) felülíródik. Frissítés után a 3. pontot ismételd.
  • 1. : Greasyfork-ról telepítsd a scriptet. Ha ezt látod, akkor ez nagy esélyel sikerült.

    2. :
    • a/ Ha van kérdés adatbázisod. Ugorj a 3.-as pontra.

    • b/ Ha nincs kérdés adatbázisod. Hozz létre egy üres .txt-filet, vagy fentebb az Eddigi kérdések pontnál tölts le párat. Inditásnál ha üres a file, akkor hibát jelez, de miután feltöltöd nem kellene. Ha több tárgyat szeretnél használni, akkor feltétlen olvasd el az ez alatti útmutatót!
  • 3. : Nyisd meg a tampermonkey-d. Böngésző jobbfelsősarkánál nagy esélyel van tampermonkey ikon. Katt, majd dashboard. Ott fel lesz sorolva egy pár script. Válaszd ki az Elektro help-et.
    Rögtön az elején látsz csomó cuccot.// ==UserScript== meg @name meg ilyesmi. Keresd meg a @resource taget.
    Most jön a .txt-d. Az elérési útját másold be, hogy nagyából hasonló legyen:

    // @resource data file:///D:/OE/Elektronika/Elektro%20All%20ELearning.txt

    Ide másold be a sima elérési utat, majd convert! Ezután az eredményt bemásolhatod a @resouce taghoz. kiterjesztésről (.txt) ne feledkezz meg ;)
    Másik jó megoldás, hogy a fájlodat megnyitod böngészöben, és az url-jét másolod be a script fejlécébe.
    Ez csak windowson jó, ha netán Mac-et vagy GNU/Linux-ot használsz akkor írj feedback-et az oldalon, és leírom hogy kell.

  • 4. : Kész! Mentsd el, és hf. Nagy esélyel először hibával fogsz találkozni. Dont worry! A Hibák részben pont ezt fogom leírni.

Több tárgy kérdéseinek használata helyi adatokkal: (1.2)


Röviden: Kérdések +tárgynév sorral elválasztva külön tárgynak számítanak

Hosszabban: Vegyük például, hogy Elektornika, és Jazz kérdésekre szeretnéd használni a scriptet. Ekkor a .txt-d két részre lesz fel osztva a következő módon: Első sora: "+Elektró (moodle)". Ez a neve annak a tárgynak, amihez a sor után következő kérdések tartoznak, mindaddíg, amíg egy másik "+" kezdetű sor nem következik. Ha ez történik, akkor meg kell adnod a következő tárgy nevét, ez esetben: "+Jazz (kmooc). Ebből tudja a script, hogy ez egy másik tárgy. Minden kmooc és moodle oldalon megjelenik egy Menü a jobb alsó sarokban, amire kattintva ki bírod választani, hogy mely tárgy legyen aktív. Ha valamely tárgy aktív, akkor a script a tárgy kérdései közül fogja keresni a választ az aktuális kérdésre. Ha egy sincs bejelölve, akkor nem lesz találta soha.

A jobb alsó sarokban 1.2 óta található egy menü gomb. Ha rákattintasz, akkor megjelenik egy új ablak az oldal közepefele. Ezt be tudod zárni, vagy a listázott tárgyakat tudod aktiválni/inaktiválni. Ha egy tárgy aktív, akkor annak a kérdés-válaszai között keres a script választ az aktuális kérdésre.

Beolvasott kérdések struktúrája

A .txt-ben "?" jelöli a kérdést, "!" a választ, ">" a kérdéshez tartozó képneveket (ez optimális) és "+" a tárgy nevét. Ami más karakterrel kezdődik, és kérdés előtt van, az figyelmen kívül van hagyva, egyéb helyen hibát eredményezhet egy ismeretlen sor! Ha új tárgyat szeretnél hozzáadni, egyszerűen másold be az aljára a kérdéseket sorban, egy új +[tárgynév]-el kezdődő sor után. Ha online adatokat szerkesztesz, akkor ezt érdemes tudni, küldönben elronthatod!

Gyakran előforduló kérdések

Jogosultságok:
GM_openInTab: help megnyitása új lapon, GM_xmlhttpRequest: online adatbázishoz. GM_getResourceText: a txt beolvasáshoz. Mást nem bír beolvasni, csak amit megadsz a @resouces tagnál. GM_info: a scriptről információ, a verzióváltozás érzékeléséhez. GM_getValue/ GM_setValue: oldal bezárásakor megmaradó változók kezelése. Előző verzió tárolására, ugyanúgy verzióváltozás érzékeléséhez, néhány beállítás, illetve hogy melyik tárgyakból keressen kérdéseket. Ezek függvények, és a sciptben néhol meg vannak hívva, keresd meg.

Elküldött adatok online módban: Minden teszt végén az összes kérdés, és rá a moodle szerint helyesnek vélt válaszok. Fogadott adatok: az összes eddig ismert moodle kérdés

Script Greasyforkon | Script Feedback | Weboldal