Valkoinen ruutu on WordPressin tunnetuin vikatila. Se ei ole oma virheensä vaan seuraus. PHP keskeytyi kesken sivun muodostamisen, ja koska virheiden näyttäminen on tuotannossa kytketty pois, selain saa tyhjän vastauksen. Korjaus alkaa siitä että virhe saadaan näkyviin.
Hallintapaneelissa on tiedostoselain ja lokinäkymä. Etsi error_log-tiedosto sivuston juuresta tai paneelin lokiosiosta. Viimeinen rivi kertoo tavallisesti suoraan tiedoston ja rivin joka kaatui, ja tiedoston polku paljastaa onko syynä lisäosa vai teema. Tämä yksi askel korvaa suurimman osan arvailusta.
Voit kytkeä virheiden kirjaamisen päälle lisäämällä wp-config.php-tiedostoon rivit define('WP_DEBUG', true); ja define('WP_DEBUG_LOG', true);. Virheet kirjautuvat tiedostoon wp-content/debug.log. Muista poistaa nämä rivit heti kun vika on löytynyt, koska ne eivät kuulu tuotantosivustolle.
| Syy | Tunnusmerkki | Korjaus |
|---|---|---|
| Lisäosa | Ruutu ilmestyi heti päivityksen tai asennuksen jälkeen | Nimeä lisäosan kansio uudelleen FTP:llä, jolloin WordPress poistaa sen käytöstä |
| Teema | Etusivu on valkoinen mutta /wp-admin toimii | Nimeä teeman kansio uudelleen, jolloin WordPress palaa oletusteemaan |
| Muistiraja | Ruutu tulee vain raskailla sivuilla tai mediakirjastossa | Nosta PHP:n muistirajaa hallintapaneelista |
| PHP-versio | Ruutu ilmestyi ilman että sivustoa muutettiin | Palauta edellinen PHP-versio, päivitä sitten vanhentuneet lisäosat |
WordPress etsii lisäosat ja teemat kansiopolun perusteella. Kun kansio ei ole siellä missä sen pitäisi olla, WordPress kytkee sen pois käytöstä eikä yritä ajaa sitä. Tämä on turvallisempaa kuin poistaminen, koska asetukset säilyvät tietokannassa ja voit palauttaa kansion alkuperäiselle nimelleen. Tarvitset FTP- tai SFTP-yhteyden, ja ohje siihen on omassa oppaassaan.
Kun webhotelli päivittää PHP-version, vanhat lisäosat voivat lakata toimimasta saman tien ilman että kukaan on koskenut sivustoon. Jos valkoinen ruutu ilmestyi itsestään, tarkista PHP-versio ensimmäisenä. Ohjeet löytyvät oppaasta PHP-version vaihtaminen. Palauta edellinen versio jotta sivusto nousee pystyyn, päivitä sen jälkeen lisäosat ja nosta versio uudelleen.
Ota varmuuskopio. Valkoisen ruudun korjaaminen vaatii tiedostojen siirtelyä, ja ilman varmuuskopiota yksi väärä liike muuttaa korjattavan vian menetetyksi sivustoksi. Ohje on sivuston varmuuskopiointi ja palauttaminen.
Valkoinen ruutu on tavallisesti tunnin työ kun virheloki on luettu. Korjaamme sen tuntityönä varmuuskopioineen ja raportteineen.
Katso miten korjaamme rikkoutuneen sivuston »
Sivustolla ilmeni kriittinen virhe, näin selvität mistä se johtuu »
