# Teljesítmény és nagy boltok

> Hogyan készülnek az ajánlások, mivel gyorsíthatod őket, hogyan kezeld a várólistát, a WP-CLI-t, a sütiket, és milyen korlátokkal kell számolnod.

A bővítmény az ajánlásokat igény szerint, a háttérben állítja elő, hogy kímélje a kiszolgálót, és minden tárhelyen működjön. Ez a fejezet azt mutatja, hogyan hangolhatod a működést nagyobb terhelésű vagy nagy katalógusú boltnál.

## Hogyan készülnek az ajánlások

- Egy motor első telepítése után előfordulhat, hogy néhányszor frissítened kell az oldalt, vagy pár percet várnod kell, mire megjelennek az eredmények.
- Az ajánlóblokkot 24 óránként az első látogató indítja újra. Ha 24 óráig senki sem nyitotta meg az oldalt, az első látogató még a régi, lejárt változatot látja, és az ő látogatása indítja az újragenerálást.
- Az időköz a **WooCommerce → Beállítások → Ajánlások** oldal **Gyorsítótár újragenerálásának időköze (óra)** mezőjében állítható. Úgy válaszd meg, hogy az ajánlások naprakészek maradjanak, de a kiszolgáló ne terhelődjön fölöslegesen.

![A WooCommerce beállításai, Ajánlások fül: gyorsítótár, AJAX és naplózás](./kepek/beallitasok.webp)

*A WooCommerce beállításai, Ajánlások fül: gyorsítótár, AJAX és naplózás* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-settings&tab=prl_settings)

A képen az újragenerálás időköze és az **AJAX használata** jelölőnégyzet látszik.

## AJAX-os megjelenítés

Az AJAX-os betöltés kell ahhoz, hogy a láthatósági feltételek működjenek, ha a boltban bármilyen gyorsítótár fut. Ha nincs gyorsítótár, kikapcsolhatod: az ajánlások kevesebb erőforrással készülnek, és kisebb a kiszolgáló terhelése.

## Erősítők mértéke

Az erősítők a szűrt találatok sorrendjét módosítják, több súlyozott erősítővel összetett rendezés is építhető. Minden erősítő önálló lekérdezés, ezért egy többerősítős motor minden generáláskor:

1. beolvassa a szűrőket,
2. beállítja a szűrőket és lefuttat egy lekérdezést erősítőnként,
3. a termékek listáit egyetlen súlyozott listává egyesíti.

Csak akkor használj sok erősítőt, ha tényleg kell. Egy-két erősítő is jó eredményt ad, és nem terheli túl a kiszolgálót. Példa: a kevesebb erősítős motor közel háromszor gyorsabb lehet, mint a sok erősítős.

## A várólista figyelése

A **WooCommerce → Állapot → Ajánlások várólistája** oldalon látod a függő és a sikertelen (újra)generálási feladatokat. Érdemes rendszeresen megnézni, hogy az ajánlások időben feldolgozódnak-e.

![Az Ajánlások várólistája oldal](./kepek/sor.webp)

*Az Ajánlások várólistája oldal* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-status&tab=recommendations_queue)

Az oldalon a sorban álló és a hibás feladatok külön listában jelennek meg.

### Szabályozás (throttling)

Nagy katalógusnál, főleg üres adatbázisból indulva teljesítményproblémák léphetnek fel. Ezt a sorba állítás „zárolásával” enyhítheted: egy átmeneti adat (transient) megadott időre lezárja a sorba állítást, így kevesebb felesleges feladat gyűlik fel. Alapértelmezés szerint ez 1 perc. Hosszabb időhöz, például 2 percéhez használd ezt a kódot:

```php
add_filter(
    'wc_prl_generation_task_throttle',
    function() {
        return 2 * MINUTE_IN_SECONDS;
    }
);
```

A szabályozást bármikor hozzáadhatod vagy eltávolíthatod (0 értékkel kikapcsol). Segít elosztani a terhelést az időben, de hosszú ideig tartó használata jelentős késést okozhat az ajánlások előállításában. Mindig a gyors működés és a késés közötti kompromisszum.

### Feldolgozás az Action Schedulerrel

Az egyes sorelemeket egy percenként ismétlődő Action Scheduler (AS) feladat dolgozza fel. A feladat addig generál, amíg el nem készül, vagy amíg el nem éri az idő- vagy memóriakorlátot.

## Generálás WP-CLI-vel

Legtöbbször elég az igény szerinti generálás. Ha jobban akarod szabályozni, különösen alacsony terhelésű időszakban, vagy ha az ajánlásokat csak WP-CLI-vel kezelnéd, a sorban álló feladatokat kézzel is elindíthatod. Előbb tiltsd le az automatikus indítást:

```php
add_filter( 'woocommerce_prl_queue_via_wp_cli', '__return_true' );
```

Majd a feladatokat ezzel a paranccsal indítod:

```bash
wp wc prl process-generation-queue
```

| Kapcsoló | Mit csinál | Alapérték |
|---|---|---|
| `--max-iterations` | A sorból feldolgozandó iterációk száma. Kötegelt futtatásnál korlátozza a munkát. | 0 (nincs korlát) |

- Ha nem adsz meg `--max-iterations` értéket, a bővítmény a sor kiürüléséig dolgozik.
- Egy ajánlási lista elkészítése 2-8 iterációt igényelhet.
- Alacsony terhelésű időben futtathatod natív cron feladatból, például: `wp wc prl process-generation-queue --max-iterations=1000`

Figyelem: ha a WP-CLI-t a bővítmény szintjén kapcsolod be, a generálás kizárólag ezzel a paranccsal történik. Akkor is külön el kell indítanod, ha az Action Schedulert is WP-CLI-ből futtatod.

### Az Action Scheduler átváltása WP-CLI-re

A WooCommerce Action Schedulere az összes műveletet át tudja vinni WP-CLI-parancsokra. Nagyobb oldalaknál ez jobb választás, mint az alapértelmezett futtató, és közben nem indulnak aszinkron kérések, mert minden ugyanabban a kérésben fut. Az átváltáshoz:

```php
add_action( 'init', function () {
    if ( class_exists( 'ActionScheduler' ) ) {
        remove_action( 'action_scheduler_run_queue', array( ActionScheduler::runner(), 'run' ) );
    }
} );
```

Vigyázat: a szűrő megakadályozza, hogy a wp-cron lefuttassa az AS műveleteit. Csak akkor használd, ha ezeket már más módon kezeled, például a `wp action-scheduler run` parancsot unix cron feladatból futtatod.

Az összes újragenerálási kérés a `wc_prl_generator` csoportba kerül, ezért bármikor lefuttathatod őket így:

```bash
wp action-scheduler run --group=wc_prl_generator
```

## Sütik és követés

A bővítmény analitikai irányítópultja a konverziókat méri, ehhez teljesítménybarát módon egy sütit használ. A bővítmény minden sütijét JavaScript állítja be (`document.cookie`), PHP `setcookie` nélkül, így HTML-gyorsítótárnál is egyenletesebb a követési adat.

### Konverziókövető süti

- Ha a vásárló rákattint egy ajánlott termékre, létrejön vagy frissül a `wc_prl_deployments_clicked` süti.
- Amikor a termék a kosárba kerül, a rendszer kiolvassa a sütit, és ha a terméket az aktuális munkamenetben kattintották, új konverziós esemény keletkezik. A munkamenet hosszát a **WooCommerce → Beállítások → Ajánlások** oldal **Követési munkamenet (óra)** mezője adja.

A követés, és vele a süti kezelésének kikapcsolásához:

```php
add_filter( 'woocommerce_prl_tracking_enabled', '__return_false' );
```

Ezzel az admin felületről a **Teljesítmény** oldal is eltűnik.

### Legutóbb megtekintett termékek süti

A `wc_prl_recently_viewed` süti a „Legutóbb megtekintett termékek” listákhoz kell. Nélküle a **Legutóbb megtekintett** szűrők nem működnének, ezért nem kapcsolható ki.

## Amire figyelned kell

- **Elfogyott termékek.** Ha az újragenerálási időköz nincs jól beállítva, vagy az AJAX ki van kapcsolva, a külső gyorsítótár időtartamától függően elfogyott termékek is megjelenhetnek az ajánlásokban.
- **Legutóbb megtekintett termékek.** Ezek a süti értékéből jönnek. HTML-gyorsítótárnál csak a gyorsítótárazatlan oldalakon (Kosár, Pénztár) működnek a várt módon.
- **Láthatósági feltételek.** Kikapcsolt AJAX mellett a láthatósági feltételek nem működnek, ami befolyásolhatja, kinek mi jelenik meg.
- **WP-CLI-s kezelés.** Ha a generálást WP-CLI-re bízod, a motor beállításainak módosítását csak a parancs lefuttatása után tudod kipróbálni, ami kevésbé kényelmes, mint az automatikus működés.
