# Naplók

> A bővítmény belső naplója: bekapcsolás, naplószintek, HTTP-kérések naplózása és a naplófájlok elérése.

A Pixel Manager belső naplózója különböző szintű üzeneteket ír fájlba. Segít megérteni, mi történik a bővítményben: a súlyos hibáktól a tájékoztató üzenetekig minden szerepelhet benne. Óvatosan használd, mert sok adatot termelhet.

## Előfeltételek

A naplózó bekapcsolt állapotában a bővítmény a WooCommerce saját naplóbeállításaitól függetlenül írja a naplót. A tárolás módja viszont számít: ha a WooCommerce a naplókat adatbázisban tárolja, a bejegyzések csak a **WooCommerce → Állapot → Naplók** oldalon látszanak, a Pixel Manager megtekintő és letöltő gombjain át nem.

A régebbi változatok a WooCommerce saját naplózóját használták, ott a WooCommerce beállításai döntöttek arról, kerül-e bármi a naplóba. Ha a napló üres marad, bár a naplózó be van kapcsolva, nézd meg a WooCommerce naplóbeállításait (**WooCommerce → Állapot → Naplók → Beállítások**):

- A naplózás legyen engedélyezve.
- A szint küszöbértéke legyen „Nincs”, ami minden szintet tárol. Magasabb küszöbnél a Pixel Manager alacsonyabb szintű üzenetei csendben elmaradnak.
- A naplótárolás legyen a fájlrendszer, mert a Pixel Manager gombjai a naplófájlokat olvassák.

Ha egy beállítás szürke, akkor a `wp-config.php` fájlban a `WC_LOG_THRESHOLD` vagy a `WC_LOG_HANDLER` állandó rögzíti. Kérd meg azt, aki a fájlt kezeli, hogy módosítsa vagy törölje.

## A naplózó bekapcsolása

A Pixel Managerben nyisd meg a **Support** fület, kapcsold be az **Enable logger** kapcsolót, és mentsd.

![A Support fül Logger kártyája: Enable logger, Log level, Log HTTP requests és Download logs (ZIP)](./kepek/tamogatas.webp)

*A Support fül Logger kártyája: Enable logger, Log level, Log HTTP requests és Download logs (ZIP)* (https://minta-bolt.hu/wp-admin/admin.php?page=pmw)

A képen a **Logger** kártya látszik a vezérlőkkel. A bekapcsoló alapból ki van kapcsolva, a **Log level** értéke **Warning**.

## Naplószintek

A naplónak öt szintje van:

| Szint | Mit naplóz |
|---|---|
| Critical | Súlyos hibák, amelyek akár a WordPressszel is végezhetnek. |
| Error | Hibák, amelyek miatt a Pixel Manager nem működik rendesen. |
| Warning (alapértelmezett) | Figyelmeztetések, amelyeket érdemes kijavítani, de nem akadályozzák a működést. |
| Info | Hasznos tudnivalók a bővítmény tevékenységéről. |
| Debug | Részletes hibakereső információ a belső működésről. Csak hibakeresésre használd, nagyon sok adatot termel. |

## HTTP-kérések naplózása

Ha bekapcsolod a **Log HTTP requests** kapcsolót, a naplózó részletesen rögzíti a Pixel Manager kimenő HTTP-kéréseit is. Ez a külső szerverekkel való kommunikáció hibáinak felderítésére jó.

A HTTP-kérések a Debug szinten naplóződnak, ezért a **Log level** értékét is állítsd **Debug**ra, különben az alapértelmezett Warning szint kiszűri őket, és semmi nem kerül a naplóba.

A bekapcsolással a webes kérések aszinkron (gyorsabb, nem blokkoló) módból szinkronra (lassabb, blokkoló) váltanak, hogy a szerverek válasza rögzíthető legyen. A válaszok így mélyen elemezhetők, de több szerver-erőforrást használnak. Ezért csak hibakeresésre való, és 12 óra után magától kikapcsol. Az időtartamot szűrővel módosíthatod:

```php
add_filter( 'pmw_http_request_log_auto_off_delay', function() {
    return 6 * HOUR_IN_SECONDS;
} );
```

## A naplófájlok elérése

A naplófájlok megtekintésére és letöltésére gombok szolgálnak (a képen a **Download logs (ZIP)** gomb). A gombok csak akkor aktívak, ha van napló.

Ha támogatási kérést küldesz, a naplófájlok hivatkozásait a vágólapra másolhatod, és beillesztheted a kérésbe, így a támogatás közvetlenül eléri a fájlokat.

A naplók a WooCommerce megszokott naplómappájába kerülnek: `/wp-content/uploads/wc-logs/`. A fájlnevek `pmw-` előtaggal kezdődnek.