Telepítési problémák

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ó:

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ó).