# Telepítési problémák

> Mit tegyél, ha a bővítmény ZIP-fájlja letölthető, de a WordPress nem tudja telepíteni: ellenőrzés, kézi telepítés SFTP-vel, a tárhely teendői.

Ez a fejezet arra az esetre szól, amikor a bővítmény ZIP-fájlja hibátlanul letöltődik, de a WordPress nem tudja telepíteni. A tapasztalat szerint szinte mindig a szerver vagy egy előtte álló tűzfal utasítja el a feltöltést, nem a ZIP a hibás.

## Tünetek

Ezek bármelyike blokkolt vagy megszakadt feltöltésre utal:

- a **Bővítmények → Új hozzáadása → Bővítmény feltöltése** végtelenül pörög, és nem történik semmi,
- a feltöltés üres oldallal, fehér képernyővel vagy HTTP 500 hibával végződik,
- ilyen üzenetet látsz: `Installation failed`, `The link you followed has expired` vagy `HTTP error`,
- 403 Forbidden vagy 413 hiba jön, vagy a kapcsolat feltöltés közben megszakad,
- a WordPress FTP-adatokat kér a telepítés befejezéséhez.

## 1. lépés: A ZIP és a bővítmény kizárása

1. Töltsd le újra a ZIP-fájlt. A megszakadt letöltés csonka archívumot hagy, amit egyetlen szerver sem tud telepíteni.
2. Nyisd meg a ZIP-et a gépeden. Pontosan egy bővítménymappát kell tartalmaznia. Ha a böngésző vagy a macOS magától kicsomagolta, és te csomagoltad vissza a mappát, gyakran beágyazott szerkezet jön létre, amit a WordPress elutasít. Mindig az eredeti fájlt töltsd fel.
3. Próbálj meg feltölteni egy hasonló méretű, másik bővítményt, például egy wordpress.org-ról letöltöttet. Ha az is elbukik, a hiba a szerverben van, és a fejezet többi része rád vonatkozik.

## 2. lépés: Telepítés SFTP-vel vagy FTP-vel

Ez a leggyorsabb megoldás. Megkerüli a WordPress feltöltőjét, és vele együtt minden szerverszabályt, ami a feltöltést blokkolja.

1. Csomagold ki a ZIP-et a gépeden. Egyetlen, a bővítményről elnevezett mappát kapsz (a Pixel Managernél ez a `woocommerce-google-adwords-conversion-tracking-tag`).
2. Csatlakozz a szerverhez SFTP- vagy FTP-klienssel, vagy nyisd meg a tárhely vezérlőpultjának fájlkezelőjét.
3. Ha ugyanannak a bővítménynek egy régebbi változatát cseréled, előbb kapcsold ki a WordPressben, aztán nevezd át a `wp-content/plugins/` alatti mappáját úgy, hogy a végére írod: `-old`. Átnevezd, ne töröld a WordPress **Törlés** gombjával, mert az a bővítmény eltávolító rutinját is lefuttatja, és eldobhatja a beállításokat.
4. Töltsd fel a kicsomagolt mappát a `wp-content/plugins/` könyvtárba.
5. A WordPressben nyisd meg a **Bővítmények** oldalt. A bővítmény megjelenik a listában. Kapcsold be, és add meg a licenckulcsot.
6. Ha minden működik, töröld az átnevezett régi mappát.

A beállítások és a licenc az adatbázisban vannak, nem a bővítménymappában, ezért a kézi telepítés mindkettőt megtartja.

Ha van SSH-hozzáférésed, egyetlen paranccsal ugyanez megoldható:

```bash
wp plugin install /utvonal/a/bovitmeny.zip --activate
```

A bővítmény Composerrel is telepíthető, ha a ZIP-et teljesen ki akarod hagyni.

## 3. lépés: Javíttasd ki az okot a tárhellyel

A kézi telepítés kerülőút. A következő bővítményfeltöltésnél vagy frissítésnél ugyanebbe a falba ütközöl, ezért érdemes a szerverbeállítást rendbe tenni. A szokásos okok:

| Ok | Mit látsz általában |
|---|---|
| Túl alacsony `upload_max_filesize` vagy `post_max_size` | A feltöltő azonnal elutasítja a fájlt, vagy a hibaüzenet korlát túllépéséről szól |
| Túl alacsony `max_execution_time` vagy `memory_limit` | Hosszú pörgés, utána üres oldal vagy HTTP 500 |
| mod_security vagy WAF szabály a bővítményfeltöltő végponton | 403 Forbidden, általános „blokkolva” oldal vagy megszakadt kapcsolat |
| Kérésméret-korlát a webhely előtti fordított proxyban vagy CDN-ben | 413 hiba, gyakran miután a feltöltés már befejezettnek látszott |
| Rossz tulajdonos vagy jogosultság a `wp-content/plugins/` mappán, vagy csak olvasható fájlrendszer | A WordPress FTP-adatokat kér, vagy nem tud mappát létrehozni |
| Megtelt lemez vagy kimerült tárhelykvóta | Hibák a fájlok másolásáról vagy írásáról |

A legtöbbet csak a tárhelyszolgáltató tudja megvizsgálni, ezért nyiss náluk jegyet, és adj konkrét kérést. Például:

> A bővítmény ZIP-jének feltöltése a WordPress adminon át (`/wp-admin/update.php?action=upload-plugin`) nem sikerül az oldalamon. Kérlek, nézd meg a mod_security/WAF naplót és a PHP hibanaplót a következő időpontra: [dátum és idő, időzónával], és írd meg, melyik szabály vagy korlát blokkolta. Erősítsd meg az oldalra érvényes `upload_max_filesize`, `post_max_size`, `max_execution_time` és `memory_limit` értékeket is, és emeld meg őket, ha a WordPress ajánlása alatt vannak.

A bővítmény ZIP-fájlja nem szokatlanul nagy. Ha egy kis ZIP sem tölthető fel, sokkal valószínűbb a tűzfalszabály vagy az időtúllépés, mint a méretkorlát. Ezért kérd, hogy a tárhely kifejezetten a tűzfalnaplókat is nézze meg, ne csak a PHP-korlátokat.

## 4. lépés: Ha még mindig nem megy

Fordulj a támogatáshoz, és add meg ezeket:

- melyik bővítményt és melyik verzióját próbálod telepíteni,
- a tárhelyszolgáltatód nevét, és hogy az oldal CDN vagy biztonsági szolgáltatás mögött van-e,
- a pontos hibaüzenetet vagy a látottak képernyőképét,
- hogy a wordpress.org-os bővítmény ZIP-je ugyanígy elbukik-e,
- a WordPress, a WooCommerce és a PHP verzióját (**Eszközök → Webhely állapota → Infó**).