# Kvízek exportálása és importálása

> Meglévő kvíz mentése CSV-fájlba és betöltése másik kurzusba, a CSV-fájl oszlopainak leírásával.

A **Kvízek exportálása/importálása** bővítménnyel egy meglévő kvízt CSV-fájlba menthetsz, és később másik kurzusba betölthetsz. Így egy korábbi kvíz kérdéseit újra felhasználhatod, vagy kiindulópontként módosíthatod. A funkció csak a Tutor LMS-sel épített oldalak között működik.

Tipikus eset: új kvízt készítesz, amelynek kérdései sokban hasonlítanak egy másik kvízére, akár ugyanabban, akár másik kurzusban. Exportálod a meglévő kvízt, megnyitod az új kurzust, importálod a fájlt, majd úgy mented, vagy előbb átszerkeszted.

## Bekapcsolás

1. Nyisd meg a **Tutor LMS Pro → Addons** oldalt.
2. Keresd meg a **Kvízek exportálása/importálása** bővítményt, és kapcsold be a kapcsolóját.

![A Kvízek exportálása/importálása bővítmény kártyája az Addons oldalon](./kepek/kvizek-export-import-addon.webp)

*A Kvízek exportálása/importálása bővítmény kártyája az Addons oldalon* (https://minta-bolt.hu/wp-admin/admin.php?page=tutor-addons)

## Kvíz exportálása

1. Nyisd meg szerkesztésre azt a kurzust, amelyben az exportálandó kvíz van.
2. A kurzuskészítő **Curriculum** lépésén keresd meg a kvízt. A sorának jobb oldalán megtalálod az exportálás ikont.
3. Kattints az ikonra. A kvíz CSV-fájlként letöltődik a gépedre.

## Kvíz importálása

1. Hozz létre új kurzust, vagy nyiss meg szerkesztésre egy meglévőt.
2. A kurzuskészítő **Curriculum** lépésén a téma alján az **Import Quiz** gombot találod.

![A Curriculum lépés a Lecke és Kvíz gombbal, jobbra az Import Quiz gombbal](./kepek/kvizek-export-import-tanterv.webp)

*A Curriculum lépés a Lecke és Kvíz gombbal, jobbra az Import Quiz gombbal* (https://minta-bolt.hu/wp-admin/admin.php?page=create-course&course_id=12)

A képen a téma alján, a **Kvíz** gomb mellett jobbra látszik az **Import Quiz** gomb.

3. Kattints az **Import Quiz** gombra, és a megnyíló fájlkiválasztóban válaszd ki a CSV-fájlt. A kvíz betöltődik.
4. Kattints a **Publish** vagy **Update** gombra a mentéshez.

## A CSV-fájl felépítése

Saját importfájlt is készíthetsz. A legegyszerűbb, ha előbb exportálsz egy kvízt, és az exportált fájlt veszed mintának. A fájl sorai háromfélék: a kvíz beállításait leíró sor, a kérdéssorok és a válaszsorok.

### Támogatott kérdéstípusok

| Érték | Kérdéstípus |
|---|---|
| `true_false` | Igaz/Hamis |
| `single_choice` | Egy helyes válaszú kérdés |
| `fill_in_the_blank` | Fill in the Blanks |
| `matching` | Egyezés (párosítás) |
| `short_answer` | Rövid válasz |
| `image_answering` | Képes válasz |
| `open_ended` | Hosszú, leíró válasz |
| `ordering` | Rendezés |

### A kvíz beállításait leíró sor

| Tulajdonság | Jelentése |
|---|---|
| Quiz Title | A kvíz címe |
| Quiz Description | A kvíz leírása (nem kötelező) |
| Time Limit | Az időkorlát értéke |
| Time Type | Az időkorlát egysége, például perc, óra, nap |
| Hide Quiz Time | `1`: az idő rejtve van, `0`: látszik |
| Attempts Allowed | A próbálkozások legnagyobb száma |
| Passing Grade | A ponthatár százalékban |
| Question Display Limit | A megjelenített kérdések száma |
| Shuffle Questions | `1`: a kérdések összekeverve jelennek meg, `0`: nem |
| Question Layout | A kérdések elrendezése, például `single_question` |
| Question Order | A kérdések sorrendje, például `rand` a véletlen sorrendhez |
| Short Answer Character Limit | A rövid válasz karakterkorlátja |
| Open-Ended Character Limit | A nyílt végű válasz legkisebb karakterszáma |
| Open-Ended Word Limit | A nyílt végű válasz legnagyobb szószáma |
| Retry Mode | Értéke `retry` |

### Kérdéssorok

| Tulajdonság | Jelentése |
|---|---|
| Row Type | Értéke `question` |
| Question Title | A kérdés szövege |
| Question Description | A kérdés leírása (nem kötelező, HTML is használható) |
| Question Type | A kérdés típusa a fenti táblázat szerint |
| Marks | A kérdésért járó pont |
| Question Order | A kérdés helye a sorrendben |
| Required | `1`: kötelező válaszolni |
| Randomize Answers | `1`: a válaszok sorrendje véletlenszerű |
| Show Points | `1`: a pontok megjelennek |
| Answer Explanation | A beadás után megjelenő magyarázat |

### Válaszsorok

| Tulajdonság | Jelentése |
|---|---|
| Row Type | Értéke `answer` |
| Answer Title | A válasz szövege vagy felirata |
| Answer Type | `text` vagy `text_image` |
| Is Correct | `1`: helyes válasz, `0`: helytelen |
| Image Attachment ID | A képes válaszokhoz kötelező: a kép azonosítója a médiatárban |
| Match or Correct Value | Az Egyezés és a Fill in the Blanks kérdéseknél használt érték |
| Answer Order | A válasz helye a sorrendben |

### Különleges formátumok

- **Fill in the Blanks:** a helyes választ kapcsos zárójelben add meg, például: „A WordPress egy {nyílt} forráskódú rendszer.”
- **Egyezés:** a párt a válaszsor hatodik oszlopában add meg. A bal oldali elem a válasz szövege, a hozzá tartozó pár a hatodik oszlopban áll (például A párja B, C párja D).
- **Képes válasz:** a válasz típusa legyen `text_image`, és érvényes képazonosítót adj meg. A képeknek már fel kell lenniük töltve a WordPress médiatárába.