Troubleshooting using the Health Check

The support team utilizes the Health Check plugin to help with troubleshooting common problems with websites, and to provide debug information to help with identifying problems with site setups.

This is an introduction to the various elements of the plugin, and how to utilize the various features it provides.

When active, the Health Check plugin can be found in your admin menu, under the Dashboard menu

Health check

The first tab you are presented with will run a suite of checks against your site to ensure various software versions are up to date, and required features are available.

 

The checks that are performed at the time of writing are:

Debug information

The debug information tab provides information that may be crucial to replicating issues, or identifying causes for problems with a site.

This page also provides the user with a field for easily copying this information over into a support topic on the WordPress.org support forums (or to their plugin or theme providers support form if they wish). This section can be accessed by clicking the Show copy and paste field button at the top of the page.

The information in the copy and paste field has been filtered, and some data from the debug tab is unavailable as it is deemed private, such as database information, this means you can safely copy the whole field and it will be formatted and should be safe to put on a public forum.

Alert: Note that the information provided on the debug page can be added to by plugins or themes using the debug_information filter.

If you are using the plugin in a language that has been translated, you may also find that you are presented with two buttons, one will provide the copy and paste information in your own language, the other will provide it in English, this is to make it easier to provide the information depending on what support site you are using (for example, one of our support forums in your own language).

Troubleshooting

When utilizing the troubleshooting mode, your currently logged in user is given a stripped down version of WordPress, where all plugins are disabled and one of the default themes is activated.

It is important to note that this is only the case for your user, it does not affect any other site visitors, or users of your site, for them the theme will be the same, and all plugins will still be running as before.

This mode is essential when trying to identify the cause of an issue, as in most cases, any issue you have will be introduced by your theme or one of your plugins (or maybe even multiple plugins interacting poorly with each other),

When in troubleshooting mode you are able to verify if a problem still exists in a basic WordPress setup, thus helping us identify and fixing a bug others may be encountering, or finding out which plugin or your theme is causing the problems so that you can report this to the applicable authors.

Once in troubleshooting mode, a new item is added to your admin bar, this gives you an overview of which plugins are enabled or disabled, and allows you to toggle them on or off.
It also allows you to switch between a default theme, and your currently active theme (the one you were using on your site before enabling troubleshooting mode), and of course gives you a way to disable troubleshooting mode.

PHP information

The PHP information tab is here for those extra hard issues, where normal information may not be enough and information about your sites more granular settings are required.

This tab is essentially just the output of the phpinfo() function, but adjusted to be displayed within your WordPress site instead of requiring you to write your own file to get the data.

When asked for additional information from this page, the simplest approach is to use your browsers search feature (ctrl+f or cmd+f) and typing or pasting the name of the field you are asked to find.