Tanúsítvány-shortcode-ok

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:

[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ó:

[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:

[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:

[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.