# LazyLoad iframe-ekhez és videókhoz

> Az iframe-ek és beágyazott videók késleltetett betöltése, a YouTube-iframe előnézeti képre cserélése, az előnézet felbontása és a kikapcsolás módjai.

A **Bekapcsolás iframe-eknél és videóknál** jelölőnégyzet (**Beállítások → WP Rocket → Oldaloptimalizálás → Kép és média**, LazyLoad szakasz) az iframe-ek betöltését addig halasztja, amíg a látogató el nem ér az oldal azon részéig, ahol az iframe van.

Ha a látogatók nem görgetik végig az oldalt, az oldal kisebb marad, és a mobil adatforgalmat sem kell fizetniük a nem látott tartalomért. Ez különösen a gyengébb eszközökön és lassabb hálózaton számít. A funkció segít a PageSpeed „Nem használt JavaScript csökkentése” javaslatánál is, ha az a nézetablakban lévő iframe-ek szkriptjeire vonatkozik.

> Csak az `iframe` címkével beágyazott videók dolgozhatók fel. A `video` címkével megadott videókra a funkció nem hat.

## Hogyan működik?

1. A WP Rocket megkeresi az `iframe` címkéket az oldal forráskódjában.
2. Hozzáadja az iframe-hez a `loading="lazy"` attribútumot.
3. Amikor a látogató eléri az iframe-et, az iframe szkriptjei betöltődnek, és az iframe megkapja a `data-ll-status="loaded"` attribútumot.

## Hogyan ellenőrizheted?

### A jelölés változásai

1. Nyisd meg egy olyan oldalt, ahol az iframe a nézetablak alatt van.
2. Nyisd meg a fejlesztői eszközöket (Chrome: menü → More Tools → Developer Tools → Elements; Firefox: Web Development → Inspector; Safari: Develop → Connect Web Inspector → Elements).
3. Jelöld ki az iframe-et. Ott lesz a `data-loading="lazy"`, a `data-rocket-lazyload` és a `data-lazy-src` attribútum, a `lazyloaded` osztály, és az iframe után egy `<noscript>` címke.

### Az iframe szkriptjeinek késleltetése

1. Nyisd meg ugyanazt az oldalt, és a fejlesztői eszközökben kattints a **Network** fülre.
2. Szűrj a JavaScriptre.
3. Az iframe-hez tartozó szkriptek csak akkor töltődnek be, amikor a görgetéssel elérsz az iframe-ig.

## YouTube-iframe cseréje előnézeti képre

A **YouTube-iframe cseréje előnézeti képpel** jelölőnégyzet az iframe-es LazyLoad alopciója, és csak akkor jelenik meg, ha az iframe-es LazyLoad be van kapcsolva. A YouTube-iframe helyére a YouTube által beállított miniatűrt teszi, a videó pedig csak akkor töltődik be, ha a látogató rákattint. A funkció a harmadik féltől származó erőforrások kirakatképpel történő késleltetésére vonatkozó PageSpeed-javaslatot kezeli. A legtöbb jelölés kompatibilis vele, a YouTube megosztás funkciója által adott kód is.

Az előnézet felbontását segédbővítménnyel választhatod meg. A bővítmény PHP-fájlját előbb át kell írni a kívánt felbontásra. A lehetséges értékek:

| Érték | Mit ad |
|---|---|
| `default` | alapértelmezett kép |
| `mqdefault` | közepes méretű miniatűr |
| `sddefault` | nagy méretű miniatűr |
| `hqdefault` | normál méret |
| `maxresdefault` | a legnagyobb elérhető felbontás |

A miniatűrt a YouTube adja, saját képet nem kell megadnod. A telepítés lépései:

1. Szerkeszd a segédbővítmény PHP-fájlját, és írd be a kívánt felbontást.
2. Töltsd fel a **Bővítmények → Új hozzáadása → Bővítmény feltöltése** oldalon, és aktiváld.
3. Ürítsd a WP Rocket gyorsítótárát.

### Az előnézet kiterjesztése

Alapból a miniatűr JPG. WebP-re ezzel a kódrészlettel állíthatod (gyermektéma `functions.php`, saját funkcióbővítmény vagy kódrészlet-kezelő):

```php
add_filter( 'rocket_lazyload_youtube_thumbnail_extension', function( $extension ){
  return 'webp';
});
```

### Hogyan ellenőrizheted, hogy működik?

A jelölésen: nyisd meg az oldalt, és a fejlesztői eszközökkel jelöld ki a YouTube-iframe-et. A gyorsítótárazott oldalon (a gyorsítótár nélkülin ezek nincsenek meg) ezt látod:

- az iframe-en megjelenik az `rll-youtube-player` osztály;
- az előnézeti kép külön `img` címkében van, `src`, `width` és `height` paraméterrel;
- ha a képek LazyLoadja is be van kapcsolva, az `img` megkapja a `loading="lazy"`, a `class="lazyloaded"` és a `data-ll-status="loaded"` attribútumokat.

A **Network** fülön:

1. Nyisd meg az oldalt, ahol a YouTube-iframe van.
2. Nyisd meg a fejlesztői eszközöket, és kattints a **Network** fülre.
3. Szűrj a JS-re.
4. Kattints a lejátszás gombra.

A YouTube fájljai (például `embed.js`, `remote.js`, `endscreen.js`) csak a kattintás után töltődnek be. Ha a funkció ki van kapcsolva vagy nem működik, ezek az oldal betöltésekor azonnal betöltődnek.

### Kompatibilis jelölés

A funkció azokat az `iframe` címkéket keresi, amelyeknek az `src` attribútuma YouTube-URL-t tartalmaz. Példa:

```html
<iframe class="tcb-responsive-video" data-code="g_v3gxJYM0Q" data-provider="youtube" src="https://www.youtube.com/embed/g_v3gxJYM0Q?rel=0&modestbranding=0&controls=1&showinfo=1&fs=1&wmode=transparent" data-src="https://www.youtube.com/embed/g_v3gxJYM0Q?rel=0&modestbranding=0&controls=1&showinfo=1&fs=1&wmode=transparent" frameborder="0" allowfullscreen=""></iframe>
```

### Ismert problémák

- Néha üres hely kerülhet az iframe alá vagy fölé.
- Ha a Complianz bővítményben a **Szolgáltatások** részen be van kapcsolva a YouTube blokkolása, a funkció nem működik, mert a bővítmény úgy írja át a videó jelölését, hogy a WP Rocket nem ismeri fel. Kapcsold ki ezt a blokkolást.

Az előnézeti képeket a [Kritikus képek optimalizálása](https://hub.hellowp.io/hu/plugins/wp-rocket/media-kritikus-kepek/) is kezeli.

## Hibaelhárítás

Ha egy iframe elromlik a LazyLoadtól, zárd ki az adott iframe-et vagy oldalt.

### Kizárás a beállításokban

A **Kizárt képek vagy iframe-ek** mezőbe írj az iframe kódjából egy kulcsszót, soronként egyet. Egy ilyen iframe esetén:

```html
<iframe title="Bemutató videó" width="580" height="326" src="https://www.youtube.com/embed/AZONOSITO?feature=oembed" allowfullscreen></iframe>
```

kizáráshoz használhatod:

- a címet: `Bemutató videó`;
- a beágyazási forrást: `https://www.youtube.com/embed/AZONOSITO?feature=oembed`;
- a domaint: `youtube.com`, ez az összes youtube.com-os iframe-et kizárja.

### Kizárás egy oldalon

A **WP Rocket beállítások** doboz az iframe-es LazyLoadot is kikapcsolja az adott bejegyzésen vagy oldalon, lásd a [LazyLoad kizárása képekre és oldalakra](https://hub.hellowp.io/hu/plugins/wp-rocket/lazyload-kizaras/) fejezetet.

### Kizárás kóddal

Az iframe-ek LazyLoadját a `do_rocket_lazyload_iframes` szűrővel kapcsolhatod ki:

```php
add_filter( 'do_rocket_lazyload_iframes', '__return_false' );
```

Például csak a WooCommerce egyedi termékoldalain:

```php
function rocket_lazyload_deactivate_on_single_product() {
	if ( is_singular( 'product' ) ) {
		add_filter( 'do_rocket_lazyload_iframes', '__return_false' );
	}
}
add_filter( 'wp', 'rocket_lazyload_deactivate_on_single_product' );
```
