Fixing Problems

Even though we start simply, potentially, a number of things could go wrong. If you're having problems, delete what you have and start over and follow our previous directions carefully. If you still have problems, this section covers some common issues and gives you solutions that you can try to fix them.

White screen of nothingness

A common problem when doing plugin development is making a change and finding that every attempt to load the site in your browser window results in a blank white screen. A code error is breaking WordPress when it tries to run your plugin code.

A quick way to fix this is to rename your /wp-content/plugins/example-do-nothing plugin directory on your Web server to something like /wp-content/plugins/old.example-do-nothing. This causes automatic deactivation of the plugin because WordPress won't be able to locate it.

Before changing the name back, go to the Plugins page in your Dashboard. A message at the top of the page states The plugin example-do-nothing/init.php has been deactivated due to an error: Plugin file does not exist.

This confirms that WordPress fully deactivated the broken plugin; you should be able to load your Web site successfully without seeing the dreaded white screen of nothingness. After this, you can change the filename back, fix your problem, and try again. If the plugin is still broken, WordPress prevents the plugin from activating and gives you details about the error.

Unexpected output error

When you activate a ...

Get WordPress® All-in-One For Dummies® now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.