Explain, Debate, Discuss, Vote, All in One Place
December 15, 2015
Mobile Platforms - Mobile Tech Trends Of 2016 Fit Or Just A Fad
Mobile Tech Trends Of 2016: Fit Or Just A Fad
December 20, 2015

5 Common WordPress Installation Errors Users Need to Know About

5 Common WordPress Installation Errors Users Need to Know About

It’s been twelve years since WordPress was launched, and still it is one of the most preferred website development platforms for many. The ever-growing popularity of WordPress can be attributed to the tons of customization opportunities it provides to site owners to come up with a fully tailored website design.

So, if you’ve decided on using the WordPress platform for your web development project, the chances are that you might encounter several issues during WordPress installation. Through this post, I would like to help you learn about some common installation problems in WordPress and how you can fix them.

1. WordPress Admin is Showing a Blank Page

When updating your WordPress website to a new version update, your installation might stop, and you’ll see a blank page. Also, you might not be able to access your site’s admin dashboard screen:

How to fix this problem?

The best way to tackle the above mentioned problem is to download your WordPress install manually. For this part, download a new WordPress copy with .zip extension to your system. Next, unzip the downloaded copy and use it for copying all your files and folders (leaving your configuration file and the “/wp-content/” directory). And then, delete the older versions of wp-admin and wp-includes folders and files before uploading the new ones on your web server.

2. WordPress Shows a Directory Listing Instead of a Web Page

Once your WordPress site is installed, you might see directory instead of web pages.

How to fix this problem?

To solve this problem, there are two different solutions:

  1. Simply tell your web server to view “index.php” file by default. This requires using the “DirectoryIndex index.php” directive in Apache web server.
  1. The simplest way to resolve this issue is to create a new .htaccess file within your installed directory. And then, add your directive there or else you can place the directive to the configuration files of your web server.

3. Inability to Modify Header Information

Often we tend to make syntax error while making edits to the WordPress configuration (i.e. wp-config.php) file, because of which you may receive an error message on your web browser saying: “Warning: Cannot modify header information …” as you can see in the below image:

wordpress install error

How to fix this problem?

To deal with such an issue, you just need to get rid of unwanted data from your wp-config.php file in the form of spaces, text, or other stuff.

Step 1 – Download your wp-config.php file on your system using an FTP client.

Step 2 – Open the downloaded configuration file in a text editor of your choice.

Step 3 – When you’ve opened the config file, simply check if the first line within that file contains only “<?php” and does not contain any spaces before it:

Inability to modify header information

Step 4 – Next, make sure that the last line of your configuration file contains only “?>”, without any spaces in between.

Step 5 – In case you are saving your wp-config.php file in Unicode, then make sure that your text editor does not add any byte order mark (BOM). Unfortunately, the majority of Unicode-enabled text editors won’t tell you whether it will be adding a BOM to files or not; and so, make sure to select a text editor that can inform you about the same.

Step 6 – Lastly, save your configuration file.


Note: Adding too many “<?php ?>” tags in your source code might result in a gibberish web page. This happens because sending <?php ?> tags to the browser mean that your PHP isn’t working correctly. Remember that your site’s PHP code needs to be executed before your server sends your markup (i.e. HTML) to your web browser. In addition, ensure that your server fulfills all the requirements needed to run WordPress. Also, make sure to install and configure PHP in a proper way. 

4. Error Establishing a Connection to Database

Your WordPress site, at times, might not be able to establish a connection to your database.

How to fix this problem?

There could be several reasons that might cause this error. For instance, your database login credentials are not right, or server is unresponsive and so on. When receiving such an error, make sure if it occurs on both the front-end as well as the back-end of your site.

If you receive the same message on the front-end and admin area, then follow these steps:

Step 1 – Add a line of code in your wp-config.php file, as follows:

define(‘WP_ALLOW_REPAIR’, true);

Step 2 – Visit the web page in the path:

You will be able to view the following window:

wordpress Error establishing a connection to database

Users cannot login in the admin area when the database is corrupt. And so, clicking on the “Repair Database” option will help you in repairing your corrupted database.

5. Your Website Images Aren’t Working

If you utilize the “Rich Text Editor” such as TinyMCE for editing a WordPress blog that is installed in a subdirectory, then your newly uploaded image that you dragged into the editor field may not be visible after a few seconds. This occurs such TinyMCE often do not get enough information about drag operation that creates the image path.

How to fix this problem?

Make sure not to drag your uploaded images into the TinyMCE editor. Rather, simply “click and hold on” the uploaded images, and then select the “Send to Editor” option.

Wrapping Up

As a novice developer or an individual looking forward to installing a WordPress website, you must be ready to resolve a few common installation issues. Reading this post will help you become familiar with 5 such issues and solutions to fix them.

Author Biography: Samuel Dawson is a mature developer with relevant experience in Front End development technologies. Samuel has been a cumulative PSD to WordPress theme conversion service provider all over the world. He is also an expert designer.

Leave a Reply

Your email address will not be published. Required fields are marked *