# Ütemezett események

> WP-Cron és Action Scheduler: az előfizetések ütemezett akciói, a leállás diagnosztikája és a javítás.

Az ütemezett események meghatározott időpontban lefutó műveletek. Két rendszer indítja és futtatja őket a WordPress hátterében: a **WP-Cron** és az **Action Scheduler**. Az Action Scheduler a kötegelt feldolgozásban, a műveletek tárolásában, a hibanaplózásban és a kezelőfelületben erős.

Az egyedi kódokra nincs támogatás.

## WP-Cron és Action Scheduler

A WP-Cron a WordPress saját cron-megoldása: időalapú műveleteket futtat, anélkül, hogy az operációs rendszer cronjához kellene igazodni. Korlátja, hogy oldalbetöltés indítja el, amely lefuttatja az éppen esedékes vagy korábban elmaradt eseményeket. Kis forgalmú oldalon ezért az események késhetnek. Ezt például egy időnként az oldalt meglátogató szolgáltatás (állapotfigyelő) orvosolhatja.

A WP-Cron az összes ütemezett feladatot az `wp_options` tábla egyetlen sorában tárolja. Több tízezer műveletnél ez gondot okoz: nem lehet MySQL-lel lekérdezni őket (csak PHP-ban, ami lassabb), és egyetlen esemény módosítása az összes esemény mentését igényli.

Az Action Scheduler ezt a méretezési gondot oldja meg: műveleti sorokat készít, és rendezetten dolgozza fel őket. A sort két módon dolgozza fel:

- percenként megpróbálja a saját WP-Cron eseményével;
- percenként egyszer a WordPress admin kérések végén is megnézi, van-e esedékes művelet.

Amikor valamelyik lefut, az esedékes eseményeket a háttérben dolgozza fel. Futtathat kötegeket és párhuzamos sorokat, ami nagy műveletszámnál nagyon hasznos. Felületet is ad az ütemezett események kezeléséhez és előzményeik követéséhez.

## A WP-Cron hibájának jelei

Ha a WP-Cron nem működik rendesen, az Előfizetéseknél ezeket észlelheted:

- **Késő előfizetési fizetések:** az előfizetés aktív, de a következő fizetés dátuma a múltban van.
- **Elmaradt ütemezett fizetések:** a megújítások nem időben indulnak, a fizetések kimaradnak vagy késnek.
- **Lejárt ütemezett műveletek:** több, esedékességét (főleg több mint egy napja) elmulasztott művelet. Ezt gyakran az ütemezett művelet időtúllépését jelző értesítés kíséri.

## Az első ellenőrzés

Nyisd meg a **WooCommerce → Állapot** oldalt, és nézd át az állapotjelentést:

- **WP-Cron:** be kell kapcsolva lennie, kivéve, ha szándékosan szerveroldali cron indítja.
- **fsockopen/cURL:** a WP-Cronnak a belső HTTP kérésekhez kell, mindkettő legyen bekapcsolva. A WordPress a cURL-lel indítja a cront külön kérésben, hogy a látogatónak ne kelljen megvárnia a lefutást.
- **Lejárt ütemezett műveletek:** a **WooCommerce → Állapot → Időzített műveletek** oldalon nem lehet múltbeli, függő művelet.

Ha Cloudflare-t vagy más proxyt/CDN-t használsz, a belső kérések blokkolódhatnak, és a WP-Cron nem indul el, bár a kérés elmegy. Ilyenkor érdemes a WP-Cront a szerveren `localhost`-on keresztül, vagy valódi szerveroldali cron feladattal indítani.

Ha lejárt műveletek vannak, vagy más jelek mutatják, hogy az események nem futnak, bár a WP-Cron és az fsockopen/cURL be van kapcsolva, el kell dönteni, hogy a WP-Cron vagy az Action Scheduler a hibás.

## Melyik rendszer állt le?

Hasonlítsd össze mindkét rendszer utolsó sikeres futását.

**A WP-Cron ellenőrzése:**

1. Telepíts olyan bővítményt, amely megmutatja a WP-Cront (például WP Crontrol).
2. Aktiváld, és nyisd meg az **Eszközök → Cron események** oldalt.
3. A **Következő futás** oszlopban nézd meg a legfelső bejegyzés dátumát.

**Az Action Scheduler ellenőrzése:**

1. Nyisd meg a **WooCommerce → Állapot → Időzített műveletek** oldalt.
2. Válaszd a befejezett műveleteket mutató szűrőt.
3. Rendezd az **Ütemezett dátum** oszlop szerint a legfrissebbre.
4. Nézd meg az utolsó befejezett művelet dátumát.

**Az értékelés:**

1. Hasonlítsd össze a WP-Cron és az Action Scheduler dátumát.
2. Ha a WP-Cron dátuma a múltban van (a megjelenítés „(now)”), korábbi vagy egyezik az Action Scheduler dátumával, akkor a WP-Cron le van tiltva.
3. Ha a WP-Cron dátuma friss (például az utolsó pár perc), és az Action Scheduler dátumánál későbbi, akkor az Action Scheduler van blokkolva.

Ha egy ütemezett előfizetési fizetés feldolgozása közben hiba lép fel, az admin felületen értesítés figyelmezteti az áruházkezelőket. Az értesítés okát, a valószínű okokat, a diagnosztikát és a megoldást az ütemezett műveletek hibáiról szóló fejezet tárgyalja.

## Ha a WP-Cron elakadt

Előfordulhat, hogy a WP-Cron sorában van egy feladat, amely soha nem fejeződik be, és a WP-Cron végtelen ciklusban leáll vele. A sorrend:

1. A hibás feladat a sor elejére kerül.
2. A WP-Cron futtatja.
3. A feladat végzetes hibát okoz.
4. A WP-Cron nem törli a feladatot a sorból, mert az a befejezés előtt megszakadt.
5. Vissza a 2. lépéshez.

A hiba okát a végzetes hibák naplójában keresd: **WooCommerce → Állapot → Naplók**, és olyan végzetes hibát keress, amely a WP-Cron utolsó működésének idejére esik. A forrást ki kell javítani, hogy a WP-Cron újra működjön. Ha egy bővítmény okozta, frissítsd, hátha már javították.

Az újraindított WP-Cron után nem kell törölnöd vagy újragenerálnod az előfizetési eseményeket: az Action Scheduler biztonságosan tárolja a sort, így a kimaradt műveletek (például a megújítási fizetések) várják a feldolgozást. Fontos tudni, mennyi ideig állt le a WP-Cron, mert annyi esemény torlódhatott fel. Az admin kérésekkel közben futhattak feldolgozások, így lehet, hogy hátralék van, de az is, hogy nincs.

Az Előfizetések működő WP-Cront igényel, mert az Action Scheduler a gyors feldolgozáshoz rá támaszkodik. A WP-Cron első eseménye nélkül a sort csak az admin kérések aszinkron feldolgozása tudja kezelni. Mivel az alap WP-Cron oldalbetöltéssel indul, kis forgalmú oldalon az események késve futhatnak: megbízhatóbb a szerveroldali cron általi indítás.

## Az Előfizetések ütemezett akciói

Minden akcióhoz: mikor ütemezi be a bővítmény (Ütemezés), mikor ütemezi újra, mikor törli, mikor fut, milyen dátumtípushoz tartozik és milyen argumentumot kap.

### `woocommerce_scheduled_subscription_payment`

- Ütemezés: az előfizetés megvásárlásakor.
- Újraütemezés: az előfizetés státuszának `active` (aktív) státuszra változásakor; a következő fizetés dátumának módosításakor, ha az előfizetés aktív.
- Törlés: ha az előfizetés státusza `pending-cancel`, `cancelled`, `switched`, `expired` vagy `trash` lesz.
- Futás: a következő fizetés időpontjában.
- Dátumtípus: `next_payment`.
- Argumentum: az előfizetés azonosítója.

### `woocommerce_scheduled_subscription_trial_end`

- Ütemezés: ingyenes próbaidős előfizetési tétel vásárlásakor.
- Újraütemezés: `active` státuszra váltáskor; a próbaidő végének módosításakor, ha az előfizetés aktív.
- Törlés: `pending-cancel`, `cancelled`, `switched`, `expired` vagy `trash` státusznál.
- Futás: az ingyenes próbaidő végén.
- Dátumtípus: `trial_end`.
- Argumentum: az előfizetés azonosítója.

### `woocommerce_scheduled_subscription_payment_retry`

- Ütemezés: a `payment_retry` dátum frissítésekor, miután egy megújítási fizetés sikertelen volt.
- Újraütemezés: `active` státuszra váltáskor; a következő fizetési dátum módosításakor.
- Törlés: `pending-cancel`, `cancelled`, `switched`, `expired` vagy `trash` státusznál; valamint ha az új státusz nem azonos az újrapróbálás várt státuszával.
- Futás: az újrapróbálási szabályok szerint. Az alapszabályoknál az első újrapróbálás 12 órával a sikertelen megújítás után.
- Dátumtípus: `payment_retry`.
- Argumentum: az utolsó megújítási rendelés azonosítója.

### `woocommerce_scheduled_subscription_expiration`

- Ütemezés: az előfizetés megvásárlásakor. Az értéke 0, ha az előfizetésnek nincs lejárata (hossza).
- Újraütemezés: `active` státuszra váltáskor; a következő fizetési dátum módosításakor, ha az előfizetés aktív.
- Törlés: `pending-cancel`, `cancelled`, `switched`, `expired` vagy `trash` státusznál.
- Futás: az előfizetés hosszának végén.
- Dátumtípus: `end`.
- Argumentum: az előfizetés azonosítója.

### `woocommerce_scheduled_subscription_end_of_prepaid_term`

- Ütemezés: az előfizetés lemondásakor, amikor státusza `pending-cancel` lesz.
- Újraütemezés: ha az előfizetés státusza `pending-cancel` lesz.
- Törlés: `active`, `cancelled`, `switched`, `expired` vagy `trash` státusznál.
- Futás: az előre kifizetett időszak végén, amikor az előfizetés `cancelled` státuszba kerül.
- Dátumtípus: `end`.
- Argumentum: az előfizetés azonosítója.

### Adatvédelmi akciók

- `woocommerce_subscriptions_privacy_anonymize_ended_subscriptions`: a `woocommerce_cleanup_personal_data` akcióhoz kötve ütemeződik, naponta fut, argumentum nincs. Nem csinál semmit, ha a lejárt előfizetések tisztítására vonatkozó beállítás nincs bekapcsolva.
- `woocommerce_subscriptions_privacy_anonymize_subscription_orders`: minden anonimizálandó, lejárt előfizetéshez ütemeződik, az anonimizálásnál azonnal fut. Argumentum: az előfizetés azonosítója.
- `woocommerce_subscriptions_privacy_anonymize_subscription_order`: ugyanígy, minden anonimizálandó lejárt előfizetéshez, azonnal fut. Argumentum: az előfizetés azonosítója.

### `wcs_report_update_cache`

- Ütemezés: egy gyorsítótárat érvénytelenítő esemény után, a PHP leállása előtt.
- Futás: a legtöbb oldalon az érvénytelenítő esemény után 10 perccel, jelentéstípusonként 5 percre egymástól. Nagy oldalakon naponta egyszer, helyi idő szerint hajnali 4-kor, jelentéstípusonként 15 percre egymástól.
- Argumentum: a frissítendő előfizetési jelentés.

## WP-CLI

Az Action Scheduler WP-CLI parancsai műveletek feldolgozására is használhatók. Ez különösen nagy oldalaknál hasznos, hosszan futó feladatoknál, nagy sorok vagy a WP-Cron nagy terhelése esetén.
