# Certificate Builder (tanúsítványkészítő)

> Tanúsítvány tervezése a blokkszerkesztővel: háttérkép, LearnDash-blokkok, saját betűtípusok, előnézet és gyakori kérdések.

A Certificate Builder kiegészítővel a tanúsítványokat a beépített blokkszerkesztőben (Gutenberg) tervezheted meg vizuálisan. A kiegészítő működéséhez a LearnDash LMS kell. A tanúsítványok általános kezelését a [Tanúsítvány létrehozása](https://hub.hellowp.io/hu/plugins/sfwd-lms/feladatok-tanusitvanyok-tanusitvany-letrehozasa/) fejezet írja le.

## Telepítés

1. Nyisd meg: **LearnDash LMS → Kiegészítők**, keresd meg a Certificate Builder kiegészítőt, kattints a telepítésre, majd az aktiválásra. Aktív licenc kell hozzá.
2. Vagy töltsd le a kiegészítő fájlját, a **Bővítmények → Új hozzáadása** oldalon kattints a **Bővítmény feltöltése** gombra, tallózd ki a `.zip` fájlt, telepítsd és aktiváld.

## Használat

A blokkszerkesztő használatához a tanúsítvány oldalán a **Use Certificate Builder** gombra kell kattintanod.

1. Nyisd meg: **LearnDash LMS → Certificates**.
2. Kattints az **Add New** gombra.
3. A tanúsítvány oldalán kattints a **Use Certificate Builder** gombra, így belépsz a blokkszerkesztőbe.

A kurzusok és kvízek létrehozása után a tanúsítványt hozzárendelheted a kurzushoz, kvízhez vagy csoporthoz, így a befejezéskor megkapják.

**Megjegyzés:** ha egy már működő tanúsítványon használod a készítőt, annak tartalmát a blokk váltja fel. Új tanúsítványhoz használd.

### Cím

A cím csak a háttérben látszik. Ha több kurzushoz használod, legyen általános (például „Kurzus tanúsítvány”). Ha egy kurzushoz vagy kvízhez készül, tehetsz bele annak nevét.

### Háttér

Az első képernyő a médiafeltöltő: a folytatáshoz kötelező háttérképet megadni. Ezután más blokkokkal rendezheted el a tanúsítvány elemeit, amelyek a háttérkép tetejére kerülnek.

Ha olyan bővítményt használsz, amely a médiafájlokat külső tárhelyre teszi, hibaüzenetet kaphatsz a hiányzó háttérképről. Ilyenkor a háttérképnek a saját szervereden kell lennie.

### Tartalom

Bármilyen blokkot használhatsz, akár dinamikus tartalmat is. A LearnDash négy blokkot ad a tanúsítványokhoz:

| Blokk | Mit jelenít meg |
|---|---|
| **LearnDash Course Info** | Kurzusadatok, például befejezés dátuma, kurzus címe, kurzuspontok. |
| **LearnDash Quiz Info** | Kvízadatok, például kvíz címe, pontszám, időbélyeg. |
| **LearnDash User Meta** | Felhasználói adatok, például keresztnév, vezetéknév, felhasználónév. |
| **LearnDash Groups Info** | Csoportadatok, például csoport címe, befejezés ideje, befejezettségi százalék. |

**Fontos:** kurzushoz rendelt tanúsítványon a Course Info, kvízhez rendelten a Quiz Info blokkot használd. Ha a Quiz Info blokkot tartalmazó tanúsítványt kurzushoz rendeled, az adat nem jelenik meg.

További blokkokat (például dinamikus dátum vagy kép) más bővítményekkel is szerezhetsz.

### Betűtípusok

Saját betűtípust a következő blokkokhoz állíthatsz be a szerkesztő jobb oldali **Block Settings** részében: Heading, LearnDash Usermeta, LearnDash Courseinfo, LearnDash Groupinfo.

Saját betűtípus feltöltése:

1. Nyisd meg: **LearnDash LMS → Certificates → Fonts**.
2. Adj címkét a betűtípusnak.
3. A megfelelő stílusnál kattints a **Choose File** gombra, és tallózd ki a fájlt a gépedről.
4. Kattints a **Save Changes** gombra.

A feltöltés után a készítőben kiválaszthatod a betűtípust. Kereskedelmi célú használathoz győződj meg arról, hogy rendelkezel a szükséges licenccel a betűtípushoz.

### Előnézet

A készítő valós adatokkal mutatja a tanúsítványt.

1. A készítőben kattints a **Preview** gombra.
2. Válaszd a **Desktop** nézetet (vagy a „Preview in new tab” lehetőséget).
3. A tanúsítványt PDF formában nézheted meg.

Az előnézet az aktuális felhasználó adatait használja. Hogy a dinamikus adatok megjelenjenek, hozz létre egy tesztkurzust vagy tesztkvízt, rendeld hozzá a tanúsítványt, és teljesítsd. Utána a készítőben szerkeszthetsz, és az előnézettel ellenőrizheted.

Végül kattints az **Update** gombra, és rendeld a tanúsítványt kurzushoz, kvízhez vagy csoporthoz.

## Gyakori kérdések

### Miért üres a tanúsítvány háttere?

Ellenőrizd, hogy a Certificate Builder legfrissebb változatát használod-e. Ha igen, nézd meg, van-e képoptimalizáló bővítményed. Egyes optimalizálók (különösen a SiteGround SG Optimizer) hibát okoznak a tanúsítványképekkel. Ilyenkor kapcsold ki az optimalizálást a tanúsítványokhoz használt képekre.

### Miért nem jelenik meg a befejezés dátuma?

A tanúsítványt háromféleképpen kaphatják meg: egy kurzus sikeres befejezésekor, egy kvíz teljesítésekor, vagy egy csoport összes kurzusának befejezésekor. Ha a tanúsítvány kurzushoz tartozik, a `[courseinfo]` shortcode-ot vagy blokkot kell használnod, ha kvízhez, a `[quizinfo]` shortcode-ot vagy blokkot. Rossz típusnál a dinamikus tartalom nem jelenik meg.

- A kurzus befejezésének dátuma: `[courseinfo show="completed_on"]`
- A kvíz befejezésének napja és ideje: `[quizinfo show="timestamp"]`

### Hogyan nézhetem meg előre a tanúsítványt?

A készítőben a **Preview → Preview in new tab** lehetőséggel. A dinamikus tartalom az adatbázisból jön, ezért ha a tanúsítvány nincs kurzushoz vagy kvízhez rendelve, és nem teljesítetted, nem látsz adatot. Előbb hozz létre tesztkurzust vagy tesztkvízt, rendeld hozzá a tanúsítványt, teljesítsd, és csak utána nézd az előnézetet.