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

> A tanúsítványokon használható shortcode-ok: usermeta, courseinfo, quizinfo, groupinfo és az osztályzati napló pontszáma.

A tanúsítvány-shortcode-ok kizárólag LearnDash-tanúsítványokon használhatók. Dinamikus adatot jelenítenek meg a tanulóról, valamint a tanfolyamról, kvízről vagy csoportról, amelyért a tanúsítványt kapja: a nevét, a tanfolyam címét, a teljesíté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 működik |
| --- | --- | --- |
| `[usermeta]` | a felhasználó adatai | mindig |
| `[courseinfo]` | a tanfolyam adatai | csak tanfolyamhoz rendelt tanúsítványon |
| `[quizinfo]` | a kvíz adatai | csak kvízhez rendelt tanúsítványon |
| `[groupinfo]` | a csoport adatai | csak csoporthoz rendelt tanúsítványon |

A **LearnDash LMS → Tanúsítványok** oldal **Shortcode-ok** füle is a tanúsítványokhoz tartozó shortcode-okról szól.

## [usermeta]

A felhasználó adatait jeleníti meg a `field` paraméter szerint.

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

A leggyakrabban a `first_name` és a `last_name` kell, mert szinte minden tanúsítványon szerepel a tanuló neve.

Nem minden érték kerül rögzítésre, amikor a tanuló regisztrál vagy tanfolyamot vásárol: a különböző regisztrációs módok különböző adatokat gyűjtenek. Nézd meg a webshop vagy a fizetési megoldás beállításait, vagy ellenőrizd a **Felhasználók → Minden felhasználó** oldalon egy felhasználó szerkesztésével.

## [courseinfo]

Csak tanfolyamhoz rendelt tanúsítványon használd. Két fogalom a pontszámos értékekhez:

- **aggregate** (összesített): a tanfolyamhoz rendelt összes kvíz összege,
- **cumulative** (átlagos): a tanfolyamhoz rendelt összes kvíz átlaga.

| Érték (`show=`) | Megjelenített adat |
| --- | --- |
| `course_title` | a tanfolyam címe |
| `course_price` | a tanfolyam ára (csak egyszeri fizetésű tanfolyamnál) |
| `course_price_type` | a tanfolyam hozzáférési módja |
| `course_url` | a tanfolyam webcíme |
| `course_points` | a tanfolyamon elérhető összes pont |
| `user_course_points` | a tanuló által a tanfolyamon szerzett pontok |
| `enrolled_on` | a beiratkozás dátuma (nyitott tanfolyamra nem vonatkozik) |
| `completed_on` | a teljesítés dátuma |
| `user_course_time` | a tanfolyamon eltöltött összes idő |
| `cumulative_score` | a tanfolyam összes értékelt részének átlagos pontszáma |
| `cumulative_points` | az átlagosan szerzett pontok |
| `cumulative_total_points` | az átlagosan szerzett pontok |
| `cumulative_percentage` | a tanfolyam összes kvízének átlagos százaléka |
| `cumulative_timespent` | a tanfolyam egyes részeire fordított átlagos idő |
| `aggregate_score` | a tanfolyamra kapott végső pontszám |
| `aggregate_points` | a tanfolyamon összesen szerzett pontok |
| `aggregate_total_points` | a tanfolyamon összesen szerzett pontok |
| `aggregate_percentage` | a tanfolyam kvízeinek összesített százalékos eredménye |
| `aggregate_timespent` | a tanfolyam kvízeire fordított összes idő |

Példa: `[courseinfo show="course_title"]`.

A `completed_on` (és az időpontot mutató értékek) mellé megadhatsz dátumformátumot a `format` paraméterrel. A formátumjelölések ugyanazok, mint a WordPress dátum- és időformázásánál:

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

Magyaros dátumot például a `Y. F j.` formátum ad.

## [quizinfo]

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

| Érték (`show=`) | Megjelenített adat |
| --- | --- |
| `score` | a kvízre kapott pontszám |
| `count` | a kvíz kérdéseinek száma |
| `pass` | a kvíz teljesítéséhez szükséges pontszám |
| `timestamp` | a kvíz befejezésének napja és ideje |
| `points` | a tanuló által a kvízen szerzett pontok |
| `total_points` | az adott próbálkozásban elérhető összes pont |
| `percentage` | a kvízen elért százalékos eredmény |
| `quiz_title` | a kvíz neve |
| `course_title` | a kvízhez tartozó tanfolyam neve |
| `timespent` | a kvíz kitöltésére fordított idő |

A `timestamp` dátumformátuma itt is megadható:

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

## [groupinfo]

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

| Érték (`show=`) | Megjelenített adat |
| --- | --- |
| `group_title` | a csoport címe |
| `group_url` | a csoport webcíme |
| `group_price_type` | a csoport hozzáférési módja |
| `group_price` | a csoport ára |
| `group_users_count` | a csoport tagjainak száma |
| `group_courses_count` | a csoportban lévő tanfolyamok száma |
| `user_group_status` | a tanuló haladási állapota a csoportban |
| `enrolled_on` | a tanuló csoportba lépésének dátuma |
| `completed_on` | a dátum, amikor a tanuló a csoport összes tanfolyamát teljesítette |
| `percent_completed` | a csoport tanfolyamain elért eredmény |

A dátumot mutató értékeknél itt is használhatod a `format` paramétert:

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

## Osztályzati napló pontszáma

Egy adott osztályzati napló (Gradebook) pontszámát is kiírhatod a tanúsítványra. A shortcode a bejelentkezett tanuló eredményét mutatja, a tanúsítványon bárhová beteheted:

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

Az azonosító megkereséséhez:

1. Nyisd meg a **LearnDash LMS → Gradebook** oldalt.
2. A naplók kezelésénél keresd meg a kívánt naplót, és vidd fölé az egérmutatót a neve fölé.
3. A böngésző alján látható webcímben szerepel a napló azonosítója.

A shortcode csak akkor ír ki pontszámot, ha megadod a napló azonosítóját.