# Achievements (eredmények és jelvények)

> Pontok és jelvények a tanulóknak: eseményindítók, eredmények létrehozása, felugró értesítés, pontok beváltása kurzusvásárláskor, ranglista és shortcode-ok.

Az Achievements kiegészítő játékosítással növeli a tanulók kedvét: pontokat és/vagy jelvényeket adhatsz azért, amit a felhasználók a webhelyeden elérnek. A blokkokkal és shortcode-okkal az egyéni és a csoportos eredményeket ranglistán is megjelenítheted bárhol.

A kiegészítő aktiválásához a LearnDash LMS-nek telepítve és aktívnak kell lennie.

## Telepítés

1. Nyisd meg: **LearnDash LMS → Kiegészítők**, keresd meg az Achievements kiegészítőt, telepítsd, majd aktiváld. Aktív licenc kell hozzá.
2. Vagy töltsd fel kézzel a letöltött `.zip` fájlt a **Bővítmények → Új hozzáadása → Bővítmény feltöltése** oldalon, és aktiváld.

## Mi az eseményindító

Az eseményindító (trigger) az a felhasználói művelet, amelynek hatására a felhasználó megkapja az eredményt. Egy része a WordPresshez, más része a LearnDashhez kötődik.

**WordPress eseményindítók:**

- a felhasználó regisztrál
- a felhasználó bejelentkezik
- a felhasználó új bejegyzést ad hozzá
- a felhasználó hozzászólást ad hozzá
- a felhasználó meglátogat egy bejegyzést
- a felhasználó bejegyzését meglátogatják
- a felhasználó X egymást követő napon bejelentkezett

**LearnDash eseményindítók:**

- belép egy csoportba
- beiratkozik egy kurzusra
- befejez egy kurzust, leckét vagy témát
- sikeresen teljesít egy kvízt
- megbukik egy kvízen
- befejez egy kvízt
- a kvízeredmény meghalad egy százalékot
- feltölt egy feladatot
- jóváhagyják a feladatát
- kiértékelik az esszékérdését
- befejezett X kurzust vagy csoportot
- megszerzett X jelvényt vagy pontot (a pontok kurzusok vásárlására is felhasználhatók, ezért a jutalom a vásárlást is ösztönözheti)
- X egymást követő napon bejelentkezett (a mindennapi visszatérést jutalmazza)

## Eredmény létrehozása

1. Nyisd meg: **LearnDash LMS → Achievements**.
2. Kattints az **Add New Achievement** gombra.
3. Add meg az eredmény címét és a hozzá tartozó üzenetet.
4. Válaszd ki az eseményindítót.
5. Töltsd ki a **Details** doboz mezőit. Például a „X egymást követő napon bejelentkezett” indítónál meg kell adnod a napok számát, a jutalmazott pontokat és azt, hogy hányszor kaphatja meg a felhasználó az eredményt.
6. Szükség esetén módosítsd az eredmény webcímét (slug). Alapból automatikusan képződik.
7. A jobb oldalon állíts be képet, amely az eredményhez tartozik. Saját képet is feltölthetsz jelvénynek.
8. Kattints a **Publish** vagy **Update** gombra.

**Fontos:** az eredmény közzététele után az eseményindító és a hozzá kapcsolt kurzus, kvíz, lecke vagy téma már nem módosítható.

## Általános beállítások

A **LearnDash LMS → Achievements → Settings** oldalon az összes eredményre érvényes beállítások vannak. A felugró ablak (popup) azt a figyelmeztetést szabályozza, amely értesíti a felhasználót az eredményéről.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Popup Time** | Hány másodpercig látszik a felugró ablak. 0 esetén a felhasználónak az x gombbal kell bezárnia. | |
| **Position** | Hol jelenik meg a képernyőn: jobb felül, jobb alul, bal alul, bal felül, középen, felül középen, alul középen. | Top Right (jobb felül) |
| **Background Color** | A felugró ablak háttérszíne, színválasztóval. | fehér |
| **Text Color** | A szöveg színe. | sötétszürke |
| **RTL** | Jobbról balra író nyelvekhez (arab, héber, perzsa, urdu) kapcsold be, hogy az üzenet helyesen jelenjen meg. | |

### Jelvénybeállítások

A **Badge Settings** részben a jelvény méretét és a súgószöveg (tooltip) betűméretét állíthatod pixelben.

## Pontok felhasználása kurzusvásárláskor

Az eredménypontokkal kedvezményt adhatsz a kurzusvásárláskor, ami az elköteleződést is növeli.

1. Nyisd meg a kurzus beállításait.
2. Kattints az **Achievements** fülre.
3. Add meg a kívánt értéket, és mentsd.

**Megjegyzés:** jelenleg csak a „Buy Now” (vásárlás) hozzáférési módot támogatja.

## Beállítások rendszergazdáknak és csoportvezetőknek

A rendszergazda extra pontokat adhat egy felhasználónak:

1. Nyisd meg: **Felhasználók → Minden felhasználó**.
2. Válaszd ki a felhasználót.
3. Görgess le az **Achievements and User Points** részhez.
4. Add meg a plusz pontok számát.
5. Kattints a **Felhasználó frissítése** gombra.

A csoportvezetők a **LearnDash LMS → Achievements** oldalon látják a felhasználók listáját a megszerzett jelvényekkel együtt.

## Jelvények a frontenden

A webhelyen felugró ablak mutathatja a tanuló összes pontját és az eddig megszerzett jelvényeit, amikor új eredményt ér el. Ilyen például a „befejezett X kurzust vagy csoportot” indítóhoz tartozó jelvény, ha a tanuló három kurzust elvégzett.

## Shortcode-ok és blokkok

A **LearnDash LMS → Achievements** oldal **Shortcodes** fülén látod az elérhető shortcode-okat.

### Ranglista

A `[ld_achievements_leaderboard]` a felhasználókat és az eredményeik alapján kapott pontjaikat listázza.

- `number`: hány felhasználó jelenjen meg, például `[ld_achievements_leaderboard number="20"]`
- `show_points`: a pontok megjelenítése, például `[ld_achievements_leaderboard show_points=1]`

### Saját eredmények

Az `[ld_my_achievements]` a bejelentkezett felhasználó eredményeit mutatja az eredmény ikonjával. Az ikon fölé víve megjelenik a címe. A `show_points=1` paraméterrel a megszerzett pontok is látszanak: `[ld_my_achievements show_points=1]`.

A blokkszerkesztőben ugyanezek blokkként is elérhetők. A **LearnDash My Achievements** blokk beállításaiban kiválaszthatod, hogy a cím és a megszerzett pontok megjelenjenek-e. A frontenden a blokk a tanuló összes pontját és a megszerzett jelvényeit mutatja.