# Telepítési és frissítési hibák

> A Yoast SEO telepítése és frissítése közben előforduló gyakori hibák okai és megoldásai.

Ritkán előfordul, hogy a Yoast SEO vagy valamelyik kiegészítője telepítése vagy frissítése hibaüzenettel áll meg. Az alábbiakban a gyakori hibákat és a megoldásukat találod.

## Nem látom a „Bővítmény hozzáadása” lehetőséget

Ellenőrizd, hogy van-e jogosultságod bővítményt telepíteni. Multisite hálózatban a bővítményt a hálózati adminisztrációban kell telepítened: **Webhelyeim → Hálózati adminisztráció → Bővítmények**.

## A letöltés mappa, nem zip-fájl

Ha zip helyett mappát kapsz, a számítógéped azonnal kicsomagolja a letöltött archívumot. A kikapcsolás módja böngészőnként más (Safarinál az „automatikus kicsomagolás” beállítás). Átállítás után töltsd le újra a bővítményt.

## Frissítés FTP-vel

Ha a felületi frissítés nem megy, a bővítményt kézzel is frissítheted: töltsd le a zip-et, csomagold ki, és FTP-n másold a `wp-content/plugins` mappába a régi helyére.

## „Could not create directory” (a mappa nem hozható létre)

**Ok:** a szerveren a hibaüzenetben szereplő fájl vagy mappa nem írható.

**Megoldás:** gondoskodj róla, hogy a teljes útvonal írható legyen (FTP-n ellenőrizheted). Ha nem tudod, hogyan, kérj segítséget a tárhelyszolgáltatótól. Windows-szervereken ez a hiba a fájlnévhossz-korlát miatt is előjöhet, ilyenkor frissíts kézzel FTP-n.

## „Destination folder already exists” (a célmappa már létezik)

**Ok:** a bővítmény már telepítve van, vagy átnevezted a bővítménymappát. Ritkán a telepítés félbeszakad, és a mappa hiányos vagy sérült fájlokkal marad.

**Megoldás:** WordPress 5.5-től vagy újabban a feltöltés közben felkínálja a meglévő felülírását a feltöltött zip-pel, ezt válaszd. Régebbi WordPressnél frissíts, vagy töröld előbb kézzel a bővítménymappát, és töltsd fel újra.

## „Uploaded file exceeds the upload_max_filesize directive in php.ini”

**Ok:** a tárhely korlátozza a feltölthető fájl méretét.

**Megoldás:** kérd meg a tárhelyszolgáltatót, hogy emelje meg a korlátot. Ha értesz a szerverkezeléshez, a `upload_max_filesize` értéket a `php.ini`-ben is átállíthatod. Másik lehetőség a kézi frissítés FTP-vel.

## „Fatal error: Allowed memory size exhausted”

A teljes hibaüzenet így kezdődik: `Fatal error: Allowed memory size of #### bytes exhausted (tried to allocate #### bytes) in …`.

**Ok:** a szervernek elfogyott a memóriája a feladathoz. A hibát okozó bővítményt vagy témát általában a `/wp-content/` utáni útvonalrész árulja el.

**Megoldás:** növeld a memóriát, vagy csökkentsd a feladatok számát.

A memória növeléséhez használd az alábbiak egyikét:

1. Add ezt a `wp-config.php` fájlhoz: `define('WP_MEMORY_LIMIT', '256M');`
2. Állítsd át a szerver `php.ini` fájljában: `memory_limit = 256M;`
3. Add ezt a `.htaccess` fájlhoz: `php_value memory_limit 256M`

A tárhelyszolgáltatótól is kérhetsz segítséget.

A feladatok csökkentéséhez:

1. Kapcsold ki és töröld a már nem használt bővítményeket.
2. Csökkentsd az egyszerre futó feladatok számát, vagy ideiglenesen kapcsold ki a nem létfontosságú bővítményeket.

## „Download failed. server certificate verification failed”

A teljes üzenet: `Download failed. server certificate verification failed. CAfile: [útvonal] CRLfile: none`.

**Ok:** a webhelyed nem ismeri fel a yoast.com SSL-tanúsítványát.

**Megoldás:** kérd meg a tárhelyszolgáltatót, hogy vegye fel a tanúsítványt a megbízhatók közé. Addig frissítsd a bővítményt kézzel FTP-n.

## cURL-hibák

Frissítés közben ezek közül láthatsz egyet:

- `Download failed. SSL: certificate subject name '*.mycloudproxy.com' does not match target host name 'yoast.com'`
- `Request error: "cURL error 35: error:1407742E:SSL routines:SSL23_GET_SERVER_HELLO:tlsv1 alert protocol version"`
- `Download failed. cURL error 51: SSL: no alternative certificate subject name matches target host name 'yoast.com'`
- `Request error: "cURL error 35: Peer reports incompatible or unsupported protocol version."`
- `Request error: "cURL error 35: SSL connect error`

**Ok:** a Premium bővítmények frissítési értesítéséhez a szervernek meg kell felelnie a [rendszerkövetelményeknek](https://hub.hellowp.io/hu/plugins/wordpress-seo-premium/elso-lepesek-kovetelmenyek/). Ezek a hibák azt jelzik, hogy a szerver régi cURL-, TLS- és/vagy OpenSSL-verziót használ. A frissítési kérés biztonságos kapcsolaton megy, mert tartalmazza a webhely adatait és az előfizetési kulcsot. A kapcsolatok webalkalmazás-tűzfalon haladnak át, amelyhez az SNI (Server Name Indication) kell. Ezt minden 2008 márciusa utáni cURL támogatja.

**Megoldás:** a hiba a tárhely oldalán van, jelezd nekik. Addig frissíts kézzel FTP-n. Ha a szolgáltató nem javítja, érdemes másikat keresni, mert az elavult szoftver biztonsági kockázat.

## „Fatal error: Cannot instantiate abstract class WPSEO_Redirect_Manager”

A teljes üzenet: `Fatal error: Cannot instantiate abstract class WPSEO_Redirect_Manager in /…/wp-content/plugins/wordpress-seo-premium/… on line ##`.

**Ok:** a korábban megadott átirányítások nem frissültek az új formátumra, vagy a frissítés gyorsítótár-ütközés (főleg Opcode cache) miatt nem érvényesült.

**Megoldás:**

1. Frissítsd a Yoastot a legújabb verzióra.
2. Ürítsd ki az összes gyorsítótárat, a szerveroldalit is (Opcode cache). Szólj a tárhelyszolgáltatónak, ha ők kezelik. Ritkán kell ideiglenesen kikapcsolni a gyorsítótár-bővítményt.
3. Ha ez sem segít, kapcsold ki a Yoast SEO Premiumot, telepítsd és kapcsold be ideiglenesen az ingyenes Yoast SEO-t, töröld a Premiumot, és ha a hiba megszűnt (ez pár percig tarthat), telepítsd újra a Premiumot.
4. Ürítsd a `wpseo_premium_version` tranzienst (például egy Transients Manager bővítménnyel), hogy az átirányítás-frissítés újra lefusson.

## Fehér képernyő

**Ok:** bővítmény vagy téma aktiválása közben ütközés lép fel, és a képernyő üres marad.

**Megoldás:** kapcsold ki sorban a többi bővítményt, és válts alapértelmezett témára, hogy kiderüljön, melyik okozza az ütközést. A Yoast bővítményt ezután kapcsold be újra.

Ha a hiba miatt az admin felületre sem tudsz belépni, a bővítménymappa átnevezésével visszakaphatod a hozzáférést:

1. Szerezd be az FTP- vagy SFTP-hozzáférésed adatait (szerver, felhasználónév, jelszó, port), ha nincsenek meg, a tárhelyszolgáltatótól.
2. Készíts mentést a webhelyről.
3. Csatlakozz FTP-programmal (például FileZillával) a webhelyhez.
4. Lépj a `/WordPress_útvonala/wp-content/` mappába.
5. Nevezd át a `plugins` mappát `plugins.old` névre.
6. Jelentkezz be a WordPress adminfelületére. Mivel a mappa át lett nevezve, minden bővítmény kikapcsolódik.
7. FTP-n nevezd vissza a mappát `plugins` névre. A kikapcsolt bővítmények így újra megjelennek a **Bővítmények** oldalon.
8. Kapcsold be a bővítményeket egyenként, így megtalálod az ütköző bővítményt.

## Composeres telepítés hibái

A Composer 2.0 másként rangsorolja a csomagtárakat, ezért add meg az `only` szűrőt a Yoast tárhoz, a [telepítés](https://hub.hellowp.io/hu/plugins/wordpress-seo-premium/elso-lepesek-telepites/) fejezetben látható módon.