De informatie in dit E-book is met veel zorg en liefde samengesteld door Bennie Mellies.

Transcriptie

1

2 Disclaimer De informatie in dit E-book is met veel zorg en liefde samengesteld door Bennie Mellies. Wil je graag iemand anders wijzen op dit informatieve en gratis E-book, stuur ze dan door naar de officiële blog post 13 Meest voorkomende WordPress foutmeldingen en oplossingen. Alvast bedankt! Artikelen, tips en advies Vind je het leuk om maandelijks informatieve artikelen te ontvangen over; WordPress Marketing, SEO Graphics Webdesign Ondernemerschap Growth-hacking en meer! Registreer je dan voor mijn artikelen via deze link Meer informatie over Bennie Mellies 2

3 Heb jij dat ook wel eens? Je wilt jouw WordPress installatie, WordPress thema of WordPress plugins updaten/upgraden en krijgt een wit scherm of een foutmelding die je niet kan verklaren? Of erger nog, je kunt helemaal niet meer inloggen! Voor elk probleem en elke foutmelding is een verklaring en/of oplossing. Op dit moment zijn er wereldwijd ruim 75 miljoen blogs en websites die WordPress gebruiken! Dat is ongeveer 1 site per persoon in Turkije. J Dit kan de versie WordPress.com (50%) of de zelf gehoste versie WordPress.org (+/- 21%) betreffen. Van alle 100 domeinnamen die geregistreerd worden, zullen ongeveer 20 van deze domeinnamen draaien op het open source platform van WordPress. Wil je graag meer weten over de basis van WordPress, download dan mijn gratis E- book 15 Redenen om voor WordPress te kiezen. Bijna 10 artikelen per seconde! Ja, je leest het goed. Elke seconde worden er +/- 10 nieuwe WordPress.com artikelen geplaatst. Op deze statistieken pagina van WordPress wordt een gave interactieve map weergegeven, die aangeeft op welke locatie een blogger een artikel plaatst (realtime!) en nog wat andere gave statistieken met grafieken. Klik hier om de WordPress Activiteit te bekijken 3

4 Voordat ik de foutmeldingen induik, wil ik een aantal algemene zaken delen die ik altijd eerst zou volgen; Gebruik geen plugins die niet opgenomen zijn in de WordPress plugin directory. Als je dit wel doet, weet dan zeker dat ze legaal en goedgekeurd zijn. Daarnaast afgestemd op de meest reguliere WordPress versie. Als je net begint met WordPress, zijn er meer dan voldoende plugins te vinden in "directory" van WordPress die je voorzien in alle mogelijke functionaliteiten (free en premium); Experimenteer nooit live op je website. Het is verstandiger om dit te doen op een testserver of via een lokale installatie; Ga voor de meest populaire plugins en de plugins met veel downloads (dit zegt ook iets over de betrouwbaarheid); Vergeet niet regelmatig een back-up te maken! Er bestaan op dit moment nog niet zo veel uitgebreide artikelen of E-books over WordPress foutmeldingen in het Nederlands. En gezien er dagelijks erg veel vragen gesteld worden op diverse forums, leek het me een goed idee om deze 13 meest voorkomende WordPress foutmeldingen (errors) met je te delen. De oplossingen worden per hoofdstuk toegelicht, stap voor stap. 4

5 Ok, laten we er direct induiken. 5

6 Binnen de WordPress gemeenschap wel bekent als de White screen of Death (WSOD). Je krijgt een leeg scherm te zien zonder informatie. Een van de meest voorkomende foutmeldingen die door meerdere dingen veroorzaakt kan worden. Dit probleem treed vaak op als je een nieuw WordPress thema hebt geïnstalleerd of een WordPress upgrade hebt uitgevoerd. Je kent dit vast wel van Windows en Microsoft (je computer/laptop). Hier kennen we de zogenaamde Blue Screen of Death (BSOD). Wat is er aan de hand? Een plugin is niet compatibel met de huidige versie van WordPress; Een plugin conflicteert met een andere plugin; De plugin conflicteert met het actieve WordPress thema; Je huidige WordPress thema is niet compatibel met de huidige WordPress versie Oplossingen voor dit probleem: 1. Het resetten van de plugin directory Om de WordPress plugin directory te resetten, ben je toegang nodig tot de WordPress installatie folder. Je kunt hier FTP, Cpanel of SSH voor gebruiken. In onderstaand voorbeeld is Filezilla FTP gebruikt: 6

7 Hernoem de plugin directory naar plugin-temp ; Maak een nieuwe directory genaamd plugins en zet de rechten op 644 (zie paragraaf 2 voor meer informatie over bestandsrechten); Als je een VPS of dedicated server gebruikt is het van belang dat je de webserver herstart Alle plugins die geïnstalleerd waren zullen nu gedeactiveerd zijn en verwijderd. Je kunt nu proberen in te loggen in je WordPress dashboard. Als dit lukt probeer dan de plugins één voor één opnieuw te activeren. Beginnend met de meest voorkomende plugins (zoals Akismet, JetPack, WordPress SEO etc). 2. Hernoem je huidige geactiveerde WordPress Thema Als je de benaming aanpast van je huidige WordPress thema (die actief is), zal WordPress deze niet meer terug kunnen vinden. WordPress zal zoeken naar de default thema s; Twenty Ten, Twenty Eleven, Twelve, Thirteen etc. 7

8 Als deze gevonden worden, zal WordPress overschakelen naar deze default thema s (afhankelijk van de WordPress versie die je gebruikt) en zal je weer in staat zijn om in te loggen. Vanuit de Themes hoofdmap kom je uiteindelijk in de theme specifieke map; Bovenstaande map hernoem je bijvoorbeeld naar OptimizePressTheme-Temp. 8

9 Je kunt de bestandsrechten wijzigen door met de rechter muisknop te klikken op de betreffende map en kies voor bestandsrechten, helemaal onderaan. Je krijgt hetzelfde scherm te zien als in deze schermafbeelding; Bij de numerieke waarde stel je de juiste bestandsrechten in. 9

10 Zoals je ziet zijn de bestandsrechten verdeeld in een drietal categorieën; Eigenaarsrechten Groepsrechten Openbare rechten Elke categorie heeft weer een drietal rechten; Lezen; Schrijven; Uitvoeren Met speciale nummercombinaties kun je exact aangeven welke rechten actief zijn en welke niet. Voor sommige mappen is het noodzakelijk dat er gelezen, geschreven en uitgevoerd kan worden. Je zult dan ook veel de volgende cijfercombinaties tegenkomen; 777 (alles lezen, schreven en uitvoeren) of 644 zoals in bovenstaand voorbeeld. Pas wel op dat je niet zomaar mappen gaat wijzigen, raadpleeg daarvoor altijd eerst de informatie op Wordpress.org. Voor meer informatie zie de WordPress codex. 10

11 Er kunnen diverse oorzaken zijn voor een Internal Server Error (500). 1. De meest voorkomende is een corrupt.htacces bestand in de root/basis directory van jouw WordPress installatie. In 90% van de gevallen kun je het probleem oplossen door het.htacces bestand te verwijderen en een nieuwe te maken. Om het bestand te kunnen verwijderen is het noodzakelijk om in te loggen middels een FTP server of via je control panel (zie eerder genoemd). Zorg ervoor dat je het huidige.htacces bestand hernoemd naar bijvoorbeeld;.htacces-corrupt. 2. Login in WordPress en ga naar de Permalinks instellingen. Selecteer hier de voorkeur voor je permalinks en sla deze op. Je site zou nu weer goed moeten werken. 11

12 Andere oorzaken voor Internal Server Error 500. Soms is de oorzaak en/of aan te dragen oplossing iets lastiger te traceren. De volgende oplossingen kunnen hier bij helpen; 1. Hernoem het huidige WP Thema (zie vorig hoofdstuk); 2. Reset de plugin directory (zie vorig hoofdstuk); 3. Vervang de wp-includes en wp-admin folders door de meest recente WordPress versie. Deze kun je te allen tijde gratis downloaden via wordpress.org Schermafbeelding van een rootdirectory via FTP. 12

13 Misschien wel één van de meest voorkomende foutmeldingen of errors in WordPress waar je vooral in het begin mee te maken zal krijgen. Er kunnen diverse oorzaken zijn voor dit probleem; Oorzaken 1. Meest voorkomende oorzaak is dat de Mysql database toegang details niet goed zijn ingesteld (config instellingen). Hierdoor kan WordPress geen verbinding maken met de database en niet goed functioneren; 2. Er zijn problemen met je Webhosting 3. De Mysql server ligt eruit; 4. De Mysql server heeft niet de juiste rechten om de database te mogen aanpassen. Oplossingen 1. Maak verbinding via FTP met je website en zoek naar het bestand WP- Config.php. Deze is vaak terug te vinden in je hoofd/root directory. 13

14 Controleer het wp-config.php bestand op de volgende zaken; Databasenaam; Database gebruikersnaam; Database wachtwoord; Database host Je kunt je login details nakijken bij je hosting provider. Afhankelijk welke hostingprovider je hebt gekozen. Maar vaak is er een Cpanel of een Directadmin (installatron, plesk, fantastico) omgeving aanwezig. In onderstaand voorbeeld ben ik uitgegaan van Installatron, gezien deze gebruikt wordt bij mijn eigen hostingprovider. Je kunt bovenstaande wijzigen door in te loggen op je hostingpakket. Vervolgens kies je voor Installatron Applications en als het goed is zie je daar jouw actieve WordPress installatie (of meerdere). 14

15 Klik op instellingen (view/edit details) en je krijgt bovenstaand scherm te zien. Hieruit kun je opmaken welke instellingen er in jouw Wp-config.php bestand zouden moeten staan. Leg ze naast elkaar en vergelijk de instellingen één voor één. Andere oplossingen; 2. De beste stap is contact opnemen met je hostingprovider. De meeste hostingproviders bieden goede support services, bieden chat services aan en een uitgebreide FAQ sectie. In sommige gevallen is er een uitgebreide storingspagina aanwezig (noc). De volgende zaken kunnen aan de hand zijn; 1. Je database heeft zijn limiet bereikt in bandbreedte (quota) en is offline; 2. De webserver is down of er zijn andere werkzaamheden (uplinks etc). 3. Controleer je wachtwoorden in het WP-config bestand. Zijn deze ingegeven met dubbele quotes? voorbeeld. En niet met enkele quotes? voorbeeld 4. Probeer de Mysql server te herstarten, eventueel in overleg met je hostingprovider 5. Als jouw Mysql server niet de juiste rechten heeft ingesteld, kun je deze aanpassen via het control panel van je hostingprovider. Als je inlogt zie je een optie voor Mysql database. 15

16 Kies voor Mysql Databases Probeer vervolgens de Mysql database te repareren of doe eerst een check. Je ziet bovenin een link staan om rechtstreeks in te loggen op je phpmyadmin omgeving. Daar kun je eventueel je Mysql server herstarten. Doe dit eventueel in overleg met je hostingprovider. 16

17 De officiële melding in het Engels is; Failed automatic WordPress update of Fatal Error undefined function is_network_admin() De laatstgenoemde foutmelding krijg je als de update is uitgevoerd, mislukt en je opnieuw probeert in te loggen. Zoals je misschien weet komen er regelmatige nieuwe updates voor WordPress. Sommige zijn feature upgrades. Wat eigenlijk inhoud dat er geen haast bij is om je huidige WordPress installatie te updaten. Veiligheidsupdates moet je altijd installeren en deze worden wel aanbevolen door WordPress. De meest recente veiligheidsupdate is momenteel WordPress (heb je deze nog niet geïnstalleerd, dan raad ik je dit zeker aan om zo snel mogelijk te doen) Er zijn diverse weergaven of outputs voor een mislukte update; White screen of Death (zie #1) Waarschuwing dat de update is mislukt Een PHP error bericht Er kunnen verschillende oorzaken zijn; 1. De verbinding naar je WordPress website; 2. Een probleem met je internet verbinding; 3. Niet de juiste bestandsrechten; 4. Je WordPress website is gehackt. 17

18 Om dit succesvol op te lossen zouden we de stappen kunnen volgen voor een handmatige update/upgrade en hiermee het probleem verhelpen. 1. Download de meest recente versie van WordPress (gratis downloaden via wordpress.org); 2. Maak een backup van je huidige WordPress installatie 3. Deactiveer alle plugins (indien mogelijk); 4. Login op je WordPress omgeving met FTP (zie schermafbeeldingen hierboven) en overschrijf alle bestanden in de root directory; 5. Hernoem de wp-includes en wp-admin folders naar wp-includes-bak en wp-admin-bak. 6. Upload de folders wp-includes en wp-admin vanuit het gedownloade ZIP bestand naar de root directory op je webserver; 7. Verwijder NOOIT de wp-content map op je webserver, anders verlies je hierdoor afbeeldingen en andere media. 8. Maak eventueel nog je cachegeheugen leeg. Voor meer informatie over alle stappen in de handmatige update/upgrade, zie de WordPress codex. Als je denkt dat je site gehackt is, gebruik dan de volgende hulpmiddelen; Sucuri Site Check My site was hacked FAQ op WP 18

19 Deze foutmelding treedt op als jouw website meer probeert te doen dan de server op dat moment aankan. Ook wel een overladen webserver genoemd. Als dit erg vaak gebeurt, zou ik zeker overwegen om een andere hostingprovider te nemen. Of overweeg om een groter hostingpakket te nemen, dedicated hosting etc. Gebruik hiervoor deze bronnen; Domeinnamen, hosting en betrouwbare hosting; Overzicht van alle webhosting bedrijven op ZEEF; Meer over de werking van een website, stap voor stap Oplossingen Verhoog het geheugen dat aan PHP wordt toegewezen door WordPress; Om het geheugen dat toegewezen is aan PHP aan te passen, kun je de volgende stappen uitvoeren; Oplossing 1: Bewerk het Php.ini bestand. Pas de memory-limit aan door de volgende lijn met code aan te passen; memory_limit = 64M ; Maximum amount of memory a script may consume (64MB) Oplossing 2: Bewerk je.htacces bestand en voeg de volgende code toe; php_value memory_limit 64M Oplossing 3: Bewerk je wp-config.php bestand en voeg de volgende code toe; Increasing memory allocated to PHP define('wp_memory_limit', '64M'); 19

20 Het is wel afhankelijk van jouw hostingprovider. De limiet kan gezet worden op; 32MB, 64MB, 128MB of 256MB. Oplossing 4: Open Notepad (of Notepad+) en voeg de volgende regel toe in een leeg bestand: memory_limit = 64M ; Sla dit bestand op als Php.ini en upload dit bestand naar de wp-admin directory op je webserver. Andere oplossingen voor dit probleem; 1. Reset de plugin directory (stappen hierboven genoemd); 2. Hernoem je actieve WordPress thema en schakel over naar een default thema zoals Twenty Fourteen. Door bovenstaande stappen uit te voeren kun je uitsluiten dat het probleem zich bevind in je plugins (1) of themes (2). Als je niet weet hoe bovenstaande uitgevoerd moet worden, neem dan contact op met je hostingprovider. Zij kunnen jou hiermee helpen. 20

21 Als WordPress wordt geüpdatet, zal er automatisch een zogenaamd.maintenance bestand worden geïnstalleerd. Het kan soms voorkomen dat na de update/upgrade dit tijdelijke bestand niet goed verwijderd is. Om deze foutmelding te verwijderen voer je de volgende stappen uit; Login op je WordPress omgeving met FTP; Verwijder het.maintenance bestand, die in de root van je server staat. Verwijder het bestand door aan te klikken en te kiezen voor verwijderen. Als je nu opnieuw probeert in te loggen (na het verwijderen) zal je zien dat het probleem opgelost is. Ook kun je eventueel proberen om de update opnieuw uit te voeren. 21

22 Het kan wel eens voorkomen dat je je admin gebruikersnaam niet meer weet of kwijt bent. Normaal gesproken kun je dan kiezen voor de optie wachtwoord vergeten en krijg je keurig een nieuw wachtwoord toegezonden. Maar wat als dit niet lukt of als je geen nieuw wachtwoord krijgt toegezonden? Oplossing 1 - phpmyadmin Inloggen op phpmyadmin; Selecteer phpmyadmin onder Databases ; Selecteer de juiste WordPress database Ga naar wp_users en klik op verkennen Vervolgens krijg je onderstaand scherm te zien; Hier kies je voor wijzigen en je krijgt onderstaand scherm te zien; 22

23 Zoals je ziet kun je bij user_pass opnieuw je wachtwoord instellen. En denk erom dat dit hoofdletter gevoelig is! Selecteer bij functie eventueel nog MD5 Kies voor start Oplossing 2 Met FTP Login op je FTP account of webserver; Ga naar de map wp-content/themes/(jouw actieve WP Theme)/ en zoek hier naar het functions.php bestand. Open dit bestand en voeg onderstaande code toe vlak na de eerste <?php tag; wp_set_password('yournewpassword',1); Upload dit aangepaste Functions.php bestand naar je webserver omgeving met FTP; Als je weer succesvol in kunt loggen, vergeet dan niet bovenstaande code te verwijderen! 23

24 Je WordPress dashboard wordt op bovenstaande manier weergegeven. Het lijkt erop dat de juiste style bestanden ontbreken. De stijl van je website maar ook je WordPress installatie wordt vastgelegd in zogenaamde CSS (Cascade Style Sheets) bestanden. Omdat de CSS bestanden niet goed zijn ingeladen, worden de links niet op de juiste manier weergegeven en lijkt het erg rommelig en statisch. Oplossing 1 Proxy instellingen en je Firewall Controleer of jij achter een proxy verbinding of firewall zit. Deze kunnen er namelijk voor zorgen dat jouw CSS bestanden geblokkeerd worden, waardoor ze niet goed ingeladen worden. Probeer om je proxy, firewall en cookies op te schonen en/of aan te passen en kies daarna voor CTRL+F5 om de pagina opnieuw te laden. Oplossing 2 Update je WordPress plugins Er zijn vandaag de dag zoveel verschillende plugins te downloaden voor WordPress. Sommige plugins zorgen ervoor dat er modificaties worden uitgevoerd op je admin omgeving. Denk hierbij aan plugins als admin drop down menu en meer van dit soort dingen. Probeer deze betreffende plugins tijdelijk te deactiveren en kijk of het nu wel werkt. 24

25 Als je deze foutmelding krijgt, betekent dit dat je ergens spaties in jouw openingtags of sluit-tags van je WordPress code hebt staan. De foutmelding kan voorkomen als je WordPress zojuist hebt geupdate of komt voor bij een nieuwe WordPress installatie. Oplossing: Verwijder alle spaties, nieuwe lijnen en andere rotzooi in wp-config.php Ga met een FTP server naar je webserver en download het wp-config.php bestand; Open het bestand met notepad (notepad+); Verwijder alle spaties en lege regels voor <?php Zorg ervoor dat de eerste karakters in het bestand <?php zijn, zonder spaties. 25

26 Verwijder ook alle spaties en lege regels na?> Zorg ervoor dat de laatste karakters in het bestand?> zijn, zonder spaties. Deze foutmelding kan ook voorkomen bij andere bestanden. Lees altijd goed de foutmelding, gezien de foutmelding aangeeft in welk specifiek bestand het fout gaat. 26

27 Deze foutmelding geeft aan dat de WordPress installatie niet voldoende geheugen heeft om te doen wat jij wilt. De foutmelding kan voorkomen als je afbeeldingen probeert toe te voegen met de instellingen medium size. Om dit probleem op te lossen, probeer het toegewezen geheugen voor PHP aan te passen. Pas het PHP geheugen aan naar 32, 64, 128 of 256 MB; Bewerk het PHP.ini bestand; Bewerk het.htaccess bestand; Bewerk het wp-config bestand; Maak een nieuw PHP.ini bestand. Oplossingen Verhoog het geheugen dat aan PHP wordt toegewezen door WordPress; Om het geheugen dat toegewezen is aan PHP aan te passen, kun je de volgende stappen uitvoeren; Oplossing 1: Bewerk het Php.ini bestand. Pas de memory-limit aan door de volgende lijn met code aan te passen; memory_limit = 64M ; Maximum amount of memory a script may consume (64MB) Oplossing 2: Bewerk je.htacces bestand en voeg de volgende code toe; php_value memory_limit 64M Oplossing 3: Bewerk je wp-config.php bestand en voeg de volgende code toe; 27

28 Increasing memory allocated to PHP define('wp_memory_limit', '64M'); Het is wel afhankelijk van jouw hostingprovider. De limiet kan gezet worden op; 32MB, 64MB, 128MB of 256MB. Oplossing 4: Open Notepad (of Notepad+) en voeg de volgende regel toe in een leeg bestand: memory_limit = 64M ; Sla dit bestand op als Php.ini en upload dit bestand naar de wp-admin directory op je webserver. Andere oplossingen voor dit probleem; 1. Reset de plugin directory (stappen hierboven genoemd); 2. Hernoem je actieve WordPress thema en schakel over naar een default thema zoals Twenty Fourteen. Door bovenstaande stappen uit te voeren kun je uitsluiten dat het probleem zich bevind in je plugins (1) of themes (2). Als je niet weet hoe bovenstaande uitgevoerd moet worden, neem dan contact op met je hostingprovider. 28

29 Je krijgt een foutmelding dat je niet de juiste rechten hebt om de pagina te bekijken. Dit kan gebeuren nadat je de inloggegevens hebt ingevoerd. Je krijgt dan onderstaand scherm te zien; Oplossing: Schakel Index.php in Wordt jou blog gehost op een Windows Server? Dan kan deze foutmelding te maken hebben met de Directory Indexes ; Login op je Control Panel; Ga naar Web Options ; Ga naar Directory Indexes ; Voeg index.php toe aan de Directory indexes. 29

30 12. Je kunt niet inloggen in je WordPress admin omgeving. En je ontvangt een Error 404 pagina. Oplossing 1 Update de URL in de database Als je kunt inloggen in phpmyadmin onder Databases; Selecteer de juiste WordPress database (bijvoorbeeld: Gebruikersnaam_WP1); Ga vervolgens naar wp_options en klik op verkennen ; Zoek vervolgens naar het veld siteurl in de kolom option_name ; Kies voor wijzigen ; Pas de URL aan onder option_value ; Als je klaar bent, kies je onderin voor de button start. 30

31 Oplossing 2 Pas de rechten aan van de folders Ga naar de directory /wp-admin via een FTP server; Klik met je rechter muisknop op de wp-admin folder en kies voor bestandsrechten Zet de numerieke waarde op 755 en zet eventueel de instelling aan toepassen op alle submappen ; Kies voor OK; Herhaal dezelfde stappen voor de mappen; /wp-content en /wp-includes. Open je webbrowser en ga naar je WordPress website. Druk op CTRL+F5 en probeer daarna opnieuw in te loggen. 31

32 De meeste foutmeldingen binnen WordPress zijn vrij specifiek, waardoor het makkelijker is om te bepalen of uit te zoeken waar of waarin het probleem zich precies bevind. De WordPress foutmelding are you sure you wanna do this is minder duidelijk. Waarom is deze foutmelding zo onduidelijk? Simpel gezegd, er zijn teveel diverse oorzaken voor deze foutmelding. Deze foutmelding wordt vaak veroorzaakt door een thema of plugin die niet goed omgaat met bepaalde verificaties binnen WordPress. Het is daarom ook van belang om te onderzoeken welke plugin of welk thema de boosdoener is. Deactiveer alle plugins; Activeer ze één voor één, beginnend met de meest gebruikte (meest populaire) Er kan ook een probleem zijn met je huidige WordPress thema. Ga naar uiterlijk in je WordPress dashboard; Ga naar Thema s Zie je hier een notificatie staan die het volgende weergeeft: The active Theme is broken. Reverting to the default theme? In dit geval zal WordPress een beroep doen op het default thema Twenty Fourteen. Kijk of het probleem nu opgelost is. Als de foutmelding niet meer voorkomt, zat het probleem dus in je WordPress thema. 32

33 Neem eventueel contact op met de ontwikkelaar van het WordPress thema. Voor meer informatie over WordPress thema s kun je terecht op onderstaande pagina s; De Beste WordPress Thema s en aanbieders Alle WordPress Thema s op ZEEF Alle WordPress Thema s op BennieMellies Er zijn diverse bronnen gebruikt voor de totstandkoming van dit artikel/e-book. Eventueel kun je hier nog verdere aanvullingen vinden voor andere problemen op het gebied van Thema s, plugins en styling En mocht je ergens niet uitkomen of durf je het niet aan om zelf de problemen op te lossen, dan kan je altijd een vraag stellen op het algemene WordPress forum. Ik hoop dat je dit artikel kan gebruiken als een goede referentie voor WordPress foutmeldingen (wp errors). Tot snel, Bennie Meer toffe artikelen kun je hier vinden. 33