# Hibaelhárítás

> Gyakori LW LMS-hibák: nem látszó kurzusoldal, 401 és 403 a REST API-ban, zárolt lecke, kvíz-korlát, lejárt letöltési link, WooCommerce-hozzáférés.

| Amit látsz | Ok | Mit tegyél |
|---|---|---|
| A kurzus nem jelenik meg a webhelyen, nincs kurzusoldal | A bővítmény headless, nincs frontend-kimenete. | A tanulói felületet az `lms/v1` [REST API-ra](https://hub.hellowp.io/hu/docs/lw-plugins/lw-lms/rest-api/attekintes/) építsd. |
| Tanulók „feliratkoztak” egy ingyenes kurzusra, pedig csak megnézték | Bejelentkezve a `GET /courses/{id}` és a lecke megnyitása feliratkozást rögzít. | A katalógus a `GET /courses` listából dolgozzon. |
| `401` „Hitelesítés szükséges.” | `/progress` hívás bejelentkezés vagy alkalmazásjelszó nélkül. | Küldj hitelesítést. |
| `403` „Nincs hozzáférésed ehhez a leckéhez.” | Nincs feliratkozás vagy vásárlás; ingyenes kurzusnál nincs bejelentkezve. | Bejelentkezés, vásárlás vagy kézi feliratkoztatás. |
| `403 lesson_locked` „Végezd el az előző leckét, hogy ez megnyíljon.” vagy „Ez a lecke még nem érhető el.” | Lineáris haladás vagy ütemezés. | Várj az `available_at` időpontig, vagy végezd el az előző leckét. Adminként: `wp lw-lms drip status`. |
| `403` „A lecke elvégzéséhez teljesítsd a lecke kvízét.” | Be van kapcsolva **A lecke elvégzéséhez sikeres kvíz kell**. | Előbb sikeres kvíz kell (`POST /lessons/{id}/quiz`). |
| `400` „A lecke nem tartozik a megadott kurzushoz.” | Rossz `course_id` a `POST /progress`-ben. | A lecke saját kurzusát add meg. |
| `404` „Kurzus nem található.” vagy „Lecke nem található.” | Nem létezik, vagy nem publikált, és nincs jogod hozzá. | Ellenőrizd az ID-t és az állapotot. |
| `404` „Ennek a leckének nincs kvíze.” | Kvíz nélküli leckére küldtél kvízt. | Csak kvízes leckére küldj. |
| `429` „Túl sok kvízkitöltés. Várj egy kicsit, mielőtt újra próbálod.” | 15 másodperces várakozás vagy napi 20 kísérlet. | Várj `retry_after` másodpercet. A korlátok szűrővel állíthatók. |
| `403` „Ez a letöltési link érvénytelen vagy lejárt. Töltsd újra az oldalt egy új linkért.” | Egy óránál régebbi aláírt link. | Kérd le újra a kurzust vagy a leckét. |
| „A leckék az LMS API-n keresztül érhetők el (/lms/v1/lessons).” | A frontend a WordPress `/wp/v2/lesson` végpontját hívja. | Használd a `/lms/v1/lessons/{id}` végpontot. |
| „Nincs jogosultságod ilyen állapotú kurzusok listázásához.” | `status=draft` vagy `any` szerkesztési jog nélkül. | Csak publikált kurzust kérj. |
| „A kvíz nem mentődött: …” angol részlettel | Hibás kvíz-JSON. | Lásd: [Kvíz-formátum](https://hub.hellowp.io/hu/docs/lw-plugins/lw-lms/kviz-formatum/). |
| Vásárlás után sincs hozzáférés a fizetős kurzushoz | A WooCommerce-integráció ki van kapcsolva, a termék nincs a kurzushoz kötve, vagy a rendelés nem teljesített és nem feldolgozás alatti. | [WooCommerce](https://hub.hellowp.io/hu/docs/lw-plugins/lw-lms/beallitasok/woocommerce/) fül; a kurzus **Hozzáférési beállítások** doboza; a rendelés állapota. |
| Az abilityk nem látszanak REST-en vagy MCP-n | WordPress 6.9 alatt nincs Abilities API. | Frissíts WordPress 6.9-re vagy újabbra. |
| Ütemezett lecke elcsúszott időben, nem UTC időzónájú oldalon | A 2.0.2 javította, de a korábban `drip set-start --date`-tel beállított kezdőidőket nem. | Állítsd be újra: `wp lw-lms drip set-start <tanuló> <kurzus> --date="…"`. |
| „Az autoloader nem található. Futtasd a "composer install" parancsot…” | Git-klón `composer install` nélkül. | `composer install`, vagy a kiadás ZIP-je. |
| „Hiányoznak az admin felület fájljai…” | Hiányos telepítés. | Telepítsd újra a kiadás ZIP-jéből. |