It’s been more than 15 years since one of the most powerful platforms for developing websites burst onto the scene. Yes.! you guessed it right, we’re talking about WordPress.
Despite being a popular platform and despite having a strong developer community, WordPress developers still get stuck with some very fundamental errors.
Over the years, we’ve seen many WordPress Development Companies who struggle with the most basic WordPress errors. Whenever any error occurs, they seem like fish out of the water.
So, let’s get things moving and analyze the common errors.
Table of Contents
1. Internal server error
This is perhaps the most mind-boggling error especially for a person who has just started to learn the traits of WordPress. The error is also known as “500 Internal Server Error.”
This type of error occurs when there is something wrong, but the server is unable to identify the real reason for that. The most frustrating part about this error is that you’ve to identify the root cause yourself as the server have no idea about it.
Ways to fix internal server error
Option 1: Increasing the PHP memory limit
One of the main reasons for the internal server error is the lack of memory and that’s why you should try to increase that by following the steps written below.
- Log In to the WordPress Admin
- Create a blank text file called php.ini
- Paste this code in there: memory=64MB (or any limit you desire)
- Save the file
- Upload it into your /wp-admin/ folder using FTP
Option 2: Deactivating all the plugins
If the above two options are not working for you, then one of the plugins could be causing the internal server error for the website.
You should deactivate all the plugins which are installed on your site.
If the error is solved by deactivating all the plugins, then you’re sure that one of the plugins was the culprit of the problem.
Now, the challenge is to find which plugin out of all was causing this issue. For that, you need to reactivate one plugin at a time till you find your answer.
2. Database connection error
This type of error usually occurs when a user has modified the database credentials (database host, database username, and database password) incorrectly.
Sometimes it could be due to the unresponsiveness of the database or there is a chance that your database is corrupted.
Ways to fix database connection error
Option 1: Check if the same problem occurs for / wp-admin / as well
The first thing you should do when there is a database connection error is to check whether the same error occurs for both the front-end and back-end.
If you’re getting the same problem on both sides, then you should look for other options, but if you’re getting a different error on both sides, then one or more database tables have become temporarily unavailable and you need to repair the database.
In order to repair the database, you need to add the following line in the wp-config.php file:
define(‘WP_ALLOW_REPAIR’, true);
Once you do that, you will see a message as shown in the screenshot below:
This means you can repair the database now.!
Option 2: Check the wp-config.php file
wp-config.php is the most important file in your entire WordPress as it is the location where you define details for WordPress to be connected with your database.
Now, if you’ve changed the root password or database user password, then you need to change this file as well. For that purpose, you can use the following syntax:
define(‘DB_NAME’, ‘database-name’);
define(‘DB_USER’, ‘database-username’);
define(‘DB_PASSWORD’, ‘database-password’);
define(‘DB_HOST’, ‘localhost’);
If everything in the file is correct, then you should once check for typos and if that’s the case, then it is fair to say that there is something wrong on the server side.
Option 3: Check your web host (MySQL Server)
You should always check with your service provider whether your MySQL Server is responsive or not. If you want to test the MySQL Server, then there are plenty of ways for that.
You can test other sites on the same server to check if the server is working well or not. If you’re getting the same error with other sites, then there is something wrong with your MySQL server.
If you don’t have any other site, then go to cPanel and try to access phpMyAdmin to connect the database. If you can connect the database, then the next step is to check whether the user has sufficient permission or not.
To test this, you need to create a new file testconnection.php and use the following code:
<?php
$link = mysql_connect(‘localhost’, ‘root’, ‘password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);
?>
After implementing this piece of code, if the connection is established then you can say that the user has sufficient permission and there is something wrong with MySQL Server and if you can’t connect with the database, then the user may not have sufficient permission.
3. White screen of death
“White Screen Of Death” is a situation when you get a plain white screen as an error with no message displayed on it. It is the most mysterious WordPress error till date, as the developer will have no clue of where to look and how to solve it.
Ways to fix the White Screen of death error:-
Ways to fix the White Screen of death error:-Option 1: Increasing the PHP memory limit
One of the root causes of White Screen Of Death is your memory being exhausted and therefore, you need to increase the PHP memory limit to resolve this issue.
Following are the steps to increase the memory:
- Log In to the WordPress Admin
- Create a blank text file called php.ini
- Paste this code in there: memory=64MB (or any limit you desire)
- Save the file
- Upload it into your /wp-admin/ folder using FTP
Option 2: Disabling all the plugins
If increasing the memory didn’t solve the issue for you, then you should consider disabling all the plugins on your website.
One of your plugins may be causing this type of error and therefore, by disabling all the plugins, you can solve this error.
Now, in order to find the plugin that causes the error, you need to re-activate all the plugins one-by-one until you find the culprit.
Option 3: Replace your theme with the default theme
If the above two options didn’t provide you with the solution you were after, then it’s time to replace your theme with the default theme (twenty ten themes).
The best way of doing this is by backing up your theme folder and then deleting it. This will automatically roll back your theme to the default one.
4. 404 – Page Not Found error:-
This type of error occurs when the user wants to visit a particular blog post on its website but could not able to find it.
Ways to fix 404 – Page Not Found error
Option 1: Reconfigure permalink settings
One of the main reasons for 404 – Page Not Found error is the change in the permalink settings. So, to solve that issue, you need to reconfigure the permalink settings.
For that, simply go to Settings » Permalinks, and click on the Save Changes button as shown in the screenshot below.
This will resolve the issue in most of the cases as your permalinks settings will be updated. But, if this doesn’t solve your problem, then you need to update your .htaccess file manually.
Option 2: Update .htaccess file
In order to update the .htaccess file, you need to log in to the server using FTP and find the .htaccess file which is located in the same folders like/wp-content/ and /wp-includes/.
Now, add the following code to your .htaccess file which will solve the issue:
# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ – [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ – [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
5. Locked out of WordPress admin
Sometimes you may find that you have locked yourself out of the WordPress Admin and you’re not able to login back to the admin dashboard. This kind of scenario happens when you have forgotten your password and also don’t have access to password recovery email.
Ways to fix locked out of WordPress admin error
Ways to fix locked out of WordPress admin errorOption 1: Reset your password from phpMyAdmin
One of the reasons for being locked out of the WordPress Admin is due to an incorrect passwords. So, for that, you need to reset your password from phpMyAdmin.
Firstly, log in to the cPanel dashboard of your WordPress Hosting account and click on the phpMyAdmin icon as shown in the screenshot below.
Once you click on phpMyAdmin, it will open the app where you need to select the WordPress Database. Once you select the database, you will get the list of all the tables where you need to find out ‘{table-prefix}_users’ table and click on the browse link as shown in the screenshot.
After clicking on the browse button, you will see the numbers of rows in the WordPress users table. Now, go ahead and click on the edit button next to the username for which you want to change the password.
Once you click on the ‘edit’ link, you will be shown a form with user information fields. Now, delete the value from the user_pass field and replace it with a new password.
Don’t forget to choose MD5 from the function as it will secure your password.
This means you’ve successfully changed your WordPress Admin password.
6. Image upload issue
If you’re using the WordPress platform for a long time, then you may have encountered this kind of error many times. Sometimes you would notice that all the images from the site are gone and the site is showing broken image placeholders.
Now, when a user tries to upload an image to the post using the media uploader, he/she will encounter an error.
Ways to fix image upload issue
Option 1: Changing the file permissions
One of the major reasons behind the image upload issue is the change in the file permission. Sometimes, when your hosting provider runs an update, the file permissions could change and that can cause this type of issue.
Therefore, you need to change the file permissions back to normal to solve this issue.
For that purpose, connect to your site using FTP client and go to / wp-content / directory where you will see / uploads /folder. Now, right-click on uploads and select file permissions.
Once you click on ‘file permissions’ a new dialog box will appear as shown in the screenshot below.
Now, to change the file permission first you need to apply changes to all the directories and sub-directories. For that, enter 744 in the ‘numeric value’ box, and then check the box next to Recurse into subdirectories.
Lastly, you need to click on the ‘Apply to directories only’ radio button and click on the ‘OK” button which will reflect the changes.
In the next step, you should change the permission for files, and for that, you need to enter 644 in the ‘numeric value’ box, and then check the box next to Recurse into subdirectories.
Lastly, you need to click on the ‘Apply to files only’ radio button and click on the ‘OK” button which will reflect the changes.
Now, the issue will be solved and you will be able to upload all the images.
Final thoughts…
WordPress CMS is ruling the roost in the IT world and most of you would be using this wonderful platform for your business website.
In this article, we have analyzed the most common WordPress errors which are encountered on a daily basis. We have also provided a step-by-step guide on how to fix them.
If you’ve your own viewpoint on this article, then do mention them in the comment section. We like to hear the views of our lovely audience. Thank you.!
