# Az előtöltés kizárásai és testreszabása

> URL-ek kizárása az előtöltésből, az előtöltés korlátozása adott URL-ekre vagy oldaltérképre, oldaltérképek sorrendje, süti szerinti előtöltés.

Az [előtöltésből](https://hub.hellowp.io/hu/plugins/wp-rocket/elotoltes-gyorsitotar-elotoltese/) URL-eket és URL-csoportokat zárhatsz ki: a mezővel, szűrővel vagy egy kisegítő bővítménnyel.

## URL-ek kizárása a mezővel

Az **Előtöltés aktiválása** bekapcsolása után az **URL-ek kizárása** mezőbe soronként egy URL-t írhatsz (**Beállítások → WP Rocket → Gyorsítótár → Előtöltés**).

![Az URL-ek kizárása mező bekapcsolt előtöltésnél](./kepek/elotoltes-bekapcsolva.webp)

*Az URL-ek kizárása mező bekapcsolt előtöltésnél* (https://minta-bolt.hu/wp-admin/options-general.php?page=wprocket)

A mező a jelölőnégyzet alatt jelenik meg, a minta sorral (`/author/(.*)`).

- Több URL-t helyettesítő karakterrel (`(.*)`) adhatsz meg, például `/author/(.*)` vagy `/color-(.*)`.
- A kizárt URL előtöltődni nem fog, de gyorsítótárazódni igen. Ha azt is tiltani akarod, az oldalt a gyorsítótárból kell kizárni.
- Amelyik URL korábban már előtöltési sorban volt, az a következő futáskor törlődik az adatbázisból.

## Kizárás kóddal

A `rocket_preload_exclude_urls` szűrővel feltétel alapján is kizárhatsz URL-eket. Például így maradnak ki az „elfogyott” kategóriájú termékek:

```php
function no_preload_for_sold_out_products( array $regexes ) : array {

    $excluded_categories  = array(
        'sold-out',
    );

    $new_regex =  $_SERVER['REQUEST_URI'];

    if(!is_singular('product')) {
        return $regexes;
    }

    if ( ( !has_term( $excluded_categories, 'product_cat' ) )  )  {

        return $regexes;
    }

    $regexes[] = $new_regex;

    return $regexes;
}

add_filter( 'rocket_preload_exclude_urls', 'no_preload_for_sold_out_products');
```

## Az előtöltés korlátozása adott URL-ekre

Ugyanezzel a szűrővel azt is megteheted, hogy csak néhány URL töltődjön elő, minden más kimarad. Az alábbi példa csak a két megadott URL-t tölti elő:

```php
add_filter( 'rocket_preload_exclude_urls', function( $regexes, $url ) {
    $inclusion_list = [ 'https://example.org/url1', 'https://example.org/url2', ];
    if ( ! in_array( $url, $inclusion_list, true ) ) {
        $regexes[] = $url;
    }
    return $regexes;
}, 10, 2 );
```

## Az előtöltés korlátozása egy oldaltérképre

Egy külön kisegítő bővítménnyel az előtöltést egyetlen oldaltérkép URL-jeire is szűkítheted:

1. Töltsd le a bővítmény ZIP-fájlját, csomagold ki, és nyisd meg a PHP-fájlt szövegszerkesztőben.
2. A 20. sorban cseréld ki a `https://www.example.com/sitemap_index.xml` címet a saját oldaltérképed URL-jére.
3. Mentsd el, és csomagold vissza ZIP-be.
4. A WordPressben a **Bővítmények → Új hozzáadása → Bővítmény feltöltése** menüben töltsd fel.
5. Aktiváld a bővítményt.

A következő előtöltéstől csak az oldaltérkép URL-jei töltődnek elő, a többi csak látogatás után gyorsítótárazódik.

## Oldaltérképek és sorrend testreszabása

Alapból az előtöltés a kompatibilis oldaltérképeken keresztül találja meg az URL-eket, mindegyiket beírja az adatbázis `wp_wpr_rocket_cache` táblájába, és a látogatott URL-eket is felveszi, ha még nincsenek benne. Az előtöltés sorrendje a tábla `modified` értékétől függ: a legrégebben módosított jön előbb. Egy szerkesztett bejegyzés nem előzi meg a sorban állókat, hanem a sor végére kerül.

Ezen a `rocket_sitemap_preload_list` és a `rocket_preload_order` szűrővel változtathatsz. Egy kisegítő bővítmény (Preload Sitemap Control) ezekhez nyújt keretet. Vele:

- csak megadott oldaltérképeket töltethetsz elő, vagy újakat adhatsz hozzá;
- csak az oldaltérképeken szereplő oldalakat töltheted elő;
- megváltoztathatod az előtöltés sorrendjét;
- egyedi oldaltérképet adhatsz meg.

A bővítmény nem működik magától, a PHP-fájlját előbb szerkeszteni kell:

1. Töltsd le a ZIP-et és csomagold ki.
2. Nyisd meg a `wp-rocket-preload-sitemap-control.php` fájlt szövegszerkesztőben.
3. Írd át a kívánt testreszabásokat a mellékelt README szerint.
4. Mentsd el, és csomagold vissza ZIP-be.
5. A **Bővítmények → Új hozzáadása → Bővítmény feltöltése** menüben töltsd fel, és aktiváld.

Aktiváláskor a bővítmény kiüríti a gyorsítótár-tábla összes URL-jét. Az eredményt a `wp_wpr_rocket_cache` táblában ellenőrizheted. Ez haladó beállítás: a legtöbb oldalnak az alapértelmezett működés megfelel.

## Előtöltés sütik szerint

Néha egy dinamikus süti meghatározott értékeire akarsz előtöltést, nem az alapváltozatra. Egy kisegítő bővítménnyel megteheted:

1. Töltsd le a ZIP-et, csomagold ki, és nyisd meg a PHP-fájlt szövegszerkesztőben.
2. A 49-53. sorban írd át a süti nevét és az előtöltendő értékeket.
3. Két süti esetén vedd ki a megjegyzést a második csoport elől. A példa két sütit tölt elő: a `currency` sütit `usd` és `eur` értékkel, a `lang` sütit `en` és `es` értékkel:

```php
$cookies = [ 'currency' => [ 'usd', 'eur' ], 'lang' => [ 'en', 'es' ] ];
```

4. Mentsd el, és csomagold vissza ZIP-be.
5. A **Bővítmények → Új hozzáadása → Bővítmény feltöltése** menüben töltsd fel, aktiváld, majd ürítsd a gyorsítótárat.

Figyelj rá: ha egy látogatás már legenerálta az oldalt (például `currency=usd` és `lang=en` értékkel) az előtöltés előtt, az előtöltés az összes többi változatot kihagyja.

### Egyetlen süti értékének előtöltése

Egyetlen süti-érték előtöltéséhez ezt a kódot használd. A `cookie_name` és `cookie_value` helyére a süti nevét és értékét írd:

```php
function custom_cookie_preload( $args ) {
	$cookie = new WP_Http_Cookie( 'cookie_name' );
	$cookie->name = 'cookie_name';
	$cookie->value = 'cookie_value';
	$cookies[] = $cookie;

	$args['cookies'] = $cookies;

	return $args;
}
add_filter( 'rocket_preload_url_request_args', 'custom_cookie_preload', PHP_INT_MAX );
```

A kódot a gyermektéma `functions.php` fájljába vagy egy kódrészlet-kezelő bővítménybe másold.
