# Késleltetett betöltés

> Képek, iframe-ek, videók és CSS-háttérképek halasztott betöltése, kivételek, szűrők és hibaelhárítás.

A késleltetett (lazy) betöltés azt jelenti, hogy a kép vagy a beágyazott tartalom csak akkor töltődik be, amikor a látogató a látómezőbe görgeti. Egy hosszú bejegyzésnél, ahol sok kép van, ez a kérések és az átvitt adat nagy részét megspórolja (egy 100 képes bejegyzésnél a böngésző alapból mind a százat letöltené), és eltünteti a PageSpeed Insights „Defer offscreen images” figyelmeztetését. Egy már amúgy is optimalizált bejegyzésnél a mérésben a kérések száma 56-ról 35-re, az oldalméret 852 KB-ról 245 KB-ra csökkent, a betöltési idő 1,2 mp-ről 0,8 mp-re rövidült. Optimalizálatlan képeknél vagy több képnél a különbség nagyobb.

A bővítmény egy kicsi (kb. 2,5 KB), nyílt forráskódú JavaScript-könyvtárat használ, amelyet a `/perfmatters/js/lazyload.min.js` fájlból töltesz le. A WebP-képeket is támogatja. Amikor a Perfmattersben bekapcsolod, a WordPress beépített késleltetett betöltése magától kikapcsol, mert a bővítmény megoldása agresszívebb: támogatja a CSS-háttérképeket, és nem függ attól, hogy a kép szerepel-e a médiatárban.

## Miért jobb a WordPress beépített megoldásánál?

A WordPress 5.5 óta alapból késlelteti a képeket, de a böngészőre bízza a döntést, és a böngésző ebben túl türelmetlen: kevesebb képet halaszt, ezért kisebb a nyereség. Emellett csak a médiatárba feltöltött, megadott szélességű és magasságú képekre működik, a CSS-háttérképeket nem kezeli, és kevesebb beállítása van. A Perfmatters megoldása bekapcsolva automatikusan kiváltja a WordPress beépített késleltetését.

Mielőtt bekapcsolod, kapcsold ki a késleltetett betöltést minden más helyen (egyéb optimalizáló bővítmények, sablon, Cloudflare Mirage, oldalépítők, például Bricks).

![A Késleltetett betöltés fül beállításai](./kepek/kesleltetett-betoltes.webp)

*A Késleltetett betöltés fül beállításai* (https://minta-bolt.hu/wp-admin/)

A képen az összes beállítás látszik bekapcsolva, a **CSS-háttérképek** szakasszal együtt.

## Beállítások

| Beállítás | Mit csinál |
| --- | --- |
| **Képek** | Késleltetett betöltést ad a képeknek. A `style` attribútumban lévő beágyazott háttérképekre is vonatkozik. |
| **Az első képek kizárása** | Automatikusan kizár néhány vezető (az oldal tetején lévő) képet a késleltetésből. 0 és 5 között választhatsz. |
| **iFrame-ek és videók** | Késlelteti az iframe-eket (YouTube, Vimeo, SoundCloud, Google Maps és bármilyen más) és a `video` címkével beágyazott videófájlokat. |
| **YouTube előnézeti bélyegképek** | A YouTube-iframe helyett egy előnézeti képet és egy könnyű lejátszás ikont mutat, az iframe csak kattintásra töltődik be. Az **iFrame-ek és videók** funkciót is be kell kapcsolni hozzá. |
| **Kizárás a halasztott betöltésből** | Azok az elemek, amelyeket nem szabad késleltetni. Add meg a forrás-URL-t (például `example.png`) vagy az elem attribútumainak egy egyedi részletét (például `class="example"`), soronként egyet. |
| **Kizárás szülőszelektor alapján** | Haladó opció. Azokat a képeket zárja ki, amelyek szülőelemének attribútumai egyeznek a megadott szöveggel. |
| **Küszöbérték** | Mennyivel a látómező elé töltődjön be a kép (px vagy %). Alapértéke 0px, ami a legagresszívebb. Nagyobb érték kevesebb „beugrást” ad görgetéskor. |
| **DOM-figyelés** | Figyeli az oldal változásait, és a később hozzáadott elemeket is késlelteti. Végtelen görgetésnél, galériáknál, körhintáknál, AJAX-os lapozásnál hasznos. Ha nincs ilyened, ne kapcsold be. |
| **Képméretek hozzáadása** | A hiányzó `width` és `height` attribútumokat pótolja a képeken. |
| **Előtűnés** | Halványodó megjelenést ad a képeknek, amikor betöltődnek. |

Az **Az első képek kizárása** pontos értékét kijelentkezve érdemes meghatároznod. Az automatikus kizárás a háttérképeket nem érinti. Ha a [kritikus képek előtöltése](https://hub.hellowp.io/hu/plugins/perfmatters/elobetoltes/) be van kapcsolva, az ott előtöltött képek magától ki vannak zárva a késleltetésből, ilyenkor valószínűleg nincs szükség erre a beállításra.

### Képek kizárása

- **A beállításon keresztül:** a **Kizárás a halasztott betöltésből** mezőbe írd a kép URL-jét vagy egyedi attribútumrészletét. Ha egy bővítmény (például ShortPixel vagy Imagify) WebP-képet szolgál ki, lehet, hogy a `<picture>` címkét kell megcéloznod. Egy GeneratePress-logó például az `is-logo-image` osztállyal zárható ki.
- **Szülőszelektorral:** sok kiemelt kép vagy galéria képén nincs egyedi osztály, de a szülő elemén van. Ezt a haladó **Kizárás szülőszelektor alapján** mező kezeli.
- **`no-lazy` osztállyal:** ha hozzá tudsz adni CSS-osztályt a képhez, add hozzá a `no-lazy` osztályt, és a bővítmény figyelmen kívül hagyja.
- **Egy oldal kizárása:** a szerkesztő jobb oldali paneljén szedd ki a **Lazy Loading** jelölőnégyzetet. A panel csak adminisztrátoroknak látszik. Ez a teljes oldalt, bejegyzést vagy egyedi tartalomtípust kiveszi a késleltetésből.
- **Szűrővel:** ha a képhez nehezen férsz hozzá, a `perfmatters_lazyload_excluded_attributes` szűrővel adhatsz meg kizárandó attribútumokat vagy azok részleteit. Az egyezés egyszerű szövegegyezés, ezért az attribútum (vagy része) pontosan egyezzen a kizárandó kép(ek)ével:

```php
function perfmatters_lazyload_exclude_attributes($attributes) {
    $attributes[] = "title='Perfmatters'";
    $attributes[] = "class='size-full";
    $attributes[] = 'src="https://example.com/kep.png"';

    return $attributes;
}
add_filter('perfmatters_lazyload_excluded_attributes', 'perfmatters_lazyload_exclude_attributes');
```

![A Késleltetett betöltés fül haladó beállításokkal: kizárás szülőszelektor alapján és az elemek késleltetése](./kepek/betoltes-keslelteto-halado.webp)

*A Késleltetett betöltés fül haladó beállításokkal: kizárás szülőszelektor alapján és az elemek késleltetése* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters)

A képen a **Haladó opciók mutatása** bekapcsolása után megjelenő **Kizárás szülőszelektor alapján** és **Halasztott betöltésű elemek** szakaszt láthatod.

### Az első képek automatikus kizárása

Az **Az első képek kizárása** beállítással a felső, látómezőben lévő képek (logó, kiemelt kép, nyitókép) nem késnek. Ez azért fontos, mert egy késleltetett LCP-kép rontja a Largest Contentful Paint értékét, és a PageSpeed Insights „Largest Contentful Paint image was lazily loaded” figyelmeztetését adja ([részletek](https://hub.hellowp.io/hu/plugins/perfmatters/betoltes-lcp-kep/)). A mérést mindig kijelentkezve végezd.

### Kényszerített késleltetés

Előfordul, hogy egy másik bővítménytől vagy sablonból érkező elem már hordoz kizáró osztályt vagy attribútumot, ezért a Perfmatters nem késlelteti. A `perfmatters_lazyload_forced_attributes` szűrővel kikényszerítheted a késleltetést: ha az elem tartalmazza a megadott attribútumot, a kizárások ellenőrzése kimarad, és a bővítmény késlelteti az elemet.

```php
function perfmatters_lazyload_force_attributes($attributes) {
    $attributes[] = "title='Perfmatters'";
    $attributes[] = "class='size-full";

    return $attributes;
}
add_filter('perfmatters_lazyload_forced_attributes', 'perfmatters_lazyload_force_attributes');
```

### Küszöbérték és előtűnés

A **Küszöbérték** alapértéke 0px: a kép akkor kezd betöltődni, amikor belép a látómezőbe. Ez a leggyorsabb, de görgetéskor a képek „beugorhatnak”. Nagyobb értékkel (px vagy %) a képek hamarabb betöltődnek, a görgetés egyenletesebb. A mezőn kívül a `perfmatters_lazyload_threshold` szűrő is állíthatja:

```php
add_filter('perfmatters_lazyload_threshold', function($threshold) {
    return '500px';
});
```

Sok külső JavaScriptet futtató oldalon (például hirdetési hálózatokkal, Mediavine vagy AdThrive) legalább 300px ajánlott.

Az **Előtűnés** kapcsoló halványodva jeleníti meg a betöltött képeket. Az animáció sebességét a `perfmatters_fade_in_speed` szűrő módosítja.

### YouTube előnézeti bélyegképek

A funkció a YouTube-videók terheléséből eredő blokkolási időt (TBT) szünteti meg, és kisebb oldalméretet ad. Az előnézeti kép a YouTube-ról automatikusan jön. Alapból alacsony felbontású képet tölt le. Ha extra hely jelenik meg a bélyegkép alatt vagy fölött, az általában azért van, mert az oldalépítő ugyanazt a módszert használja a videótárolóhoz. A Divi saját YouTube-beágyazásánál lehet, hogy a Divi átfedő rétegét (`.et_pb_video_overlay`) el kell rejtened CSS-sel.

A bélyegkép felbontását a `perfmatters_lazyload_youtube_thumbnail_resolution` szűrővel módosíthatod. A `maxresdefault` a legjobb elérhető minőséget kéri (a YouTube-bélyegkép legyen legalább 1280 × 720 képpont):

```php
add_filter('perfmatters_lazyload_youtube_thumbnail_resolution', function($resolution) {
    return 'maxresdefault';
});
```

Ha mobilon alacsony, asztali gépen magas felbontást szeretnél:

```php
add_filter('perfmatters_lazyload_youtube_thumbnail_resolution', function($resolution) {
    if(!wp_is_mobile()) {
        $resolution = 'maxresdefault';
    }
    return $resolution;
});
```

Ha extra hely marad a bélyegkép fölött vagy alatt, ezzel a CSS-sel javíthatod:

```css
/* Bricks */
.brxe-video .perfmatters-lazy-youtube {
    margin-top: -56.25%;
}

/* Oxygen */
.oxygen-vsb-responsive-video-wrapper .perfmatters-lazy-youtube {
    margin-bottom: -56.25%;
}
```

Ha GDPR-bővítményt is használsz (például Complianz), előfordulhat, hogy az blokkolja a betöltést. Complianznál a `cmplz-iframe` iframe-et ki kell zárnod a késleltetésből.

## CSS-háttérképek

A beágyazott (inline) háttérképekhez külön beállítás nem kell. Ha viszont az oldalépítő vagy a sablon a háttérképet a CSS-fájlban adja meg, a Perfmatters nem módosíthatja a fájl tartalmát, de megakadályozhatja, hogy bizonyos tárolók azonnal betöltsék a háttérképüket. Ez működik például GenerateBlocks, Elementor, Oxygen, Divi és Beaver Builder esetén is.

| Beállítás | Mit csinál |
| --- | --- |
| **Háttérképek** | Bekapcsolja a CSS-háttérképek késleltetett betöltését. |
| **Háttérszelektorok** | A tároló (vagy szülője) egyedi azonosítója vagy osztálya, előtag (`.`, `#`) nélkül, soronként egy. Támogatott elemek: `div`, `section`, `figure`, `footer`. |
| **Első elemek kizárása** | Az első találattól kezdve ennyi háttérképes tárolót kizár a késleltetésből (0 és 5 között). Így a nyitókép biztosan azonnal betöltődik. |

Ha az oldalépítőben nem tudsz egyedi osztályt adni a tárolónak, add hozzá a `perfmatters-lazy-css-bg` osztályt. Elementorban ezt a tároló **CSS-osztályok** mezőjébe írd. Ha a háttérképen `!important` szabály van, a késleltetés nem tud rajta változtatni.

## Halasztott betöltésű elemek

Haladó opció. Az **Elemek** kapcsolóval tetszőleges DOM-elemeket (és leszármazottaikat) késleltethetsz. Az **Elemszelektorok** mezőbe a szülőelem attribútumának egyedi részletét írd, soronként egyet. Részletek: [Elemek késleltetése és a DOM mérete](https://hub.hellowp.io/hu/plugins/perfmatters/betoltes-elemek/).

## Hibaelhárítás

- **A kép forrása SVG-kódnak látszik** (`data:image/svg+xml,...`) és nem töltődik be: valószínűleg halasztod a késleltető szkriptet. Zárd ki a `/perfmatters/js/lazyload.min.js` fájlt a [JavaScript halasztásából](https://hub.hellowp.io/hu/plugins/perfmatters/javascript/).
- **A képek nem töltődnek be:** ellenőrizd, hogy nem fut-e egyszerre több késleltetett betöltés.
- **Háttérkép nem késleltethető:** ha a sablon `!important` szabályt használ, a bővítmény nem tud mit tenni. Ez egyébként is rossz gyakorlat, csak végszükségben használd.
- **Más késleltető megoldások:** a Cloudflare Mirage, az optimalizáló bővítmények vagy az oldalépítők (például Bricks) saját késleltetése ütközhet. Egyszerre csak egy fusson.
- **Divi saját YouTube-beágyazása:** el kell rejtened a Divi átfedő rétegét, hogy a bélyegkép működjön: `.et_pb_video_overlay { display: none; }`.
- **Képek feltöltés nélkül, külső forrásból:** a **Képméretek hozzáadása** csak a helyben vagy a CDN-en tárolt képekre működik ([részletek](https://hub.hellowp.io/hu/plugins/perfmatters/betoltes-kepek-meretei/)).
