# Beállítások módosítása programból

> A beállítások automatizálása az update_rocket_option() függvénnyel, és funkciók feltételes be- vagy kikapcsolása szűrőkkel.

A WP Rocket beállításait kóddal is megadhatod. Ehhez PHP-ismeret kell, ha nem vagy jártas benne, kérd a fejlesztőd segítségét.

## A beállítások automatizálása

Két lehetőség van:

- a WP-CLI felület (lásd a **WP-CLI parancsok** fejezetet), vagy
- az `update_rocket_option()` PHP-függvény.

### Az `update_rocket_option()` használata

1. Hozz létre egy PHP-fájlt, és töltsd fel a WordPress gyökérmappájába, oda, ahol a `wp-load.php` van.
2. A fájlban minden beállításhoz külön sort írj az `update_rocket_option( 'beallitas_neve', ertek );` formában. Annyi sort adhatsz meg, amennyi kell.
3. A `beallitas_neve` helyére az alábbi lista megfelelő neve kerül.
4. Az érték 0, ha ki akarod kapcsolni a beállítást, és 1, ha be.
5. Nyisd meg a fájlt a böngészőben, ekkor fut le a konfiguráció.
6. A WordPress adminfelületén ellenőrizd: a beállítások a fájl szerint érvényesültek.

Például egy fájl, amely kikapcsolja a LazyLoadot, bekapcsolja a JavaScript-végrehajtás késleltetését, bekapcsolja a CDN-t, és beállítja a CNAME-et `example.com`-ra:

```php
<?php
require( './wp-load.php' );
update_rocket_option( 'lazyload', 0 );
update_rocket_option( 'delay_js', 1 );
update_rocket_option( 'cdn', 1 );
update_rocket_option( 'cdn_cnames', array( 'example.com' ) );
```

Kezdeti beállításnál elég azokat a beállításokat megadni, amelyek eltérnek az alapértelmezettől, a többi változatlan marad. A beállítások később a beállítóoldalon is szabadon átállíthatók. A konfigurációs fájl csak akkor érvényesül, ha megnyitod a böngészőben.

### Beállítások és azonosítóik

| Funkció | Beállítás neve | Megjegyzés |
|---|---|---|
| Emojik kikapcsolása | `emoji` | |
| Google Fonts optimalizálása | `minify_google_fonts` | |
| Mobil gyorsítótár | `cache_mobile` | |
| Külön gyorsítótár-fájlok mobileszközökhöz | `do_caching_mobile_files` | |
| Felhasználói gyorsítótár | `cache_logged_user` | |
| Gyorsítótár élettartama (érték) | `purge_cron_interval` | egész szám, például `1`, `8`, `24` |
| Gyorsítótár élettartama (egység) | `purge_cron_unit` | `'HOUR_IN_SECONDS'` vagy `'DAY_IN_SECONDS'` |
| CSS-fájlok minifikálása | `minify_css` | |
| CSS aszinkron betöltése | `async_css` | |
| Nem használt CSS eltávolítása | `remove_unused_css` | |
| JavaScript-fájlok minifikálása | `minify_js` | |
| JavaScript-fájlok egyesítése | `minify_concatenate_js` | |
| JavaScript késleltetett betöltése | `defer_all_js` | |
| JavaScript-végrehajtás késleltetése | `delay_js` | |
| LazyLoad képekhez | `lazyload` | |
| LazyLoad iframe-ekhez | `lazyload_iframes` | |
| LazyLoad CSS háttérképekhez | `lazyload_css_bg_img` | |
| YouTube iframe cseréje előnézeti képre | `lazyload_youtube` | |
| Hiányzó képméretek hozzáadása | `image_dimensions` | |
| Gyorsítótár előtöltése | `manual_preload` | |
| Hivatkozások előtöltése | `preload_links` | |
| CDN | `cdn` | |
| CDN CNAME-ek | `cdn_cnames` | tömb, például `["cdn.example.com", "cdn2.example2.com"]` |
| Varnish-kiegészítő | `varnish_auto_purge` | |
| WebP-kompatibilitás kiegészítő | `cache_webp` | |

## Beállítások feltételes be- és kikapcsolása

Ha egy beállítást csak bizonyos feltételek mellett akarsz ki- vagy bekapcsolni, használd a `pre_get_rocket_option_{beallitas_neve}` szűrőket. Például ha a JavaScript-végrehajtás késleltetését 100 termékoldalon kell kikapcsolni, ez a legpraktikusabb megoldás.

- Kikapcsoláshoz: `add_filter( 'pre_get_rocket_option_delay_js', '__return_zero' );`
- Bekapcsoláshoz: `add_filter( 'pre_get_rocket_option_delay_js', '__return_true' );`

A feltételt a WordPress feltételes függvényeivel (conditional tags) fogalmazhatod meg. A szűrők a beállítások azonosítói szerint működnek, így a fenti lista nevei használhatók.

### Segédbővítmény a feltételes váltáshoz

A WP Rocket nyilvános segédbővítménye (`wp-rocket-conditionally-toggle-options`) a termékoldalakon kapcsolja ki a JavaScript-végrehajtás késleltetését. Használata:

1. Töltsd le a segédbővítmény zip-fájlját, és csomagold ki.
2. Nyisd meg a PHP-fájlt szövegszerkesztőben.
3. A 25. sorban az `if ( is_singular( 'product' ) )` feltételt cseréld a saját feltételedre.
4. A 28. sorban az `add_filter( 'pre_get_rocket_option_delay_js', '__return_zero' );` szűrőt cseréld a kívánt beállítás szűrőjére. Több szűrőhöz másold meg a sort.
5. Csomagold újra a mappát.
6. A **Bővítmények → Új hozzáadása → Bővítmény feltöltése** oldalon töltsd fel a zip-fájlt.
7. Aktiváld a bővítményt.

### Példák

LazyLoad bekapcsolása egy adott kategóriában:

```php
if ( is_category( '9' ) ) {
    add_filter( 'pre_get_rocket_option_lazyload', '__return_true' );
}
```

Az `is_category()` többféleképpen hívható:

```php
is_category();
// bármelyik kategóriaarchívum megjelenítésekor

is_category( '9' );
// azonosító alapján: a 9-es kategória archívumánál

is_category( 'Stinky Cheeses' );
// név alapján

is_category( 'blue-cheese' );
// slug alapján

is_category( array( 9, 'blue-cheese', 'Stinky Cheeses' ) );
// több kategória: igaz, ha bármelyik egyezik
```

JavaScript-egyesítés kikapcsolása bejelentkezett felhasználóknak (ha a **Felhasználói gyorsítótár** be van kapcsolva, és náluk módosítani kell egy beállítást):

```php
if ( is_user_logged_in() ) {
    add_filter( 'pre_get_rocket_option_minify_concatenate_js', '__return_false' );
}
```

A JavaScript késleltetett betöltésének kizárásai egy egyedi bejegyzéstípuson. Ha a „books” egyedi bejegyzéstípuson minden JavaScript-fájlt késleltetve akarsz betölteni, a többi területen viszont a kizárásokat meg akarod tartani, a „books” típusnál töröld a kizárásokat:

```php
if ( is_singular( 'books' ) ) {
    add_filter( 'pre_get_rocket_option_exclude_defer_js', function() {
        return array();
    });
}
```
