# Konstans és szűrők

> Az LW_IMG_API_KEY konstans a wp-config.php-ban vagy Bedrockban, és a fejlesztőknek szóló szűrők és akciók.

## LW_IMG_API_KEY

Az LW Image egyetlen beállító konstanssal rendelkezik: az API-kulccsal.

```php title="wp-config.php"
define( 'LW_IMG_API_KEY', 'himg_live_xxxxxxxxxxxxxxxx' );
```

| | |
|---|---|
| **Érték** | A HelloIMG API-kulcs. |
| **Hatás** | Felülírja a felületen mentett kulcsot, és soha nem kerül az adatbázisba. Az Általános fülön a kulcs sora lakatos és csak olvasható: „A wp-config.php-ban beállítva (LW_IMG_API_KEY)”, mellette a maszkolt kulcs. A felületről nem módosítható. |
| **Üres érték** | Ha üres vagy csak szóköz, olyan, mintha nem adtad volna meg: a felületen mentett kulcs érvényes. |

Mikor érdemes:

- **Több környezetnél** (staging, éles), ahol minden környezet a saját domainjének kulcsát kapja.
- **Bedrockban**, ahol a kulcs a `.env`-ből jön (lásd [Az LW Image telepítése](https://hub.hellowp.io/hu/docs/hellotools/helloimg/telepites/)).
- **Ügynökségi telepítésnél**, hogy az ügyfél ne lássa és ne törölje a kulcsot.

A bővítmény ezeket a WordPress-konstansokat csak olvassa: `DISABLE_WP_CRON` (a Tester és a Backup fül kijelzéséhez) és `WP_DEBUG_LOG` (a hibakereső naplóhoz).

## Szűrők

| Szűrő | Mire jó |
|---|---|
| `lw_img_dashboard_url` | A vezérlőpult címe, ahová a bővítmény a kulcsért linkel. |
| `lw_img_site_host` | A HelloIMG-nek küldött domain felülírása, pl. multisite-on vagy reverse proxy mögött. Alapból a Webhely címe (`home_url`). |
| `lw_img_optimize_request_args` | A kérés paraméterei (`level`, `keep_exif`, `convert`, `max_width`, `max_height`) módosítása. |
| `lw_img_should_convert` | Egy konvertálás megvétózása fájlonként. |

Példa: reverse proxy mögött a valódi domain küldése, hogy a domainhez kötött kulcs érvényes legyen.

```php title="mu-plugins/lw-img-host.php"
add_filter( 'lw_img_site_host', fn () => 'pelda.hu' );
```

## Akciók

| Akció | Mikor fut |
|---|---|
| `lw_img_upload_converted` | Egy kép konvertálása után |
| `lw_img_upload_skipped` | Ha egy kép kimaradt |
| `lw_img_upload_failed` | Ha a konvertálás sikertelen |
| `lw_img_restored` | Egy eredeti visszaállítása után |