# Tanúsítvány-shortcode-ok

> A tanúsítványon tanulónként változó adatokat megjelenítő [usermeta], [courseinfo], [quizinfo] és [groupinfo] shortcode-ok, valamint az [ld_overall_grade].

A tanúsítvány-shortcode-ok kizárólag a LearnDash-tanúsítványok készítéséhez valók. Segítségükkel dinamikus adatokat jeleníthetsz meg a tanulóról, valamint a kurzusról vagy kvízről, amelyért a tanúsítványt adod: a tanuló nevét, a kurzus címét, a befejezés dátumát, a kvíz eredményét és még sok mást.

Négy fő shortcode van, mindegyiknek több paramétere:

| Shortcode | Mit jelenít meg | Mikor használható |
|---|---|---|
| `[usermeta]` | a felhasználó adatai | mindig |
| `[courseinfo]` | a kurzus adatai | csak kurzushoz rendelt tanúsítványnál |
| `[quizinfo]` | a kvíz adatai | csak kvízhez rendelt tanúsítványnál |
| `[groupinfo]` | a csoport adatai | csak csoporthoz rendelt tanúsítványnál |

A tanúsítványokhoz tartozó shortcode-ok a **LearnDash LMS → Tanúsítványok** menüpont **Shortcode-ok** fülén is elérhetők. Az oldal ennél a telepítésnél csak egy külső dokumentációra mutató hivatkozást tartalmaz.

## [usermeta]

| Shortcode | Mit jelenít meg |
|---|---|
| `[usermeta field="first_name"]` | a felhasználó keresztneve |
| `[usermeta field="last_name"]` | a felhasználó vezetékneve |
| `[usermeta field="display_name"]` | a megjelenített név, amely gyakran a kereszt- és a vezetéknév együtt |
| `[usermeta field="user_login"]` | a felhasználónév |
| `[usermeta field="nickname"]` | a becenév (regisztrációkor nem biztos, hogy rögzül) |
| `[usermeta field="user_email"]` | az e-mail-cím |
| `[usermeta field="user_url"]` | a weboldal címe (valószínűleg nem rögzül regisztrációkor) |
| `[usermeta field="description"]` | a bemutatkozás (valószínűleg nem rögzül regisztrációkor) |
| `[usermeta field="id"]` | a WordPress által adott egyedi felhasználóazonosító (a regisztráció sorrendjében) |

A leggyakoribbak a `[usermeta field="first_name"]` és a `[usermeta field="last_name"]`, mert szinte minden tanúsítványon szerepel a tanuló neve.

Nem minden adat gyűlik össze, amikor a tanuló regisztrál vagy kurzust vásárol: a különböző regisztrációs módszerek különböző adatokat kérnek. Nézd meg a webáruházad vagy a pénztárad beállításait, hogy mely mezők kerülnek rögzítésre. Ellenőrizheted a **Felhasználók → Összes felhasználó** menüben is: kattints egy felhasználóra, és nézd meg a profilját.

## [courseinfo]

Csak kurzushoz rendelt tanúsítványnál használd. Két fogalom:

- **Aggregate** (összesített): a kurzushoz rendelt összes kvíz összege.
- **Cumulative** (átlagolt): a kurzushoz rendelt összes kvíz átlaga.

| Shortcode | Mit jelenít meg |
|---|---|
| `[courseinfo show="course_title"]` | a kurzus címe |
| `[courseinfo show="course_price"]` | a kurzus ára (csak egyszeri fizetésű kurzusnál) |
| `[courseinfo show="course_price_type"]` | a kurzus hozzáférési módja |
| `[courseinfo show="course_url"]` | a kurzus webcíme |
| `[courseinfo show="course_points"]` | a kurzusért elérhető összes pont |
| `[courseinfo show="user_course_points"]` | a felhasználó által a kurzusért szerzett pontok |
| `[courseinfo show="enrolled_on"]` | a kurzusra beiratkozás dátuma (nyitott kurzusnál nem alkalmazható) |
| `[courseinfo show="completed_on"]` | a kurzus befejezésének dátuma |
| `[courseinfo show="user_course_time"]` | a kurzusra fordított összes idő |
| `[courseinfo show="cumulative_score"]` | a kurzus összes értékelt részének átlagpontszáma |
| `[courseinfo show="cumulative_points"]` | az átlagosan szerzett pontok |
| `[courseinfo show="cumulative_total_points"]` | az átlagosan szerzett pontok |
| `[courseinfo show="cumulative_percentage"]` | a kurzus összes kvízének átlagos százaléka |
| `[courseinfo show="cumulative_timespent"]` | a kurzus egyes részeire fordított átlagos idő |
| `[courseinfo show="aggregate_score"]` | a kurzusra kapott végső pontszám |
| `[courseinfo show="aggregate_points"]` | a kurzusért szerzett összes pont |
| `[courseinfo show="aggregate_total_points"]` | a kurzusért szerzett összes pont |
| `[courseinfo show="aggregate_percentage"]` | a kurzus részeként kitöltött összes kvíz összesített százalékos eredménye |
| `[courseinfo show="aggregate_timespent"]` | a kurzus kvízeire fordított összes idő |

A `completed_on` paraméternél a dátum formátumát is megadhatod a `format` paraméterrel (a WordPress dátumformátum-jelöléseivel):

```text
[courseinfo show="completed_on" format="F j, Y"]
```

## [quizinfo]

Csak kvízhez rendelt tanúsítványnál használd, kurzushoz rendelt tanúsítványon nem működik.

| Shortcode | Mit jelenít meg |
|---|---|
| `[quizinfo show="score"]` | a kvízre kapott pontszám |
| `[quizinfo show="count"]` | a kvízben lévő kérdések száma |
| `[quizinfo show="pass"]` | a kvíz sikeres teljesítéséhez szükséges pontszám |
| `[quizinfo show="timestamp"]` | a kvíz befejezésének napja és ideje |
| `[quizinfo show="points"]` | a kvízben szerzett pontok |
| `[quizinfo show="total_points"]` | egy kitöltésnél elérhető összes pont |
| `[quizinfo show="percentage"]` | a kvízen elért százalékos eredmény |
| `[quizinfo show="quiz_title"]` | a kvíz neve |
| `[quizinfo show="course_title"]` | annak a kurzusnak a neve, amelyhez a kvíz tartozik |
| `[quizinfo show="timespent"]` | a kvíz kitöltésével töltött idő |

A `timestamp` paraméternél itt is megadhatod a dátum formátumát:

```text
[quizinfo show="timestamp" format="F j, Y"]
```

## [groupinfo]

Csak csoporthoz rendelt tanúsítványnál használd, kurzushoz vagy kvízhez rendelt tanúsítványon nem működik.

| Shortcode | Mit jelenít meg |
|---|---|
| `[groupinfo show="group_title"]` | a csoport címe |
| `[groupinfo show="group_url"]` | a csoport webcíme |
| `[groupinfo show="group_price_type"]` | a csoport hozzáférési módja |
| `[groupinfo show="group_price"]` | a csoport ára |
| `[groupinfo show="group_users_count"]` | a csoport tagjainak száma |
| `[groupinfo show="group_courses_count"]` | a csoportban lévő kurzusok száma |
| `[groupinfo show="user_group_status"]` | a felhasználó előrehaladási állapota a csoportban |
| `[groupinfo show="enrolled_on"]` | a csoportba beiratkozás dátuma |
| `[groupinfo show="completed_on"]` | a csoporthoz rendelt összes kurzus befejezésének dátuma |
| `[groupinfo show="percent_completed"]` | a csoport kurzusaiban elért eredmény |

Dátumnál a formátum itt is megadható a `format` paraméterrel, például `[groupinfo show="completed_on" format="F j, Y"]`.

## Értékelőnapló-pontszám: [ld_overall_grade]

Ha használod az Értékelőnapló (Gradebook) funkciót, egy adott értékelőnapló pontszámát is kiírathatod a tanúsítványra. A shortcode a bejelentkezett felhasználó pontszámát jeleníti meg, a tanúsítvány bármely pontján:

```text
[ld_overall_grade gradebook="[az azonosítód]"]
```

Az azonosító megtalálása:

1. Lépj a **LearnDash LMS → Gradebook** menüpontra.
2. Az értékelőnaplók kezelésénél vidd az egeret az adott értékelőnapló neve fölé: az azonosító a képernyő alján, a böngésző állapotsorában jelenik meg.

A shortcode csak akkor jeleníti meg a pontszámot, ha megadod az értékelőnapló azonosítóját.