# Ütemezett műveletek hibái

> Mit jelent az ütemezett művelet hibájáról szóló értesítés, hogyan derítsd ki az okát, és hogyan javítsd az érintett előfizetéseket.

A bővítmény a WooCommerce Action Scheduler funkciójával dolgozza fel az ütemezett eseményeket, például a megújításokat és a lejáratot. Ha egy ilyen esemény feldolgozása hibával áll le, az admin felületen értesítés jelenik meg, hogy a boltkezelők észrevegyék.

Ez a fejezet elmagyarázza, miért látod az értesítést, mi lehet az oka, hogyan keresd meg az okot, és hogyan javítsd az érintett előfizetést.

## Lejárt (késő) műveletek

A lejárt művelet olyan feladat, amely lekésett az ütemezett időpontjáról. A WP-Cron működése miatt néhány késő művelet gyakori, ez önmagában nem baj. Ha viszont több, egy napnál régebbi késő művelet is van, az a WP-Cron hibájára utalhat. Ennek következménye lehet hiányzó rendelés, hiányzó előfizetés vagy hiányzó adat a WooCommerce Analitikában.

A késő műveleteket a **WooCommerce → Állapot → Időzített műveletek** oldalon, a **Késedelmes** szűrő alatt találod.

![Az Időzített műveletek oldal Összes, Függőben, Megszakítva és Késedelmes szűrőkkel](./kepek/hibaelharitas-utemezett-akciok.webp)

*Az Időzített műveletek oldal Összes, Függőben, Megszakítva és Késedelmes szűrőkkel* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-status&tab=action-scheduler&s=subscription)

A lista tetején lévő szűrők számai mutatják, hány művelet van az egyes állapotokban.

## Időtúllépés (timeout)

Ha egy előfizetéshez tartozó művelet időtúllépés miatt hibázik, az admin felületen értesítés jelenik meg. Időtúllépésnek az számít, ha egy művelet több mint öt perce „fut”. A bővítmény ilyenkor sikertelennek tekinti és úgy jelöli, mert ennyi idő után valószínűleg már nem is fut.

Az értesítés tartalmazza az érintett előfizetés számát és egy hivatkozást az előfizetés szerkesztőoldalára. Ennek segítségével ellenőrizd, hogy az utolsó megújítási fizetéssel van-e valami, amit kézzel kell rendezned.

### A megújítási folyamat követése

A megújítási folyamat minden lépése bekerül az előfizetés jegyzetei közé.

1. Nyisd meg a **WooCommerce → Előfizetések** oldalon az érintett előfizetést.
2. Nézd meg a **Rendelés jegyzetek** dobozt.

![Az előfizetés szerkesztőoldala a Rendelés jegyzetek dobozzal, amelyben a megújítás lépései látszanak](./kepek/hibaelharitas-elofizetes-jegyzetek.webp)

*Az előfizetés szerkesztőoldala a Rendelés jegyzetek dobozzal, amelyben a megújítás lépései látszanak* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-orders--shop_subscription&action=edit&id=27)

A jobb oldali **Rendelés jegyzetek** dobozban időrendben látod az állapotváltásokat, időponttal együtt.

A megújítás normál menete:

1. A megújítás esedékes, az előfizetés **Felfüggesztve** állapotba kerül.
2. Az előfizetés létrehoz egy rendelést a megújítás rögzítésére és a fizetés lebonyolítására.
3. Automatikus megújításnál a rendelés megkísérli a fizetést, és siker esetén **Teljesítve** állapotba kerül.
4. Az előfizetés **Aktív** állapotba kerül.

Minden lépés rögzíti az időpontját. Az időbélyegek összevetésével kiderül, hol akadt el a folyamat az időtúllépéskor.

### Hiba a fizetés előtt

Ha a megújítási rendelés létrejött, de a fizetés nem lett késznek jelölve, a folyamat a fizetés előtt akadhatott el. Erre utal, ha a hibás művelet időpontja közel van a megújítási rendelés létrehozásának idejéhez.

Annak ellenőrzéséhez, hogy a pénz nem érkezett meg:

1. Nyisd meg a létrejött rendelést, amelyre az előfizetés jegyzetei hivatkoznak.
2. A rendelés jegyzeteiben nézd meg, változott-e az állapot, és lefutott-e a fizetés.
3. Jelentkezz be a fizetési átjáró fiókjába, és ellenőrizd, hogy a rendeléshez tartozó összeg le lett-e vonva.
4. Ha nincs terhelés, a folyamat a fizetés előtt akadt el.

### Hiba a fizetés után

Ha a fizetés megtörtént, de a rendelés nem lett **Feldolgozás alatt** vagy **Teljesítve**, vagy az előfizetés nem lett **Aktív**, a folyamat a fizetés után akadt el. Erre utal, ha a hibás művelet időpontja a fizetés késznek jelölése utánra esik.

### Ha a fizetés nem történt meg

1. Nézd meg, van-e az előfizetéshez függőben lévő vagy sikertelen megújítási rendelés. Ha van, állítsd az állapotát **Törölve**-re, és kattints a **Frissítés** gombra. Figyelj rá, hogy csak a megújítási rendelést töröld, ne az egész előfizetést, mert a törölt előfizetést később nem lehet újra aktívvá tenni.
2. Állítsd az előfizetés állapotát **Aktív**-ra, és kattints a **Frissítés** gombra.
3. Az előfizetés műveleti legördülő listájában válaszd a **Megújítás feldolgozása** műveletet.
4. Ez új megújítási rendelést hoz létre, amely a szokásos módon feldolgozódik.

### Ha a fizetés megtörtént

Ha a pénz megérkezett, de a rendelés és az előfizetés nem frissült:

1. Ha a megújítási rendelés nem lett **Feldolgozás alatt** vagy **Teljesítve**, állítsd át a megfelelő állapotra.
2. Ez az előfizetést is **Aktív** állapotba teszi.
3. Ha csak az előfizetés nem lett aktív, állítsd át kézzel **Aktív**-ra.

## Lehetséges okok

Az időtúllépés okát programból nem lehet megállapítani, ezért mindig kézi vizsgálat kell, és erre figyelmeztet az értesítés. Az alábbi okokat érdemes végignézni.

### Régi bővítményverzió

Az időtúllépések és az értesítések a bővítmény újabb verzióiban nagyon ritkák. Ha az értesítést látod, először frissítsd a bővítményt a legújabb verzióra. Azt is ellenőrizd, melyik verzió futott a hiba idején, mert lehet, hogy a hiba egy frissítés előtt történt.

1. Nyisd meg a **WooCommerce → Állapot → Naplók** oldalt.
2. Nézd át a bővítmény frissítési naplóját és a sikertelen ütemezett műveletek naplóját.
3. Hasonlítsd össze a hiba idejét (a sikertelen műveletek naplójából) a frissítési napló szerinti, akkor futó verzióval.

Ha a hiba idején sokkal régebbi verzió futott, és azóta frissítettél, a frissítés nagy valószínűséggel megoldotta az okot. Ha nem, vizsgáld tovább a többi lehetséges okot.

### A PHP időkorlátja

A PHP időkorlátja az az idő, amennyit a szerver egyetlen folyamatra fordít, mielőtt automatikusan megszakítja. Ha túl rövid, a folyamatok időtúllépéssel leállhatnak, mielőtt befejeződnének. Gyakori alapérték a 30 másodperc, a kezelt tárhelyek többsége hosszabbat ad.

1. Nyisd meg a **WooCommerce → Állapot** oldalt.
2. Görgess a **Szerver környezet** szakaszhoz.
3. Nézd meg a **PHP Időkorlát** értékét.

![A Szerver környezet szakasz a PHP időkorlát értékével](./kepek/hibaelharitas-rendszerallapot.webp)

*A Szerver környezet szakasz a PHP időkorlát értékével* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-status)

A **PHP Időkorlát** sort keresd. Ha 30 másodperc alatti, érdemes emelni, hogy ne legyen időtúllépés. Az érték módosításához fordulj a tárhelyszolgáltatóhoz.

### Sok időtúllépés

Az ilyen értesítésnek ritka eseménynek kell lennie. Ha tucatnyi vagy több időtúllépés van, valószínűleg komoly háttérprobléma okozza őket, amelyet meg kell keresni. Az időtúllépések számát a sikertelen ütemezett műveletek naplójában nézheted meg. Ilyenkor érdemes támogatást kérni.

### Végzetes PHP-hibák

A végzetes hibák leállíthatják a kód futását, és hozzájárulnak az ütemezett műveletek hibáihoz. Az okukat a szerver PHP-hibanaplójában keresheted: nézd át a tárhelyszolgáltatód hibanaplóját a probléma időpontja környékén.
