Shortcode-ok és blokkok

A shortcode-ok és a blokkok a LearnDash dinamikus tartalmait szúrják be a kurzusokba, oldalakba, bejegyzésekbe és más egyéni bejegyzéstípusokba. A tanúsítványokhoz saját shortcode-ok tartoznak (Tanúsítvány-shortcode-ok).

Shortcode vagy blokk?

Shortcode: a tartalomszerkesztő eredeti módja a dinamikus tartalom beszúrására. Oldalszerkesztőkben is használható, és paraméterekkel (beállításokkal) testre szabható. Példa egy paraméteres shortcode-ra: [ld_course_list num="10"].

Blokk: a WordPress 5.0-ban bevezetett blokkszerkesztőben érhető el. Ugyanazokat a funkciókat és beállításokat tartalmazza, mint a shortcode, de egyszerűbb felületen szúrhatod be és állíthatod be.

Minden shortcode-nak van megfelelő blokkja, és minden blokknak megfelelő shortcode-ja, funkcióbeli különbség nincs köztük. Hogy melyiket használd:

• Blokkszerkesztőnél (Gutenberg) bármelyiket, a blokkok általában könnyebbek.
• Klasszikus szerkesztő bővítménynél shortcode kell.
• Oldalszerkesztőknél (page builder) shortcode kell, mert a blokkok a legtöbbjükben még nem érhetők el.
• Widgetbe vagy oldalsávba shortcode kell, mert a blokkok a widgetekben nem használhatók.

A használatuk

Blokk beszúrása

A szerkesztőben kattints a + ikonra, keresd meg a blokkot név szerint (vagy görgesd a listát), és kattints rá. A beszúrás után a beállítások az oldalsávi blokkbeállítások panelen módosíthatók. A lehetőségek blokkonként eltérnek.

Shortcode használata

A shortcode-ok szögletes zárójelben ([ és ]) állnak: a shortcode neve, majd a kívánt paraméterek. Paraméter nélkül a felhasználó LearnDash-profilja:

[ld_profile]

Paraméterekkel, a kurzusok cím szerint növekvő sorrendjében:

[ld_profile orderby="title" order="ASC"]

Léteznek nyitó és záró taggel használt, feltételes shortcode-ok is. Ezek a bennük lévő szöveget csak akkor jelenítik meg, ha a feltétel igaz. A záró tag előtt perjel áll:

[student]Ezt csak a kurzusba beiratkozott tanuló látja.[/student]

Fejlesztők a shortcode-okat a do_shortcode() függvénnyel a téma fájljaiba vagy saját bővítménybe is beépíthetik.

Az összes blokk és shortcode

Általános blokkok és shortcode-ok

Blokk	Shortcode	Mit jelenít meg
LearnDash Profile	[ld_profile]	A felhasználó alapadatait (név, avatar), a kurzusok és a kurzuspontok számát, a beiratkozott kurzusok listáját, a kvízeredményeket és a megszerzett tanúsítványokat.
LearnDash User Course Points	[ld_user_course_points]	A felhasználó megszerzett kurzuspontjait.
LearnDash Course Progress	[learndash_course_progress]	Az adott kurzushoz tartozó előrehaladás-sávot.
LearnDash Course List	[ld_course_list]	A kurzusok listáját, sok szűrési és testreszabási lehetőséggel. A kurzusrács bekapcsolásakor rácsként jelenik meg.
LearnDash Lesson List	[ld_lesson_list]	A leckék listáját, a kurzuslistához hasonlóan.
LearnDash Topic List	[ld_topic_list]	A témák listáját, a kurzuslistához hasonlóan.
LearnDash Quiz List	[ld_quiz_list]	A kvízek listáját, a kurzuslistához hasonlóan.
LearnDash Group List	[ld_group_list]	A csoportok listáját, a kurzuslistához hasonlóan.
LearnDash Course Content	[course_content]	A kurzus leckéinek, témáinak és kvízeinek teljes listáját.
LearnDash User Groups	[user_groups]	Azoknak a csoportoknak a listáját, amelyekhez a felhasználó tanulóként vagy vezetőként tartozik.
LearnDash Course Expire Status	[ld_course_expire_status]	A kurzus lejárati dátumát az aktuális felhasználónak.
LearnDash Video	[ld_video]	A videót a lecke- vagy témaoldal tetszőleges pontján. Csak videós előrehaladásnál működik.
LearnDash Payment Buttons	[learndash_payment_buttons]	Az adott kurzus fizetési gombját az oldal bárhol.
LearnDash Course Info	[ld_course_info]	A regisztrált kurzusok listáját, a haladás részleteit és a kitöltött kvízeket.
LearnDash Login	[learndash_login]	Bejelentkezési hivatkozást, amely a LearnDash bejelentkezési és regisztrációs felugró ablakát nyitja.
LearnDash Certificate	[ld_certificate]	A megszerzett tanúsítvány letöltési hivatkozását.
LearnDash Resume Course	[ld_course_resume]	A kurzus utolsó lépésére visszavivő hivatkozást vagy gombot.
LearnDash Reset Password	[ld_reset_password]	Jelszó-visszaállító űrlapot.

Feltételes tartalom

Ezekkel a tartalmat csak bizonyos felhasználóknak vagy csoportoknak mutatod meg.

Blokk	Shortcode	Mikor jelenik meg a benne lévő tartalom
LearnDash Visitor	[visitor]…[/visitor]	Ha a felhasználó nincs beiratkozva a kurzusra.
LearnDash Student	[student]…[/student]	Ha a felhasználó be van iratkozva a kurzusra. Egyes felhasználóknak is megadható (azonosító alapján).
LearnDash Course Not Started	[course_notstarted]…[/course_notstarted]	Ha a felhasználónak van hozzáférése, de még nem fejezett be egy lépést sem.
LearnDash Course In Progress	[course_inprogress]…[/course_inprogress]	Ha a felhasználó legalább egy lépést befejezett, de a kurzust még nem.
LearnDash Course Complete	[course_complete]…[/course_complete]	Ha a felhasználó a kurzust teljesen befejezte.
LearnDash Quiz Complete	[ld_quiz_complete]…[/ld_quiz_complete]	Ha a felhasználó befejezett egy kvízt.
LearnDash Group Message	[ld_group]…[/ld_group]	A megadott csoport tagjainak. A csoport azonosítója kötelező.

A feltételes shortcode-oknál mindig kell nyitó és záró tag is.

A fontosabb shortcode-ok részletesen

A blokkok testreszabása minden blokknál ugyanúgy megy: a lent leírt paraméterek mind elérhetők a blokk oldalsávi beállításai között.

Profil ([ld_profile])

A bejelentkezett felhasználó tanulói profilját építi fel. Alapból ezt jeleníti meg:

• profilkép (avatar), név, a profil szerkesztésére mutató hivatkozás,
• a beiratkozott kurzusok, a befejezett kurzusok, a megszerzett tanúsítványok és a pontok összesített száma,
• a beiratkozott kurzusok listája: keresővel, előrehaladás-jelzőkkel, a tanúsítványok letöltési hivatkozásaival, valamint a kitöltött kvízekkel (dátum, pontszám, statisztika).

A profil tetején lévő gombbal az összes kurzus részletei egyszerre kibonthatók vagy összecsukhatók. A használatáról a Felhasználói profilok fejezetben is olvashatsz.

Paraméter	Mit csinál	Alapérték
per_page="10"	Hány kurzus jelenjen meg egy oldalon a lapozás előtt.
course_points_user="no"	Elrejti a megszerzett kurzuspontokat.	yes
expand_all="yes"	A profil minden részét kibontja.	no
orderby="title"	A kurzusok rendezési szempontja, az order paraméterrel együtt.	id
order="ASC"	A rendezés iránya: ASC vagy DESC.
profile_link="no"	Elrejti a profilhivatkozást.	yes
show_quizzes="no"	Elrejti a felhasználó kvízkísérleteit.	yes
show_search="no"	Elrejti a keresőt.	yes
show_header="no"	Elrejti a fejlécet.	yes
quiz_num="5"	Hány kvíz jelenjen meg oldalanként, ha a kvízek ki vannak bontva.	A per_page értéke

Kurzuspontok ([ld_user_course_points])

Egy sorban megjeleníti a felhasználó összes pontját, például: „Megszerzett kurzuspontok: 100”. Az összeg tartalmazza a kurzusokért kapott és a felhasználó WordPress-profiljában kézzel hozzáadott extra pontokat is. Egyedi felhasználói profiloldal építésénél lehet hasznos.

Egyetlen paramétere van: [ld_user_course_points user_id="5"] az 5-ös azonosítójú felhasználó pontjait mutatja. Paraméter nélkül a bejelentkezett felhasználóét.

Kurzus-előrehaladás ([learndash_course_progress])

Előrehaladás-sávot mutat az aktuális felhasználó adott kurzusban elért haladásáról. Általában kurzus-, lecke-, téma- vagy kvízoldalon használják, ilyenkor magától felismeri, melyik kurzusról és melyik felhasználóról van szó. Kurzuson kívül vagy egy adott felhasználóhoz:

• [learndash_course_progress user_id="5"]: egy adott felhasználó haladása
• [learndash_course_progress course_id="12"]: egy adott kurzus haladása

Oldalszerkesztővel épített egyedi kurzus-, lecke- és témaoldalakhoz is jól használható.

Kurzus-, lecke-, téma-, kvíz- és csoportlista

A [ld_course_list] a kurzusok listáját adja, sok paraméterrel. A kurzusrácsra a LearnDash-be beépített rács szolgál (a 4.21.4-es verziótól a Course Grid része a fő bővítménynek, külön kiegészítőt nem kell telepíteni).

A [ld_lesson_list] a leckéket listázza, és leginkább kurzusoldalon jó az alapértelmezett kurzus-tartalomjegyzék helyett. Töltsd fel az egyes leckék kiemelt képét, hogy az alapértelmezett helyőrző képeket lecserélje. Egy adott kurzus leckéihez: [ld_lesson_list course_id="12"].

A [ld_topic_list] a témákat listázza, leginkább egy több témát tartalmazó leckeoldalon. A lesson_id és a course_id paraméterrel szűrhető: [ld_topic_list lesson_id="34" course_id="12"]. A kiemelt kép itt is a helyőrző képeket váltja le.

A [ld_quiz_list] a kvízeket listázza. Akkor lehet hasznos, ha a kurzusnak több kvíze van. A kvízeket általában a kurzus tartalomjegyzékében, a kurzusnavigációban a természetes haladási helyükön, vagy a lecke- és témaoldalak alján (magától beszúrva) érdemes megjeleníteni. A lesson_id paraméterrel a megadott leckéhez tartozó kvízek listázhatók.

A [ld_group_list] a csoportokat listázza, és akkor hasznos, ha több, önként beiratkozható csoportod van. A kurzusráccsal együtt is használható.

Kurzus tartalma ([course_content])

A kurzusoldalon alapból megjelenő tartalomjegyzék pontos mása: a kurzushoz rendelt leckék, témák és kvízek teljes áttekintése a felhasználó haladásával. Megadható, hogy a leckékhez kötött témák és kvízek megjelenjenek-e. Minden elem mellett állapotikon mutatja, hogy a felhasználó hol tart.

Két hasznos felhasználása van:

• egyedi kurzus-nyitóoldalon (oldalszerkesztővel),
• WooCommerce, Easy Digital Downloads, MemberPress vagy más webáruház-megoldás értékesítési oldalán.

Ha nem kurzusoldalon használod, a course_id paraméter kötelező: [course_content course_id="12"] a 12-es azonosítójú kurzus tartalomjegyzékét mutatja.

Csoportjaim ([user_groups])

A felhasználó csoportjait listázza, tanulóként és vezetőként is.

Kurzus lejárata ([ld_course_expire_status])

Az aktuális felhasználó kurzushozzáférésének lejárati dátumát mutatja. A működéshez a kurzus szerkesztőjében be kell kapcsolni a hozzáférés lejáratát (Beiratkozás és hozzáférés). Kurzusoldalon magától felismeri a kurzust és a felhasználót. Az alapüzenetek:

• ha a lejárat a jövőben van: „Course access will expire on: {dátum}” (a felület fordítása szerint)
• ha már lejárt: „Course access expired on: {dátum}”

Paraméter	Mit csinál
label_before	A dátum előtti szöveg.
label_after	A dátum utáni szöveg.
format	A dátum formátuma (PHP-s dátumformátum). Alapból a WordPress dátumbeállítása érvényes.
course_id, user_id	A kurzus és a felhasználó azonosítója. Általában nem kell megadni, mert magától felismeri.

Példák:

[ld_course_expire_status label_before="Ez a kurzus lejárt: "]
[ld_course_expire_status label_after=". Újítsd meg a tagságod a hozzáféréshez."]
[ld_course_expire_status format="Y. m. d."]
[ld_course_expire_status format="Y. m. d." label_before="Ez a kurzus lejárt: " label_after=". Újítsd meg a tagságod." course_id="12" user_id="5"]

Videó ([ld_video])

Ennek a shortcode-nak nincs blokkja, a blokkszerkesztőben a Shortcode blokkal használhatod. Csak akkor működik, ha a lecke vagy a téma videós előrehaladást használ, be van kapcsolva és megadtál egy videó-webcímet (Lecke- és témamegjelenés, tartalmi beállítások). Alapból a videó a tartalom felett jelenik meg. Ha máshová szeretnéd, tedd a [ld_video] shortcode-ot önálló sorba a lecke- vagy témaoldal tartalmában. Paramétere nincs. Oldalszerkesztővel épített oldalakon a videó pontos elhelyezéséhez hasznos.

Fizetési gombok ([learndash_payment_buttons])

Csak akkor használd, ha a LearnDash alapértelmezett fizetési módjait használod (Stripe Connect, PayPal Checkout vagy 2Checkout). WooCommerce, MemberPress vagy más külső rendszer fizetésénél nem működik.

Ha a kurzus hozzáférési módja nem „nyitott”, a kurzusoldalon alapból megjelenik a „Kurzus felvétele” gomb, amely elindítja a fizetést. A shortcode-dal ezt a gombot máshová teheted, például egyedi nyitóoldalon. Ha nem kurzusoldalon használod, add meg a course_id paramétert: [learndash_payment_buttons course_id="12"].

Kurzusinfó ([ld_course_info])

A felhasználói profiloldal részeinek építéséhez jó. Három dolgot jelenít meg:

• a regisztrált kurzusok listáját indexképpel,
• a haladás részleteit: a kurzus állapotát (Nincs elkezdve, Folyamatban, Befejezve), a teljesített lépések számát (X a Y-ból) és a kezdés dátumát,
• a kitöltött kvízeket: a kvíz nevét (hivatkozással), a pontszámot, a kapott pontokat, a statisztikára mutató hivatkozást, a kitöltés dátumát és az értékelés állapotát.

A kinézet témától függően kissé eltérhet. Paraméterek (a blokkban is elérhetők):

Paraméter	Mit csinál
registered_show_thumbnail	true: mutatja, false: elrejti az indexképet.
registered_num	A megjelenített regisztrált kurzusok száma.
registered_orderby, registered_order	A regisztrált kurzusok rendezése (azonosító, cím, dátum stb.) és iránya (ASC vagy DESC).
progress_num	A haladási részben megjelenő kurzusok száma.
progress_orderby, progress_order	A haladási rész rendezése és iránya.
quiz_num	A megjelenített kvízek száma.
quiz_orderby, quiz_order	A kvízek rendezése és iránya.

A user_id megadása nem kötelező: ha kimarad, a bejelentkezett felhasználó azonosítóját használja.

Bejelentkezés ([learndash_login])

Bejelentkezési hivatkozást tesz oldalra, bejegyzésbe, oldalsávba vagy menübe. A kattintás a LearnDash bejelentkezési felugró ablakát nyitja. Bejelentkezett felhasználónál a hivatkozás „Kijelentkezés” lesz, és kattintásra kijelentkeztet. Csak akkor működik, ha a LearnDash bejelentkezés és regisztráció be van kapcsolva (Bejelentkezés és regisztráció).

Paraméterek (alapértékekkel):

'url'              => false,
'label'            => false,
'icon'             => false,
'placement'        => false,
'class'            => false,
'button'           => false,

'login_url'        => '',
'login_label'      => 'Bejelentkezés',
'login_icon'       => 'login',
'login_placement'  => 'left',
'login_class'      => 'ld-login',
'login_button'     => 'true',

'logout_url'       => '',
'logout_label'     => 'Kijelentkezés',
'logout_icon'      => 'arrow-right',
'logout_placement' => 'right',
'logout_class'     => 'ld-logout',
'logout_button'    => '',

Példa: [learndash_login logout_label="Saját kijelentkezés felirat"]

Tanúsítvány ([ld_certificate])

Letöltési hivatkozást ad a megszerzett tanúsítványhoz. A megjelenítéshez a course_id vagy a quiz_id közül legalább az egyik kötelező. Egy adott kvízhez tartozó tanúsítványnál mindkettő kell:

[ld_certificate course_id="123" quiz_id="456"]

Opcionális paraméterek:

• user_id: egy adott felhasználó hivatkozása (üresen: az aktuális felhasználó)
• group_id: egy adott csoport hivatkozása
• label: a gomb vagy hivatkozás felirata
• class: a hivatkozás HTML-osztálya
• context: a shortcode kezelőjének átadott, tetszőleges érték
• callback: saját visszahívó függvény az alapértelmezett megjelenítés helyett

Kurzus folytatása ([ld_course_resume])

Hivatkozást vagy gombot ad, amellyel a felhasználó gyorsan visszatérhet a kurzus utolsó lépéséhez.

• course_id: a kurzus azonosítója (kurzuson belül vagy kurzusoldalon kívül üresen hagyható, ilyenkor az utoljára aktív kurzust veszi)
• user_id: egy adott felhasználóhoz (üresen az aktuális)
• label: a hivatkozás vagy gomb felirata

Jelszó-visszaállítás ([ld_reset_password])

Jelszó-visszaállító oldalt készíthetsz vele: hozz létre egy oldalt, és szúrd be a blokkot vagy a shortcode-ot a kívánt helyre. Az űrlap szélessége a blokk beállításai között, shortcode-nál a szélesség paraméterrel állítható.

Feltételes tartalom részletesen

Ezekkel a blokkokkal és shortcode-okkal a tartalmat a beiratkozási állapot alapján mutathatod vagy rejtheted el. A tartalom lehet HTML, kép, videó vagy más médiatartalom. Mindegyik nyitó és záró taget kér:

[shortcode]és a záró tag[/shortcode]

Blokkszerkesztőben a blokk fölé víve egy kis jelzés mutatja, hogy a hozzáadott tartalom a feltételes blokkba kerül.

Elementor-sablonokban a feltételes shortcode-okhoz adhatod az autop="false" paramétert, hogy a nem kívánt <p> és <br> elemek ne jelenjenek meg a sablonban. Ez elrendezési hibákat előzhet meg.

Shortcode	Példa
[visitor]	[visitor course_id="12"]Ezt csak az látja, akinek NINCS hozzáférése a kurzushoz. Itt lehet regisztrációs űrlap vagy e-mailcím-gyűjtő.[/visitor]
[student]	[student course_id="12"]Ezt csak az látja, akinek VAN hozzáférése a kurzushoz.[/student]
[course_notstarted]	[course_notstarted course_id="12"]Ezt azok látják, akik még nem fejeztek be egy lépést sem. Bátoríthatod őket az indulásra.[/course_notstarted]
[course_inprogress]	[course_inprogress course_id="12"]Ezt azok látják, akik elkezdték, de még nem fejezték be a kurzust.[/course_inprogress]
[course_complete]	[course_complete course_id="12"]Ezt azok látják, akik teljesen befejezték a kurzust (minden lépést teljesítettek és a kötelező kvízeket letették). Itt lehet a tanúsítvány hivatkozása vagy ajánlott következő kurzusok.[/course_complete]
[ld_quiz_complete]	[ld_quiz_complete quiz_id="32"]Ezt azok látják, akik befejezték a kvízt.[/ld_quiz_complete]
[ld_group]	[ld_group group_id="32"]Ezt csak a 32-es azonosítójú csoport tagjai látják.[/ld_group]

A [visitor] leginkább magán a kurzusoldalon használatos, de egyedi értékesítési oldalon is jó a course_id megadásával.

A [student] shortcode többféleképpen szűkíthető:

• több kurzus egyszerre: [student course_id="4523,2894"]…[/student], ilyenkor csak az látja, akinek mindkét kurzushoz van hozzáférése,
• csoportra: a group_id paraméterrel, ugyanúgy, mint a course_id-nél,
• egy adott felhasználóra: [student user_id="5"]Ezt csak az 5-ös azonosítójú felhasználó látja.[/student].