﻿{"id":47317,"date":"2018-01-04T03:00:52","date_gmt":"2018-01-04T03:00:52","guid":{"rendered":"https:\/\/make.wordpress.org\/support\/?post_type=handbook&#038;p=47317"},"modified":"2020-05-06T07:03:54","modified_gmt":"2020-05-06T07:03:54","slug":"troubleshooting-using-the-health-check","status":"publish","type":"handbook","link":"https:\/\/make.wordpress.org\/support\/handbook\/appendix\/troubleshooting-using-the-health-check\/","title":{"rendered":"Troubleshooting using the Health Check"},"content":{"rendered":"<p class=\"wp-block-paragraph\">The support team utilizes the <a href=\"https:\/\/wordpress.org\/plugins\/health-check\/\">Health Check plugin<\/a> to help with troubleshooting common problems with websites, and to provide debug information to help with identifying problems with site setups.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is an introduction to the various elements of the <span tabindex='0' class='glossary-item-container'>plugin<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Plugin<\/span> <span class='glossary-item-description'>A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory <a href=\"https:\/\/wordpress.org\/plugins\/\">https:\/\/wordpress.org\/plugins\/<\/a> or can be cost-based plugin from a third-party.<\/span><\/span><\/span>, and how to utilize the various features it provides.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When active, the Health Check plugin can be found in your admin menu, under the <strong>Dashboard<\/strong> menu<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Health check<\/h2>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/health-check-tab.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1015\" height=\"590\" src=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/health-check-tab.png\" alt=\"\" class=\"wp-image-47321\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/health-check-tab.png 1015w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/health-check-tab-300x174.png 300w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/health-check-tab-768x446.png 768w\" sizes=\"auto, (max-width: 1015px) 100vw, 1015px\"><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The checks that are performed at the time of writing are:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><span tabindex='0' class='glossary-item-container'>PHP<span class='glossary-item-hidden-content'><span class='glossary-item-header'>PHP<\/span> <span class='glossary-item-description'>PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. <a href=\"https:\/\/www.php.net\/manual\/en\/index.php\">https:\/\/www.php.net\/manual\/en\/index.php<\/a><\/span><\/span><\/span> Version: Check if your site uses the minimum required PHP version, and also recommends a newer version if if it older than the recommended version.<\/li><li><span tabindex='0' class='glossary-item-container'>MySQL<span class='glossary-item-hidden-content'><span class='glossary-item-header'>MySQL<\/span> <span class='glossary-item-description'>MySQL is a relational database management system. A database is a structured collection of data where content, configuration and other options are stored. <a href=\"https:\/\/www.mysql.com\/\">https:\/\/www.mysql.com<\/a><\/span><\/span><\/span> Server version: Checks that the database service your site uses is on the minimum required version (supports both MySQL and MariaDB, these are the two database engines we officially support).<\/li><li><span tabindex='0' class='glossary-item-container'>JSON<span class='glossary-item-hidden-content'><span class='glossary-item-header'>JSON<\/span> <span class='glossary-item-description'>JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML.<\/span><\/span><\/span> Extension: Many features in WordPress, as well as plugins and themes, rely on data in a format known as JSON, this check makes sure this is enabled for your site.<\/li><li>MySQL utf8mb4 support: Since WordPress 4.2, we now support <a href=\"https:\/\/make.wordpress.org\/core\/2015\/04\/02\/the-utf8mb4-upgrade\/\">utf8mb4 as the database character set<\/a>, this allows for various advanced letters to be utilized on your site, such as <a href=\"https:\/\/en.wikipedia.org\/wiki\/Han_unification\">Han character sets<\/a>.<\/li><li>Communication with <span tabindex='0' class='glossary-item-container'>WordPress.org<span class='glossary-item-hidden-content'><span class='glossary-item-header'>WordPress.org<\/span> <span class='glossary-item-description'>The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization.  <a href=\"https:\/\/wordpress.org\/\">https:\/\/wordpress.org\/<\/a><\/span><\/span><\/span>: This makes sure you can fetch plugin, theme and WordPress <span tabindex='0' class='glossary-item-container'>core<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Core<\/span> <span class='glossary-item-description'>Core is the set of software required to run WordPress. The Core Development Team builds WordPress.<\/span><\/span><\/span> updates from the WordPress.org network.<\/li><li><span tabindex='0' class='glossary-item-container'>HTTPS<span class='glossary-item-hidden-content'><span class='glossary-item-header'>HTTPS<\/span> <span class='glossary-item-description'>HTTPS is an acronym for Hyper Text Transfer Protocol Secure. HTTPS  is the secure version of HTTP, the protocol over which data is sent between your browser and the website that you are connected to. The 'S' at the end of HTTPS stands for 'Secure'. It means all communications between your browser and the website are encrypted. This is especially helpful for protecting sensitive data like banking information.<\/span><\/span><\/span> Status: Checks if you are visiting your site using a secure connection.<\/li><li>Secure communication: Checks if your website is able to communicate with external services using secure connections (<span tabindex='0' class='glossary-item-container'>SSL<span class='glossary-item-hidden-content'><span class='glossary-item-header'>SSL<\/span> <span class='glossary-item-description'>Secure Socket Layer - Encryption from the server to the browser and back. Prevents prying eyes from seeing what you are sending between your browser and the server.<\/span><\/span><\/span>), many services require secure communications to work and this may affect various plugins.<\/li><li>Scheduled events: Checks if <a href=\"https:\/\/developer.wordpress.org\/plugins\/cron\/\">WP Cron<\/a>\u00a0is running like it should, if it fails, things such as scheduled posts and automated updates won\u2019t work.<\/li><li>Background updates: A suite of tests to check if anything is preventing WordPress from automatically applying minor updates (security\/bugfix updates).<\/li><li>Loopback request: Checks if anything is preventing loopbacks from being triggered. A loopback is used to start WP Cron, as mentioned earlier, and is also used to verify files after making updates and can affect many different parts of your site. If a request were to fail, you will be presented with a method to test if it\u2019s caused by one or more of your plugins.<\/li><\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Debug information<\/h2>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1276\" height=\"609\" src=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab.png\" alt=\"\" class=\"wp-image-47322\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab.png 1276w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab-300x143.png 300w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab-768x367.png 768w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab-1024x489.png 1024w\" sizes=\"auto, (max-width: 1276px) 100vw, 1276px\"><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The debug information tab provides information that may be crucial to replicating issues, or identifying causes for problems with a site.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"alignright\"><a href=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab-copy.png\"><img loading=\"lazy\" decoding=\"async\" width=\"150\" height=\"150\" src=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/debug-information-tab-copy-150x150.png\" alt=\"\" class=\"wp-image-47323\"><\/a><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">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\u00a0<strong>Show copy and paste field<\/strong> button at the top of the page.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<div class=\"wp-block-wporg-notice is-alert-notice\">\n<div class=\"wp-block-wporg-notice__icon\"><\/div>\n<div class=\"wp-block-wporg-notice__content\">Note that the information provided on the debug page can be added to by plugins or themes using the <strong>debug_information<\/strong> <span tabindex=\"0\" class=\"glossary-item-container\"><span tabindex='0' class='glossary-item-container'>filter<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Filter<\/span> <span class='glossary-item-description'>Filters are one of the two types of Hooks <a href=\"https:\/\/codex.wordpress.org\/Plugin_API\/Hooks\">https:\/\/codex.wordpress.org\/Plugin_API\/Hooks<\/a>. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.<\/span><\/span><\/span><span class=\"glossary-item-hidden-content\"><span class=\"glossary-item-header\">Filter<\/span> <span class=\"glossary-item-description\">Filters are one of the two types of <span tabindex='0' class='glossary-item-container'>Hooks<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Hooks<\/span> <span class='glossary-item-description'>In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same.<\/span><\/span><\/span> <a href=\"https:\/\/codex.wordpress.org\/Plugin_API\/Hooks\">https:\/\/codex.wordpress.org\/Plugin_API\/Hooks<\/a>. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.<\/span><\/span><\/span>.<\/div><\/div>\n\n\n\n\n<p class=\"wp-block-paragraph\">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 <a href=\"https:\/\/make.wordpress.org\/support\/handbook\/contributing-to-the-wordpress-forums\/support-forums-in-your-language\/\">support forums in your own language<\/a>).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-tab.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1292\" height=\"341\" src=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-tab.png\" alt=\"\" class=\"wp-image-47324\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-tab.png 1292w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-tab-300x79.png 300w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-tab-768x203.png 768w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-tab-1024x270.png 1024w\" sizes=\"auto, (max-width: 1292px) 100vw, 1292px\"><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Troubleshooting with a specific plugin<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"431\" src=\"https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1024x431.png\" alt=\"\" class=\"wp-image-48685\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1024x431.png 1024w, https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-300x126.png 300w, https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-768x323.png 768w, https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image.png 1117w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If you wish to find out what is causing a conflict with another plugin (or to identify if it is experiencing issues on its own), the normal plugins page will let you quickly jump into troubleshooting mode by clicking the <code>Troubleshoot<\/code> link under the plugin you wish to test.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This will enable troubleshooting mode, with only that plugin active by default, and let you test further from there.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Navigating while troubleshooting<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Once in troubleshooting mode, a new item is added to your admin bar, and a dashboard <span tabindex='0' class='glossary-item-container'>widget<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Widget<\/span> <span class='glossary-item-description'>A WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user.<\/span><\/span><\/span> is shown, which gives you an overview of which plugins are enabled or disabled, and allows you to toggle them on or off.<br>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.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"737\" height=\"186\" src=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-mode-admin-bar.png\" alt=\"Troubleshooting Mode admin bar menu\" class=\"wp-image-47325\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-mode-admin-bar.png 737w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/troubleshooting-mode-admin-bar-300x76.png 300w\" sizes=\"auto, (max-width: 737px) 100vw, 737px\"><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">The admin bar lets you switch plugins or themes while on the front end of your site, letting you quickly test user-facing issues on your site.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"327\" src=\"https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1-1024x327.png\" alt=\"Troubleshooting Mode dashboard widget\" class=\"wp-image-48686\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1-1024x327.png 1024w, https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1-300x96.png 300w, https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1-768x245.png 768w, https:\/\/make.wordpress.org\/support\/files\/2020\/05\/image-1.png 1100w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">The dashboard widget gives a good overview of what is going on while in the back-end of your site.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">PHP information<\/h2>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/php-information-tab.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1281\" height=\"486\" src=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/php-information-tab.png\" alt=\"\" class=\"wp-image-47326\" srcset=\"https:\/\/make.wordpress.org\/support\/files\/2018\/01\/php-information-tab.png 1281w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/php-information-tab-300x114.png 300w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/php-information-tab-768x291.png 768w, https:\/\/make.wordpress.org\/support\/files\/2018\/01\/php-information-tab-1024x388.png 1024w\" sizes=\"auto, (max-width: 1281px) 100vw, 1281px\"><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This tab is essentially just the output of the <code>phpinfo()<\/code> function, but adjusted to be displayed within your WordPress site instead of requiring you to write your own file to get the data.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n<nav class='o2-post-footer-actions'><ul class='o2-post-footer-action-row'><\/ul><div class='o2-post-footer-action-likes'><\/div><ul class='o2-post-footer-action-row'><\/ul><\/nav>","protected":false},"author":7337072,"featured_media":0,"parent":44991,"menu_order":0,"template":"","meta":{"footnotes":""},"class_list":["post-47317","handbook","type-handbook","status-publish","hentry","author-clorith","make-troubleshooting-using-the-health-check"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/handbook\/47317","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/handbook"}],"about":[{"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/types\/handbook"}],"author":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/users\/7337072"}],"version-history":[{"count":13,"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/handbook\/47317\/revisions"}],"predecessor-version":[{"id":48688,"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/handbook\/47317\/revisions\/48688"}],"up":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/handbook\/44991"}],"wp:attachment":[{"href":"https:\/\/make.wordpress.org\/support\/wp-json\/wp\/v2\/media?parent=47317"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}