Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
< ? php
/**
* Class for providing debug data based on a users WordPress environment .
*
* @ package WordPress
* @ subpackage Site_Health
* @ since 5.2 . 0
*/
Code Modernization: Add `AllowDynamicProperties` attribute to all (parent) classes.
Dynamic (non-explicitly declared) properties are deprecated as of PHP 8.2 and are expected to become a fatal error in PHP 9.0.
There are a number of ways to mitigate this:
* If it is an accidental typo for a declared property: fix the typo.
* For known properties: declare them on the class.
* For unknown properties: add the magic `__get()`, `__set()`, et al. methods to the class or let the class extend `stdClass` which has highly optimized versions of these magic methods built in.
* For unknown ''use'' of dynamic properties, the `#[AllowDynamicProperties]` attribute can be added to the class. The attribute will automatically be inherited by child classes.
Trac ticket #56034 is open to investigate and handle the third and fourth type of situations, however it has become clear this will need more time and will not be ready in time for WP 6.1.
To reduce “noise” in the meantime, both in the error logs of WP users moving onto PHP 8.2, in the test run logs of WP itself, in test runs of plugins and themes, as well as to prevent duplicate tickets from being opened for the same issue, this commit adds the `#[AllowDynamicProperties]` attribute to all “parent” classes in WP.
The logic used for this commit is as follows:
* If a class already has the attribute: no action needed.
* If a class does not `extend`: add the attribute.
* If a class does `extend`:
- If it extends `stdClass`: no action needed (as `stdClass` supports dynamic properties).
- If it extends a PHP native class: add the attribute.
- If it extends a class from one of WP's external dependencies: add the attribute.
* In all other cases: no action — the attribute should not be needed as child classes inherit from the parent.
Whether or not a class contains magic methods has not been taken into account, as a review of the currently existing magic methods has shown that those are generally not sturdy enough and often even set dynamic properties (which they should not). See the [https://www.youtube.com/watch?v=vDZWepDQQVE live stream from August 16, 2022] for more details.
This commit only affects classes in the `src` directory of WordPress core.
* Tests should not get this attribute, but should be fixed to not use dynamic properties instead. Patches for this are already being committed under ticket #56033.
* While a number bundled themes (2014, 2019, 2020, 2021) contain classes, they are not a part of this commit and may be updated separately.
Reference: [https://wiki.php.net/rfc/deprecate_dynamic_properties PHP RFC: Deprecate dynamic properties].
Follow-up to [53922].
Props jrf, hellofromTonya, markjaquith, peterwilsoncc, costdev, knutsp, aristath.
See #56513, #56034.
Built from https://develop.svn.wordpress.org/trunk@54133
git-svn-id: http://core.svn.wordpress.org/trunk@53692 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-12 11:47:14 -04:00
#[AllowDynamicProperties]
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
class WP_Debug_Data {
/**
* Calls all core functions to check for updates .
*
* @ since 5.2 . 0
*/
2021-10-18 13:52:58 -04:00
public static function check_for_updates () {
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
wp_version_check ();
wp_update_plugins ();
wp_update_themes ();
}
/**
* Static function for generating site debug data when required .
*
* @ since 5.2 . 0
2020-03-28 17:20:06 -04:00
* @ since 5.3 . 0 Added database charset , database collation ,
* and timezone information .
* @ since 5.5 . 0 Added pretty permalinks support information .
2024-09-02 16:44:16 -04:00
* @ since 6.7 . 0 Modularized into separate theme - oriented methods .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
* @ throws ImagickException
2022-12-09 07:25:14 -05:00
* @ global array $_wp_theme_features
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
* @ return array The debug data for the site .
*/
2021-10-18 13:52:58 -04:00
public static function debug_data () {
2024-09-02 16:44:16 -04:00
global $_wp_theme_features ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2019-04-10 01:07:51 -04:00
// Save few function calls.
2019-09-21 11:49:57 -04:00
$upload_dir = wp_upload_dir ();
2020-08-16 14:27:04 -04:00
$is_multisite = is_multisite ();
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2024-09-06 15:50:19 -04:00
/*
* Set up the array that holds all debug information .
*
* When iterating through the debug data , the ordering of the sections
* occurs in insertion - order of the assignments into this array . Setting
* up empty values here preserves that specific ordering so it doesn ' t
* depend on when inside this method each section is otherwise assigned .
*
* When all sections have been modularized , this will be the final single
* assignment of the sections before filtering and none will be empty .
*
* @ ticket 61648
*/
$info = array (
2024-10-05 11:59:17 -04:00
'wp-core' => self :: get_wp_core (),
2024-09-06 15:50:19 -04:00
'wp-paths-sizes' => array (),
2024-09-27 01:58:18 -04:00
'wp-dropins' => self :: get_wp_dropins (),
2024-09-06 15:50:19 -04:00
'wp-active-theme' => array (),
'wp-parent-theme' => array (),
'wp-themes-inactive' => array (),
2024-09-11 10:47:20 -04:00
'wp-mu-plugins' => self :: get_wp_mu_plugins (),
2024-10-04 18:12:17 -04:00
'wp-plugins-active' => self :: get_wp_plugins_active (),
'wp-plugins-inactive' => self :: get_wp_plugins_inactive (),
2024-09-18 15:12:06 -04:00
'wp-media' => self :: get_wp_media (),
2024-09-09 20:04:19 -04:00
'wp-server' => self :: get_wp_server (),
2024-09-06 15:50:19 -04:00
'wp-database' => self :: get_wp_database (),
'wp-constants' => self :: get_wp_constants (),
'wp-filesystem' => self :: get_wp_filesystem (),
);
2019-04-10 01:07:51 -04:00
2024-09-09 20:04:19 -04:00
// Remove debug data which is only relevant on single-site installs.
if ( is_multisite () ) {
unset ( $info [ 'wp-paths-sizes' ] );
}
2019-04-17 20:34:51 -04:00
if ( ! $is_multisite ) {
$info [ 'wp-paths-sizes' ] = array (
2024-06-03 17:07:13 -04:00
/* translators: Filesystem directory paths and storage sizes. */
2019-04-17 20:34:51 -04:00
'label' => __ ( 'Directories and Sizes' ),
'fields' => array (),
);
}
2019-04-10 01:07:51 -04:00
$info [ 'wp-active-theme' ] = array (
'label' => __ ( 'Active Theme' ),
'fields' => array (),
);
2019-07-25 23:49:55 -04:00
$info [ 'wp-parent-theme' ] = array (
'label' => __ ( 'Parent Theme' ),
'fields' => array (),
);
$info [ 'wp-themes-inactive' ] = array (
'label' => __ ( 'Inactive Themes' ),
2019-04-10 01:07:51 -04:00
'show_count' => true ,
'fields' => array (),
);
2019-04-17 20:34:51 -04:00
// Remove accordion for Directories and Sizes if in Multisite.
if ( ! $is_multisite ) {
$loading = __ ( 'Loading…' );
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2019-04-17 20:34:51 -04:00
$info [ 'wp-paths-sizes' ][ 'fields' ] = array (
'wordpress_path' => array (
'label' => __ ( 'WordPress directory location' ),
'value' => untrailingslashit ( ABSPATH ),
),
'wordpress_size' => array (
'label' => __ ( 'WordPress directory size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
'uploads_path' => array (
'label' => __ ( 'Uploads directory location' ),
'value' => $upload_dir [ 'basedir' ],
),
'uploads_size' => array (
'label' => __ ( 'Uploads directory size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
'themes_path' => array (
'label' => __ ( 'Themes directory location' ),
'value' => get_theme_root (),
),
'themes_size' => array (
'label' => __ ( 'Themes directory size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
'plugins_path' => array (
'label' => __ ( 'Plugins directory location' ),
'value' => WP_PLUGIN_DIR ,
),
'plugins_size' => array (
'label' => __ ( 'Plugins directory size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
Coding Standards: Apply changes after running `composer format`.
This applies several formatting related changes made while running `composer format`.
Follow up to [55720], [58171], [58271], [58282], [58283], [58292], [58299], [58303], [58332].
See #51857, #60719, #60895, #61021, #61118, #61228, #61276, #61324.
Built from https://develop.svn.wordpress.org/trunk@58408
git-svn-id: http://core.svn.wordpress.org/trunk@57857 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2024-06-13 11:06:07 -04:00
'fonts_path' => array (
Site Health: Add fonts upload location to Site Health report.
Just like Site Health lists the paths to the plugins/themes/uploads directories, this changeset adds the path to the fonts directory (and its size).
Props swissspidy, andr3ribeiro, krupajnanda, ironprogrammer, iamfarhan09, naeemhaque, imasikur22, tofajjal02, sarkarripon, prottoysarkar, zunaid321, imranhasanraaz, rajinsharwar, nazmul111, audrasjb, peterwilsoncc.
Fixes #60719.
Built from https://develop.svn.wordpress.org/trunk@58299
git-svn-id: http://core.svn.wordpress.org/trunk@57759 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2024-06-03 12:56:16 -04:00
'label' => __ ( 'Fonts directory location' ),
'value' => wp_get_font_dir ()[ 'basedir' ],
),
Coding Standards: Apply changes after running `composer format`.
This applies several formatting related changes made while running `composer format`.
Follow up to [55720], [58171], [58271], [58282], [58283], [58292], [58299], [58303], [58332].
See #51857, #60719, #60895, #61021, #61118, #61228, #61276, #61324.
Built from https://develop.svn.wordpress.org/trunk@58408
git-svn-id: http://core.svn.wordpress.org/trunk@57857 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2024-06-13 11:06:07 -04:00
'fonts_size' => array (
Site Health: Add fonts upload location to Site Health report.
Just like Site Health lists the paths to the plugins/themes/uploads directories, this changeset adds the path to the fonts directory (and its size).
Props swissspidy, andr3ribeiro, krupajnanda, ironprogrammer, iamfarhan09, naeemhaque, imasikur22, tofajjal02, sarkarripon, prottoysarkar, zunaid321, imranhasanraaz, rajinsharwar, nazmul111, audrasjb, peterwilsoncc.
Fixes #60719.
Built from https://develop.svn.wordpress.org/trunk@58299
git-svn-id: http://core.svn.wordpress.org/trunk@57759 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2024-06-03 12:56:16 -04:00
'label' => __ ( 'Fonts directory size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
2019-04-17 20:34:51 -04:00
'database_size' => array (
'label' => __ ( 'Database size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
'total_size' => array (
'label' => __ ( 'Total installation size' ),
'value' => $loading ,
'debug' => 'loading...' ,
),
);
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
// Populate the section for the currently active theme.
$theme_features = array ();
2019-04-10 01:07:51 -04:00
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
if ( ! empty ( $_wp_theme_features ) ) {
foreach ( $_wp_theme_features as $feature => $options ) {
$theme_features [] = $feature ;
}
}
$active_theme = wp_get_theme ();
$theme_updates = get_theme_updates ();
2020-08-04 13:37:02 -04:00
$transient = get_site_transient ( 'update_themes' );
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2020-01-17 19:26:06 -05:00
$active_theme_version = $active_theme -> version ;
2019-04-10 01:07:51 -04:00
$active_theme_version_debug = $active_theme_version ;
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
$auto_updates = array ();
$auto_updates_enabled = wp_is_auto_update_enabled_for_type ( 'theme' );
if ( $auto_updates_enabled ) {
$auto_updates = ( array ) get_site_option ( 'auto_update_themes' , array () );
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
if ( array_key_exists ( $active_theme -> stylesheet , $theme_updates ) ) {
2019-04-10 01:07:51 -04:00
$theme_update_new_version = $theme_updates [ $active_theme -> stylesheet ] -> update [ 'new_version' ];
2019-09-02 20:41:05 -04:00
/* translators: %s: Latest theme version number. */
2019-04-10 01:07:51 -04:00
$active_theme_version .= ' ' . sprintf ( __ ( '(Latest version: %s)' ), $theme_update_new_version );
$active_theme_version_debug .= sprintf ( ' (latest version: %s)' , $theme_update_new_version );
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
2020-01-17 19:26:06 -05:00
$active_theme_author_uri = $active_theme -> display ( 'AuthorURI' );
2019-04-10 01:07:51 -04:00
2019-07-25 23:49:55 -04:00
if ( $active_theme -> parent_theme ) {
$active_theme_parent_theme = sprintf (
2019-09-02 20:41:05 -04:00
/* translators: 1: Theme name. 2: Theme slug. */
2019-07-25 23:49:55 -04:00
__ ( '%1$s (%2$s)' ),
$active_theme -> parent_theme ,
$active_theme -> template
);
$active_theme_parent_theme_debug = sprintf (
'%s (%s)' ,
$active_theme -> parent_theme ,
$active_theme -> template
);
} else {
$active_theme_parent_theme = __ ( 'None' );
$active_theme_parent_theme_debug = 'none' ;
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
$info [ 'wp-active-theme' ][ 'fields' ] = array (
'name' => array (
'label' => __ ( 'Name' ),
2019-07-25 23:49:55 -04:00
'value' => sprintf (
2019-09-02 20:41:05 -04:00
/* translators: 1: Theme name. 2: Theme slug. */
2019-07-25 23:49:55 -04:00
__ ( '%1$s (%2$s)' ),
2020-01-17 19:26:06 -05:00
$active_theme -> name ,
2019-07-25 23:49:55 -04:00
$active_theme -> stylesheet
),
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
),
'version' => array (
'label' => __ ( 'Version' ),
2019-04-10 01:07:51 -04:00
'value' => $active_theme_version ,
'debug' => $active_theme_version_debug ,
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
),
'author' => array (
'label' => __ ( 'Author' ),
2020-01-17 19:26:06 -05:00
'value' => wp_kses ( $active_theme -> author , array () ),
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
),
'author_website' => array (
'label' => __ ( 'Author website' ),
2019-04-10 01:07:51 -04:00
'value' => ( $active_theme_author_uri ? $active_theme_author_uri : __ ( 'Undefined' ) ),
'debug' => ( $active_theme_author_uri ? $active_theme_author_uri : '(undefined)' ),
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
),
'parent_theme' => array (
'label' => __ ( 'Parent theme' ),
2019-07-25 23:49:55 -04:00
'value' => $active_theme_parent_theme ,
'debug' => $active_theme_parent_theme_debug ,
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
),
'theme_features' => array (
'label' => __ ( 'Theme features' ),
'value' => implode ( ', ' , $theme_features ),
),
2019-04-16 19:02:51 -04:00
'theme_path' => array (
'label' => __ ( 'Theme directory location' ),
2019-07-25 23:49:55 -04:00
'value' => get_stylesheet_directory (),
2019-04-16 19:02:51 -04:00
),
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
);
2020-07-21 14:44:04 -04:00
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
if ( $auto_updates_enabled ) {
2020-08-04 13:37:02 -04:00
if ( isset ( $transient -> response [ $active_theme -> stylesheet ] ) ) {
$item = $transient -> response [ $active_theme -> stylesheet ];
} elseif ( isset ( $transient -> no_update [ $active_theme -> stylesheet ] ) ) {
$item = $transient -> no_update [ $active_theme -> stylesheet ];
} else {
2020-08-07 09:28:05 -04:00
$item = array (
2020-08-04 13:37:02 -04:00
'theme' => $active_theme -> stylesheet ,
'new_version' => $active_theme -> version ,
'url' => '' ,
'package' => '' ,
'requires' => '' ,
'requires_php' => '' ,
);
}
2020-07-21 12:54:02 -04:00
2020-10-20 13:39:07 -04:00
$auto_update_forced = wp_is_auto_update_forced_for_item ( 'theme' , null , ( object ) $item );
2020-08-04 13:37:02 -04:00
if ( ! is_null ( $auto_update_forced ) ) {
$enabled = $auto_update_forced ;
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
} else {
2020-08-04 13:37:02 -04:00
$enabled = in_array ( $active_theme -> stylesheet , $auto_updates , true );
}
2020-07-21 12:54:02 -04:00
2020-08-04 13:37:02 -04:00
if ( $enabled ) {
$auto_updates_string = __ ( 'Enabled' );
} else {
$auto_updates_string = __ ( 'Disabled' );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2020-08-04 13:37:02 -04:00
/** This filter is documented in wp-admin/includes/class-wp-debug-data.php */
$auto_updates_string = apply_filters ( 'theme_auto_update_debug_string' , $auto_updates_string , $active_theme , $enabled );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
$info [ 'wp-active-theme' ][ 'fields' ][ 'auto_update' ] = array (
2020-07-21 17:06:02 -04:00
'label' => __ ( 'Auto-updates' ),
2020-07-21 14:44:04 -04:00
'value' => $auto_updates_string ,
'debug' => $auto_updates_string ,
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
);
}
2020-07-21 14:44:04 -04:00
2019-07-25 23:49:55 -04:00
$parent_theme = $active_theme -> parent ();
if ( $parent_theme ) {
2020-01-17 19:26:06 -05:00
$parent_theme_version = $parent_theme -> version ;
2019-07-25 23:49:55 -04:00
$parent_theme_version_debug = $parent_theme_version ;
if ( array_key_exists ( $parent_theme -> stylesheet , $theme_updates ) ) {
$parent_theme_update_new_version = $theme_updates [ $parent_theme -> stylesheet ] -> update [ 'new_version' ];
2019-09-02 20:41:05 -04:00
/* translators: %s: Latest theme version number. */
2019-07-25 23:49:55 -04:00
$parent_theme_version .= ' ' . sprintf ( __ ( '(Latest version: %s)' ), $parent_theme_update_new_version );
$parent_theme_version_debug .= sprintf ( ' (latest version: %s)' , $parent_theme_update_new_version );
}
2020-01-17 19:26:06 -05:00
$parent_theme_author_uri = $parent_theme -> display ( 'AuthorURI' );
2019-07-25 23:49:55 -04:00
$info [ 'wp-parent-theme' ][ 'fields' ] = array (
'name' => array (
'label' => __ ( 'Name' ),
'value' => sprintf (
2019-09-02 20:41:05 -04:00
/* translators: 1: Theme name. 2: Theme slug. */
2019-07-25 23:49:55 -04:00
__ ( '%1$s (%2$s)' ),
2020-01-17 19:26:06 -05:00
$parent_theme -> name ,
2019-07-25 23:49:55 -04:00
$parent_theme -> stylesheet
),
),
'version' => array (
'label' => __ ( 'Version' ),
'value' => $parent_theme_version ,
'debug' => $parent_theme_version_debug ,
),
'author' => array (
'label' => __ ( 'Author' ),
2020-01-17 19:26:06 -05:00
'value' => wp_kses ( $parent_theme -> author , array () ),
2019-07-25 23:49:55 -04:00
),
'author_website' => array (
'label' => __ ( 'Author website' ),
'value' => ( $parent_theme_author_uri ? $parent_theme_author_uri : __ ( 'Undefined' ) ),
'debug' => ( $parent_theme_author_uri ? $parent_theme_author_uri : '(undefined)' ),
),
'theme_path' => array (
'label' => __ ( 'Theme directory location' ),
'value' => get_template_directory (),
),
);
2020-08-04 13:37:02 -04:00
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
if ( $auto_updates_enabled ) {
2020-08-04 13:37:02 -04:00
if ( isset ( $transient -> response [ $parent_theme -> stylesheet ] ) ) {
$item = $transient -> response [ $parent_theme -> stylesheet ];
} elseif ( isset ( $transient -> no_update [ $parent_theme -> stylesheet ] ) ) {
$item = $transient -> no_update [ $parent_theme -> stylesheet ];
} else {
2020-08-07 09:28:05 -04:00
$item = array (
2020-08-04 13:37:02 -04:00
'theme' => $parent_theme -> stylesheet ,
'new_version' => $parent_theme -> version ,
'url' => '' ,
'package' => '' ,
'requires' => '' ,
'requires_php' => '' ,
);
}
2020-10-20 13:39:07 -04:00
$auto_update_forced = wp_is_auto_update_forced_for_item ( 'theme' , null , ( object ) $item );
2020-08-04 13:37:02 -04:00
if ( ! is_null ( $auto_update_forced ) ) {
$enabled = $auto_update_forced ;
} else {
$enabled = in_array ( $parent_theme -> stylesheet , $auto_updates , true );
}
if ( $enabled ) {
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
$parent_theme_auto_update_string = __ ( 'Enabled' );
} else {
$parent_theme_auto_update_string = __ ( 'Disabled' );
}
2020-08-04 13:37:02 -04:00
/** This filter is documented in wp-admin/includes/class-wp-debug-data.php */
2024-07-13 23:47:16 -04:00
$parent_theme_auto_update_string = apply_filters ( 'theme_auto_update_debug_string' , $parent_theme_auto_update_string , $parent_theme , $enabled );
2020-08-04 13:37:02 -04:00
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
$info [ 'wp-parent-theme' ][ 'fields' ][ 'auto_update' ] = array (
'label' => __ ( 'Auto-update' ),
'value' => $parent_theme_auto_update_string ,
'debug' => $parent_theme_auto_update_string ,
);
}
2019-07-25 23:49:55 -04:00
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
// Populate a list of all themes available in the install.
$all_themes = wp_get_themes ();
foreach ( $all_themes as $theme_slug => $theme ) {
2019-07-25 23:49:55 -04:00
// Exclude the currently active theme from the list of all themes.
2019-04-10 01:07:51 -04:00
if ( $active_theme -> stylesheet === $theme_slug ) {
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
continue ;
}
2019-07-25 23:49:55 -04:00
// Exclude the currently active parent theme from the list of all themes.
if ( ! empty ( $parent_theme ) && $parent_theme -> stylesheet === $theme_slug ) {
continue ;
}
2020-01-17 19:26:06 -05:00
$theme_version = $theme -> version ;
$theme_author = $theme -> author ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2020-01-28 19:45:18 -05:00
// Sanitize.
2019-04-10 01:07:51 -04:00
$theme_author = wp_kses ( $theme_author , array () );
$theme_version_string = __ ( 'No version or author information is available.' );
$theme_version_string_debug = 'undefined' ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
if ( ! empty ( $theme_version ) && ! empty ( $theme_author ) ) {
2019-09-02 20:41:05 -04:00
/* translators: 1: Theme version number. 2: Theme author name. */
2019-04-10 01:07:51 -04:00
$theme_version_string = sprintf ( __ ( 'Version %1$s by %2$s' ), $theme_version , $theme_author );
$theme_version_string_debug = sprintf ( 'version: %s, author: %s' , $theme_version , $theme_author );
} else {
if ( ! empty ( $theme_author ) ) {
2019-09-02 20:41:05 -04:00
/* translators: %s: Theme author name. */
2019-04-10 01:07:51 -04:00
$theme_version_string = sprintf ( __ ( 'By %s' ), $theme_author );
$theme_version_string_debug = sprintf ( 'author: %s, version: (undefined)' , $theme_author );
}
if ( ! empty ( $theme_version ) ) {
2019-09-02 20:41:05 -04:00
/* translators: %s: Theme version number. */
2019-04-10 01:07:51 -04:00
$theme_version_string = sprintf ( __ ( 'Version %s' ), $theme_version );
$theme_version_string_debug = sprintf ( 'author: (undefined), version: %s' , $theme_version );
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
if ( array_key_exists ( $theme_slug , $theme_updates ) ) {
2019-09-02 20:41:05 -04:00
/* translators: %s: Latest theme version number. */
2019-04-10 01:07:51 -04:00
$theme_version_string .= ' ' . sprintf ( __ ( '(Latest version: %s)' ), $theme_updates [ $theme_slug ] -> update [ 'new_version' ] );
$theme_version_string_debug .= sprintf ( ' (latest version: %s)' , $theme_updates [ $theme_slug ] -> update [ 'new_version' ] );
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
if ( $auto_updates_enabled ) {
2020-08-04 13:37:02 -04:00
if ( isset ( $transient -> response [ $theme_slug ] ) ) {
$item = $transient -> response [ $theme_slug ];
} elseif ( isset ( $transient -> no_update [ $theme_slug ] ) ) {
$item = $transient -> no_update [ $theme_slug ];
} else {
2020-08-07 09:28:05 -04:00
$item = array (
2020-08-04 13:37:02 -04:00
'theme' => $theme_slug ,
'new_version' => $theme -> version ,
'url' => '' ,
'package' => '' ,
'requires' => '' ,
'requires_php' => '' ,
);
}
2020-07-21 12:54:02 -04:00
2020-10-20 13:39:07 -04:00
$auto_update_forced = wp_is_auto_update_forced_for_item ( 'theme' , null , ( object ) $item );
2020-08-04 13:37:02 -04:00
if ( ! is_null ( $auto_update_forced ) ) {
$enabled = $auto_update_forced ;
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
} else {
2020-08-04 13:37:02 -04:00
$enabled = in_array ( $theme_slug , $auto_updates , true );
}
2020-07-21 12:54:02 -04:00
2020-08-04 13:37:02 -04:00
if ( $enabled ) {
$auto_updates_string = __ ( 'Auto-updates enabled' );
} else {
$auto_updates_string = __ ( 'Auto-updates disabled' );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
}
2020-07-21 14:44:04 -04:00
2020-08-04 13:37:02 -04:00
/**
* Filters the text string of the auto - updates setting for each theme in the Site Health debug data .
*
* @ since 5.5 . 0
*
* @ param string $auto_updates_string The string output for the auto - updates column .
* @ param WP_Theme $theme An object of theme data .
* @ param bool $enabled Whether auto - updates are enabled for this item .
*/
$auto_updates_string = apply_filters ( 'theme_auto_update_debug_string' , $auto_updates_string , $theme , $enabled );
2020-07-21 14:44:04 -04:00
$theme_version_string .= ' | ' . $auto_updates_string ;
2020-10-20 13:39:07 -04:00
$theme_version_string_debug .= ', ' . $auto_updates_string ;
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 14:49:09 -04:00
}
2020-01-17 19:26:06 -05:00
$info [ 'wp-themes-inactive' ][ 'fields' ][ sanitize_text_field ( $theme -> name ) ] = array (
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
'label' => sprintf (
2019-09-02 20:41:05 -04:00
/* translators: 1: Theme name. 2: Theme slug. */
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
__ ( '%1$s (%2$s)' ),
2020-01-17 19:26:06 -05:00
$theme -> name ,
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
$theme_slug
),
2019-04-10 01:07:51 -04:00
'value' => $theme_version_string ,
'debug' => $theme_version_string_debug ,
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
);
}
/**
2022-09-09 04:47:08 -04:00
* Filters the debug information shown on the Tools -> Site Health -> Info screen .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
2021-10-30 09:41:02 -04:00
* Plugin or themes may wish to introduce their own debug information without creating
* additional admin pages . They can utilize this filter to introduce their own sections
* or add more data to existing sections .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
2021-10-30 09:41:02 -04:00
* Array keys for sections added by core are all prefixed with `wp-` . Plugins and themes
* should use their own slug as a prefix , both for consistency as well as avoiding
* key collisions . Note that the array keys are used as labels for the copied data .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
2021-10-30 09:41:02 -04:00
* All strings are expected to be plain text except `$description` that can contain
* inline HTML tags ( see below ) .
2019-04-23 17:05:52 -04:00
*
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
* @ since 5.2 . 0
*
* @ param array $args {
* The debug information to be added to the core information page .
*
2021-10-30 09:41:02 -04:00
* This is an associative multi - dimensional array , up to three levels deep .
* The topmost array holds the sections , keyed by section ID .
2019-04-10 01:07:51 -04:00
*
2021-10-29 11:35:00 -04:00
* @ type array ... $ 0 {
2021-10-30 09:41:02 -04:00
* Each section has a `$fields` associative array ( see below ), and each `$value` in `$fields`
* can be another associative array of name / value pairs when there is more structured data
* to display .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
2021-10-29 11:35:00 -04:00
* @ type string $label Required . The title for this section of the debug output .
2021-10-30 09:41:02 -04:00
* @ type string $description Optional . A description for your information section which
* may contain basic HTML markup , inline tags only as it is
* outputted in a paragraph .
* @ type bool $show_count Optional . If set to `true` , the amount of fields will be included
* in the title for this section . Default false .
* @ type bool $private Optional . If set to `true` , the section and all associated fields
* will be excluded from the copied data . Default false .
2021-10-29 11:35:00 -04:00
* @ type array $fields {
2021-10-30 09:41:02 -04:00
* Required . An associative array containing the fields to be displayed in the section ,
* keyed by field ID .
2021-10-29 11:35:00 -04:00
*
* @ type array ... $ 0 {
* An associative array containing the data to be displayed for the field .
*
* @ type string $label Required . The label for this piece of information .
2021-10-30 09:41:02 -04:00
* @ type mixed $value Required . The output that is displayed for this field .
* Text should be translated . Can be an associative array
* that is displayed as name / value pairs .
2021-10-29 11:35:00 -04:00
* Accepted types : `string|int|float|(string|int|float)[]` .
2021-10-30 09:41:02 -04:00
* @ type string $debug Optional . The output that is used for this field when
* the user copies the data . It should be more concise and
* not translated . If not set , the content of `$value`
* is used . Note that the array keys are used as labels
* for the copied data .
* @ type bool $private Optional . If set to `true` , the field will be excluded
* from the copied data , allowing you to show , for example ,
* API keys here . Default false .
2021-10-29 11:35:00 -04:00
* }
* }
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
* }
* }
*/
$info = apply_filters ( 'debug_information' , $info );
return $info ;
}
2024-10-05 11:59:17 -04:00
/**
* Gets the WordPress core section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
private static function get_wp_core () : array {
// Save few function calls.
$permalink_structure = get_option ( 'permalink_structure' );
$is_ssl = is_ssl ();
$users_can_register = get_option ( 'users_can_register' );
$blog_public = get_option ( 'blog_public' );
$default_comment_status = get_option ( 'default_comment_status' );
$environment_type = wp_get_environment_type ();
$core_version = wp_get_wp_version ();
$core_updates = get_core_updates ();
$core_update_needed = '' ;
if ( is_array ( $core_updates ) ) {
foreach ( $core_updates as $core => $update ) {
if ( 'upgrade' === $update -> response ) {
/* translators: %s: Latest WordPress version number. */
$core_update_needed = ' ' . sprintf ( __ ( '(Latest version: %s)' ), $update -> version );
} else {
$core_update_needed = '' ;
}
}
}
$fields = array (
'version' => array (
'label' => __ ( 'Version' ),
'value' => $core_version . $core_update_needed ,
'debug' => $core_version ,
),
'site_language' => array (
'label' => __ ( 'Site Language' ),
'value' => get_locale (),
),
'user_language' => array (
'label' => __ ( 'User Language' ),
'value' => get_user_locale (),
),
'timezone' => array (
'label' => __ ( 'Timezone' ),
'value' => wp_timezone_string (),
),
'home_url' => array (
'label' => __ ( 'Home URL' ),
'value' => get_bloginfo ( 'url' ),
'private' => true ,
),
'site_url' => array (
'label' => __ ( 'Site URL' ),
'value' => get_bloginfo ( 'wpurl' ),
'private' => true ,
),
'permalink' => array (
'label' => __ ( 'Permalink structure' ),
'value' => $permalink_structure ? $permalink_structure : __ ( 'No permalink structure set' ),
'debug' => $permalink_structure ,
),
'https_status' => array (
'label' => __ ( 'Is this site using HTTPS?' ),
'value' => $is_ssl ? __ ( 'Yes' ) : __ ( 'No' ),
'debug' => $is_ssl ,
),
'multisite' => array (
'label' => __ ( 'Is this a multisite?' ),
'value' => is_multisite () ? __ ( 'Yes' ) : __ ( 'No' ),
'debug' => is_multisite (),
),
'user_registration' => array (
'label' => __ ( 'Can anyone register on this site?' ),
'value' => $users_can_register ? __ ( 'Yes' ) : __ ( 'No' ),
'debug' => $users_can_register ,
),
'blog_public' => array (
'label' => __ ( 'Is this site discouraging search engines?' ),
'value' => $blog_public ? __ ( 'No' ) : __ ( 'Yes' ),
'debug' => $blog_public ,
),
'default_comment_status' => array (
'label' => __ ( 'Default comment status' ),
'value' => 'open' === $default_comment_status ? _x ( 'Open' , 'comment status' ) : _x ( 'Closed' , 'comment status' ),
'debug' => $default_comment_status ,
),
'environment_type' => array (
'label' => __ ( 'Environment type' ),
'value' => $environment_type ,
'debug' => $environment_type ,
),
);
// Conditionally add debug information for multisite setups.
if ( is_multisite () ) {
$site_id = get_current_blog_id ();
$fields [ 'site_id' ] = array (
'label' => __ ( 'Site ID' ),
'value' => $site_id ,
'debug' => $site_id ,
);
$network_query = new WP_Network_Query ();
$network_ids = $network_query -> query (
array (
'fields' => 'ids' ,
'number' => 100 ,
'no_found_rows' => false ,
)
);
$site_count = 0 ;
foreach ( $network_ids as $network_id ) {
$site_count += get_blog_count ( $network_id );
}
$fields [ 'site_count' ] = array (
'label' => __ ( 'Site count' ),
'value' => $site_count ,
);
$fields [ 'network_count' ] = array (
'label' => __ ( 'Network count' ),
'value' => $network_query -> found_networks ,
);
}
$fields [ 'user_count' ] = array (
'label' => __ ( 'User count' ),
'value' => get_user_count (),
);
// WordPress features requiring processing.
$wp_dotorg = wp_remote_get ( 'https://wordpress.org' , array ( 'timeout' => 10 ) );
if ( ! is_wp_error ( $wp_dotorg ) ) {
$fields [ 'dotorg_communication' ] = array (
'label' => __ ( 'Communication with WordPress.org' ),
'value' => __ ( 'WordPress.org is reachable' ),
'debug' => 'true' ,
);
} else {
$fields [ 'dotorg_communication' ] = array (
'label' => __ ( 'Communication with WordPress.org' ),
'value' => sprintf (
/* translators: 1: The IP address WordPress.org resolves to. 2: The error returned by the lookup. */
__ ( 'Unable to reach WordPress.org at %1$s: %2$s' ),
gethostbyname ( 'wordpress.org' ),
$wp_dotorg -> get_error_message ()
),
'debug' => $wp_dotorg -> get_error_message (),
);
}
return array (
'label' => __ ( 'WordPress' ),
'fields' => $fields ,
);
}
2024-09-27 01:58:18 -04:00
/**
* Gets the WordPress drop - in section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
2024-10-03 20:11:19 -04:00
private static function get_wp_dropins () : array {
2024-09-27 01:58:18 -04:00
// Get a list of all drop-in replacements.
$dropins = get_dropins ();
// Get drop-ins descriptions.
$dropin_descriptions = _get_dropins ();
$fields = array ();
foreach ( $dropins as $dropin_key => $dropin ) {
$fields [ sanitize_text_field ( $dropin_key ) ] = array (
'label' => $dropin_key ,
'value' => $dropin_descriptions [ $dropin_key ][ 0 ],
'debug' => 'true' ,
);
}
return array (
'label' => __ ( 'Drop-ins' ),
'show_count' => true ,
'description' => sprintf (
2024-09-27 12:37:18 -04:00
/* translators: %s: wp-content directory name. */
2024-09-27 01:58:18 -04:00
__ ( 'Drop-ins are single files, found in the %s directory, that replace or enhance WordPress features in ways that are not possible for traditional plugins.' ),
'<code>' . str_replace ( ABSPATH , '' , WP_CONTENT_DIR ) . '</code>'
),
'fields' => $fields ,
);
}
2024-09-09 20:04:19 -04:00
/**
* Gets the WordPress server section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
2024-10-03 20:11:19 -04:00
private static function get_wp_server () : array {
2024-09-09 20:04:19 -04:00
// Populate the server debug fields.
if ( function_exists ( 'php_uname' ) ) {
$server_architecture = sprintf ( '%s %s %s' , php_uname ( 's' ), php_uname ( 'r' ), php_uname ( 'm' ) );
} else {
$server_architecture = 'unknown' ;
}
$php_version_debug = PHP_VERSION ;
// Whether PHP supports 64-bit.
$php64bit = ( PHP_INT_SIZE * 8 === 64 );
$php_version = sprintf (
'%s %s' ,
$php_version_debug ,
( $php64bit ? __ ( '(Supports 64bit values)' ) : __ ( '(Does not support 64bit values)' ) )
);
if ( $php64bit ) {
$php_version_debug .= ' 64bit' ;
}
$fields = array ();
$fields [ 'server_architecture' ] = array (
'label' => __ ( 'Server architecture' ),
'value' => ( 'unknown' !== $server_architecture ? $server_architecture : __ ( 'Unable to determine server architecture' ) ),
'debug' => $server_architecture ,
);
$fields [ 'httpd_software' ] = array (
'label' => __ ( 'Web server' ),
'value' => ( isset ( $_SERVER [ 'SERVER_SOFTWARE' ] ) ? $_SERVER [ 'SERVER_SOFTWARE' ] : __ ( 'Unable to determine what web server software is used' ) ),
'debug' => ( isset ( $_SERVER [ 'SERVER_SOFTWARE' ] ) ? $_SERVER [ 'SERVER_SOFTWARE' ] : 'unknown' ),
);
$fields [ 'php_version' ] = array (
'label' => __ ( 'PHP version' ),
'value' => $php_version ,
'debug' => $php_version_debug ,
);
$fields [ 'php_sapi' ] = array (
'label' => __ ( 'PHP SAPI' ),
'value' => PHP_SAPI ,
'debug' => PHP_SAPI ,
);
// Some servers disable `ini_set()` and `ini_get()`, we check this before trying to get configuration values.
if ( ! function_exists ( 'ini_get' ) ) {
$fields [ 'ini_get' ] = array (
'label' => __ ( 'Server settings' ),
'value' => sprintf (
/* translators: %s: ini_get() */
__ ( 'Unable to determine some settings, as the %s function has been disabled.' ),
'ini_get()'
),
'debug' => 'ini_get() is disabled' ,
);
} else {
$fields [ 'max_input_variables' ] = array (
'label' => __ ( 'PHP max input variables' ),
'value' => ini_get ( 'max_input_vars' ),
);
$fields [ 'time_limit' ] = array (
'label' => __ ( 'PHP time limit' ),
'value' => ini_get ( 'max_execution_time' ),
);
if ( WP_Site_Health :: get_instance () -> php_memory_limit !== ini_get ( 'memory_limit' ) ) {
$fields [ 'memory_limit' ] = array (
'label' => __ ( 'PHP memory limit' ),
'value' => WP_Site_Health :: get_instance () -> php_memory_limit ,
);
$fields [ 'admin_memory_limit' ] = array (
'label' => __ ( 'PHP memory limit (only for admin screens)' ),
'value' => ini_get ( 'memory_limit' ),
);
} else {
$fields [ 'memory_limit' ] = array (
'label' => __ ( 'PHP memory limit' ),
'value' => ini_get ( 'memory_limit' ),
);
}
$fields [ 'max_input_time' ] = array (
'label' => __ ( 'Max input time' ),
'value' => ini_get ( 'max_input_time' ),
);
$fields [ 'upload_max_filesize' ] = array (
'label' => __ ( 'Upload max filesize' ),
'value' => ini_get ( 'upload_max_filesize' ),
);
$fields [ 'php_post_max_size' ] = array (
'label' => __ ( 'PHP post max size' ),
'value' => ini_get ( 'post_max_size' ),
);
}
if ( function_exists ( 'curl_version' ) ) {
$curl = curl_version ();
$fields [ 'curl_version' ] = array (
'label' => __ ( 'cURL version' ),
'value' => sprintf ( '%s %s' , $curl [ 'version' ], $curl [ 'ssl_version' ] ),
);
} else {
$fields [ 'curl_version' ] = array (
'label' => __ ( 'cURL version' ),
'value' => __ ( 'Not available' ),
'debug' => 'not available' ,
);
}
// SUHOSIN.
$suhosin_loaded = ( extension_loaded ( 'suhosin' ) || ( defined ( 'SUHOSIN_PATCH' ) && constant ( 'SUHOSIN_PATCH' ) ) );
$fields [ 'suhosin' ] = array (
'label' => __ ( 'Is SUHOSIN installed?' ),
'value' => ( $suhosin_loaded ? __ ( 'Yes' ) : __ ( 'No' ) ),
'debug' => $suhosin_loaded ,
);
// Imagick.
$imagick_loaded = extension_loaded ( 'imagick' );
$fields [ 'imagick_availability' ] = array (
'label' => __ ( 'Is the Imagick library available?' ),
'value' => ( $imagick_loaded ? __ ( 'Yes' ) : __ ( 'No' ) ),
'debug' => $imagick_loaded ,
);
// Pretty permalinks.
$pretty_permalinks_supported = got_url_rewrite ();
$fields [ 'pretty_permalinks' ] = array (
'label' => __ ( 'Are pretty permalinks supported?' ),
'value' => ( $pretty_permalinks_supported ? __ ( 'Yes' ) : __ ( 'No' ) ),
'debug' => $pretty_permalinks_supported ,
);
// Check if a .htaccess file exists.
if ( is_file ( ABSPATH . '.htaccess' ) ) {
// If the file exists, grab the content of it.
$htaccess_content = file_get_contents ( ABSPATH . '.htaccess' );
// Filter away the core WordPress rules.
$filtered_htaccess_content = trim ( preg_replace ( '/\# BEGIN WordPress[\s\S]+?# END WordPress/si' , '' , $htaccess_content ) );
$filtered_htaccess_content = ! empty ( $filtered_htaccess_content );
if ( $filtered_htaccess_content ) {
/* translators: %s: .htaccess */
$htaccess_rules_string = sprintf ( __ ( 'Custom rules have been added to your %s file.' ), '.htaccess' );
} else {
/* translators: %s: .htaccess */
$htaccess_rules_string = sprintf ( __ ( 'Your %s file contains only core WordPress features.' ), '.htaccess' );
}
$fields [ 'htaccess_extra_rules' ] = array (
'label' => __ ( '.htaccess rules' ),
'value' => $htaccess_rules_string ,
'debug' => $filtered_htaccess_content ,
);
}
// Server time.
$date = new DateTime ( 'now' , new DateTimeZone ( 'UTC' ) );
$fields [ 'current' ] = array (
'label' => __ ( 'Current time' ),
'value' => $date -> format ( DateTime :: ATOM ),
);
$fields [ 'utc-time' ] = array (
'label' => __ ( 'Current UTC time' ),
'value' => $date -> format ( DateTime :: RFC850 ),
);
$fields [ 'server-time' ] = array (
'label' => __ ( 'Current Server time' ),
'value' => wp_date ( 'c' , $_SERVER [ 'REQUEST_TIME' ] ),
);
return array (
'label' => __ ( 'Server' ),
'description' => __ ( 'The options shown below relate to your server setup. If changes are required, you may need your web host’s assistance.' ),
'fields' => $fields ,
);
}
2024-09-18 15:12:06 -04:00
/**
* Gets the WordPress media section of the debug data .
*
* @ since 6.7 . 0
*
* @ throws ImagickException
* @ return array
*/
2024-10-03 20:11:19 -04:00
private static function get_wp_media () : array {
2024-09-18 15:12:06 -04:00
// Spare few function calls.
$not_available = __ ( 'Not available' );
// Populate the media fields.
$fields [ 'image_editor' ] = array (
'label' => __ ( 'Active editor' ),
'value' => _wp_image_editor_choose (),
);
// Get ImageMagic information, if available.
if ( class_exists ( 'Imagick' ) ) {
// Save the Imagick instance for later use.
$imagick = new Imagick ();
$imagemagick_version = $imagick -> getVersion ();
} else {
$imagemagick_version = __ ( 'Not available' );
}
$fields [ 'imagick_module_version' ] = array (
'label' => __ ( 'ImageMagick version number' ),
'value' => ( is_array ( $imagemagick_version ) ? $imagemagick_version [ 'versionNumber' ] : $imagemagick_version ),
);
$fields [ 'imagemagick_version' ] = array (
'label' => __ ( 'ImageMagick version string' ),
'value' => ( is_array ( $imagemagick_version ) ? $imagemagick_version [ 'versionString' ] : $imagemagick_version ),
);
$imagick_version = phpversion ( 'imagick' );
$fields [ 'imagick_version' ] = array (
'label' => __ ( 'Imagick version' ),
'value' => ( $imagick_version ) ? $imagick_version : __ ( 'Not available' ),
);
if ( ! function_exists ( 'ini_get' ) ) {
$fields [ 'ini_get' ] = array (
'label' => __ ( 'File upload settings' ),
'value' => sprintf (
/* translators: %s: ini_get() */
__ ( 'Unable to determine some settings, as the %s function has been disabled.' ),
'ini_get()'
),
'debug' => 'ini_get() is disabled' ,
);
} else {
// Get the PHP ini directive values.
$file_uploads = ini_get ( 'file_uploads' );
$post_max_size = ini_get ( 'post_max_size' );
$upload_max_filesize = ini_get ( 'upload_max_filesize' );
$max_file_uploads = ini_get ( 'max_file_uploads' );
$effective = min ( wp_convert_hr_to_bytes ( $post_max_size ), wp_convert_hr_to_bytes ( $upload_max_filesize ) );
// Add info in Media section.
$fields [ 'file_uploads' ] = array (
'label' => __ ( 'File uploads' ),
'value' => $file_uploads ? __ ( 'Enabled' ) : __ ( 'Disabled' ),
'debug' => $file_uploads ,
);
$fields [ 'post_max_size' ] = array (
'label' => __ ( 'Max size of post data allowed' ),
'value' => $post_max_size ,
);
$fields [ 'upload_max_filesize' ] = array (
'label' => __ ( 'Max size of an uploaded file' ),
'value' => $upload_max_filesize ,
);
$fields [ 'max_effective_size' ] = array (
'label' => __ ( 'Max effective file size' ),
'value' => size_format ( $effective ),
);
$fields [ 'max_file_uploads' ] = array (
'label' => __ ( 'Max simultaneous file uploads' ),
'value' => $max_file_uploads ,
);
}
// If Imagick is used as our editor, provide some more information about its limitations.
if ( 'WP_Image_Editor_Imagick' === _wp_image_editor_choose () && isset ( $imagick ) && $imagick instanceof Imagick ) {
$limits = array (
'area' => ( defined ( 'imagick::RESOURCETYPE_AREA' ) ? size_format ( $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_AREA ) ) : $not_available ),
'disk' => ( defined ( 'imagick::RESOURCETYPE_DISK' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_DISK ) : $not_available ),
'file' => ( defined ( 'imagick::RESOURCETYPE_FILE' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_FILE ) : $not_available ),
'map' => ( defined ( 'imagick::RESOURCETYPE_MAP' ) ? size_format ( $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_MAP ) ) : $not_available ),
'memory' => ( defined ( 'imagick::RESOURCETYPE_MEMORY' ) ? size_format ( $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_MEMORY ) ) : $not_available ),
'thread' => ( defined ( 'imagick::RESOURCETYPE_THREAD' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_THREAD ) : $not_available ),
'time' => ( defined ( 'imagick::RESOURCETYPE_TIME' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_TIME ) : $not_available ),
);
$limits_debug = array (
'imagick::RESOURCETYPE_AREA' => ( defined ( 'imagick::RESOURCETYPE_AREA' ) ? size_format ( $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_AREA ) ) : 'not available' ),
'imagick::RESOURCETYPE_DISK' => ( defined ( 'imagick::RESOURCETYPE_DISK' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_DISK ) : 'not available' ),
'imagick::RESOURCETYPE_FILE' => ( defined ( 'imagick::RESOURCETYPE_FILE' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_FILE ) : 'not available' ),
'imagick::RESOURCETYPE_MAP' => ( defined ( 'imagick::RESOURCETYPE_MAP' ) ? size_format ( $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_MAP ) ) : 'not available' ),
'imagick::RESOURCETYPE_MEMORY' => ( defined ( 'imagick::RESOURCETYPE_MEMORY' ) ? size_format ( $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_MEMORY ) ) : 'not available' ),
'imagick::RESOURCETYPE_THREAD' => ( defined ( 'imagick::RESOURCETYPE_THREAD' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_THREAD ) : 'not available' ),
'imagick::RESOURCETYPE_TIME' => ( defined ( 'imagick::RESOURCETYPE_TIME' ) ? $imagick -> getResourceLimit ( imagick :: RESOURCETYPE_TIME ) : 'not available' ),
);
$fields [ 'imagick_limits' ] = array (
'label' => __ ( 'Imagick Resource Limits' ),
'value' => $limits ,
'debug' => $limits_debug ,
);
try {
$formats = Imagick :: queryFormats ( '*' );
} catch ( Exception $e ) {
$formats = array ();
}
$fields [ 'imagemagick_file_formats' ] = array (
'label' => __ ( 'ImageMagick supported file formats' ),
'value' => ( empty ( $formats ) ) ? __ ( 'Unable to determine' ) : implode ( ', ' , $formats ),
'debug' => ( empty ( $formats ) ) ? 'Unable to determine' : implode ( ', ' , $formats ),
);
}
// Get GD information, if available.
if ( function_exists ( 'gd_info' ) ) {
$gd = gd_info ();
} else {
$gd = false ;
}
$fields [ 'gd_version' ] = array (
'label' => __ ( 'GD version' ),
'value' => ( is_array ( $gd ) ? $gd [ 'GD Version' ] : $not_available ),
'debug' => ( is_array ( $gd ) ? $gd [ 'GD Version' ] : 'not available' ),
);
$gd_image_formats = array ();
$gd_supported_formats = array (
'GIF Create' => 'GIF' ,
'JPEG' => 'JPEG' ,
'PNG' => 'PNG' ,
'WebP' => 'WebP' ,
'BMP' => 'BMP' ,
'AVIF' => 'AVIF' ,
'HEIF' => 'HEIF' ,
'TIFF' => 'TIFF' ,
'XPM' => 'XPM' ,
);
foreach ( $gd_supported_formats as $format_key => $format ) {
$index = $format_key . ' Support' ;
if ( isset ( $gd [ $index ] ) && $gd [ $index ] ) {
array_push ( $gd_image_formats , $format );
}
}
if ( ! empty ( $gd_image_formats ) ) {
$fields [ 'gd_formats' ] = array (
'label' => __ ( 'GD supported file formats' ),
'value' => implode ( ', ' , $gd_image_formats ),
);
}
// Get Ghostscript information, if available.
if ( function_exists ( 'exec' ) ) {
$gs = exec ( 'gs --version' );
if ( empty ( $gs ) ) {
$gs = $not_available ;
$gs_debug = 'not available' ;
} else {
$gs_debug = $gs ;
}
} else {
$gs = __ ( 'Unable to determine if Ghostscript is installed' );
$gs_debug = 'unknown' ;
}
$fields [ 'ghostscript_version' ] = array (
'label' => __ ( 'Ghostscript version' ),
'value' => $gs ,
'debug' => $gs_debug ,
);
return array (
'label' => __ ( 'Media Handling' ),
'fields' => $fields ,
);
}
2024-09-11 10:47:20 -04:00
/**
* Gets the WordPress plugins section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
2024-10-03 20:11:19 -04:00
private static function get_wp_mu_plugins () : array {
2024-09-11 10:47:20 -04:00
// List must use plugins if there are any.
$mu_plugins = get_mu_plugins ();
2024-10-04 09:19:17 -04:00
$fields = array ();
2024-09-11 10:47:20 -04:00
foreach ( $mu_plugins as $plugin_path => $plugin ) {
$plugin_version = $plugin [ 'Version' ];
$plugin_author = $plugin [ 'Author' ];
$plugin_version_string = __ ( 'No version or author information is available.' );
$plugin_version_string_debug = 'author: (undefined), version: (undefined)' ;
if ( ! empty ( $plugin_version ) && ! empty ( $plugin_author ) ) {
/* translators: 1: Plugin version number. 2: Plugin author name. */
$plugin_version_string = sprintf ( __ ( 'Version %1$s by %2$s' ), $plugin_version , $plugin_author );
$plugin_version_string_debug = sprintf ( 'version: %s, author: %s' , $plugin_version , $plugin_author );
} else {
if ( ! empty ( $plugin_author ) ) {
/* translators: %s: Plugin author name. */
$plugin_version_string = sprintf ( __ ( 'By %s' ), $plugin_author );
$plugin_version_string_debug = sprintf ( 'author: %s, version: (undefined)' , $plugin_author );
}
if ( ! empty ( $plugin_version ) ) {
/* translators: %s: Plugin version number. */
$plugin_version_string = sprintf ( __ ( 'Version %s' ), $plugin_version );
$plugin_version_string_debug = sprintf ( 'author: (undefined), version: %s' , $plugin_version );
}
}
$fields [ sanitize_text_field ( $plugin [ 'Name' ] ) ] = array (
'label' => $plugin [ 'Name' ],
'value' => $plugin_version_string ,
'debug' => $plugin_version_string_debug ,
);
}
return array (
'label' => __ ( 'Must Use Plugins' ),
'show_count' => true ,
'fields' => $fields ,
);
}
2024-10-04 18:12:17 -04:00
/**
* Gets the WordPress active plugins section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
private static function get_wp_plugins_active () : array {
return array (
'label' => __ ( 'Active Plugins' ),
'show_count' => true ,
'fields' => self :: get_wp_plugins_raw_data ()[ 'wp-plugins-active' ],
);
}
/**
* Gets the WordPress inactive plugins section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
private static function get_wp_plugins_inactive () : array {
return array (
'label' => __ ( 'Inactive Plugins' ),
'show_count' => true ,
'fields' => self :: get_wp_plugins_raw_data ()[ 'wp-plugins-inactive' ],
);
}
/**
* Gets the raw plugin data for the WordPress active and inactive sections of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
private static function get_wp_plugins_raw_data () : array {
// List all available plugins.
$plugins = get_plugins ();
$plugin_updates = get_plugin_updates ();
$transient = get_site_transient ( 'update_plugins' );
$auto_updates = array ();
$fields = array (
'wp-plugins-active' => array (),
'wp-plugins-inactive' => array (),
);
$auto_updates_enabled = wp_is_auto_update_enabled_for_type ( 'plugin' );
if ( $auto_updates_enabled ) {
$auto_updates = ( array ) get_site_option ( 'auto_update_plugins' , array () );
}
foreach ( $plugins as $plugin_path => $plugin ) {
$plugin_part = ( is_plugin_active ( $plugin_path ) ) ? 'wp-plugins-active' : 'wp-plugins-inactive' ;
$plugin_version = $plugin [ 'Version' ];
$plugin_author = $plugin [ 'Author' ];
$plugin_version_string = __ ( 'No version or author information is available.' );
$plugin_version_string_debug = 'author: (undefined), version: (undefined)' ;
if ( ! empty ( $plugin_version ) && ! empty ( $plugin_author ) ) {
/* translators: 1: Plugin version number. 2: Plugin author name. */
$plugin_version_string = sprintf ( __ ( 'Version %1$s by %2$s' ), $plugin_version , $plugin_author );
$plugin_version_string_debug = sprintf ( 'version: %s, author: %s' , $plugin_version , $plugin_author );
} else {
if ( ! empty ( $plugin_author ) ) {
/* translators: %s: Plugin author name. */
$plugin_version_string = sprintf ( __ ( 'By %s' ), $plugin_author );
$plugin_version_string_debug = sprintf ( 'author: %s, version: (undefined)' , $plugin_author );
}
if ( ! empty ( $plugin_version ) ) {
/* translators: %s: Plugin version number. */
$plugin_version_string = sprintf ( __ ( 'Version %s' ), $plugin_version );
$plugin_version_string_debug = sprintf ( 'author: (undefined), version: %s' , $plugin_version );
}
}
if ( array_key_exists ( $plugin_path , $plugin_updates ) ) {
/* translators: %s: Latest plugin version number. */
$plugin_version_string .= ' ' . sprintf ( __ ( '(Latest version: %s)' ), $plugin_updates [ $plugin_path ] -> update -> new_version );
$plugin_version_string_debug .= sprintf ( ' (latest version: %s)' , $plugin_updates [ $plugin_path ] -> update -> new_version );
}
if ( $auto_updates_enabled ) {
if ( isset ( $transient -> response [ $plugin_path ] ) ) {
$item = $transient -> response [ $plugin_path ];
} elseif ( isset ( $transient -> no_update [ $plugin_path ] ) ) {
$item = $transient -> no_update [ $plugin_path ];
} else {
$item = array (
'id' => $plugin_path ,
'slug' => '' ,
'plugin' => $plugin_path ,
'new_version' => '' ,
'url' => '' ,
'package' => '' ,
'icons' => array (),
'banners' => array (),
'banners_rtl' => array (),
'tested' => '' ,
'requires_php' => '' ,
'compatibility' => new stdClass (),
);
$item = wp_parse_args ( $plugin , $item );
}
$auto_update_forced = wp_is_auto_update_forced_for_item ( 'plugin' , null , ( object ) $item );
if ( ! is_null ( $auto_update_forced ) ) {
$enabled = $auto_update_forced ;
} else {
$enabled = in_array ( $plugin_path , $auto_updates , true );
}
if ( $enabled ) {
$auto_updates_string = __ ( 'Auto-updates enabled' );
} else {
$auto_updates_string = __ ( 'Auto-updates disabled' );
}
/**
* Filters the text string of the auto - updates setting for each plugin in the Site Health debug data .
*
* @ since 5.5 . 0
*
* @ param string $auto_updates_string The string output for the auto - updates column .
* @ param string $plugin_path The path to the plugin file .
* @ param array $plugin An array of plugin data .
* @ param bool $enabled Whether auto - updates are enabled for this item .
*/
$auto_updates_string = apply_filters ( 'plugin_auto_update_debug_string' , $auto_updates_string , $plugin_path , $plugin , $enabled );
$plugin_version_string .= ' | ' . $auto_updates_string ;
$plugin_version_string_debug .= ', ' . $auto_updates_string ;
}
$fields [ $plugin_part ][ sanitize_text_field ( $plugin [ 'Name' ] ) ] = array (
'label' => $plugin [ 'Name' ],
'value' => $plugin_version_string ,
'debug' => $plugin_version_string_debug ,
);
}
return $fields ;
}
2024-08-05 17:39:11 -04:00
/**
* Gets the WordPress constants section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
2024-10-03 20:11:19 -04:00
private static function get_wp_constants () : array {
2024-08-05 17:39:11 -04:00
// Check if WP_DEBUG_LOG is set.
$wp_debug_log_value = __ ( 'Disabled' );
if ( is_string ( WP_DEBUG_LOG ) ) {
$wp_debug_log_value = WP_DEBUG_LOG ;
} elseif ( WP_DEBUG_LOG ) {
$wp_debug_log_value = __ ( 'Enabled' );
}
// Check CONCATENATE_SCRIPTS.
if ( defined ( 'CONCATENATE_SCRIPTS' ) ) {
$concatenate_scripts = CONCATENATE_SCRIPTS ? __ ( 'Enabled' ) : __ ( 'Disabled' );
$concatenate_scripts_debug = CONCATENATE_SCRIPTS ? 'true' : 'false' ;
} else {
$concatenate_scripts = __ ( 'Undefined' );
$concatenate_scripts_debug = 'undefined' ;
}
// Check COMPRESS_SCRIPTS.
if ( defined ( 'COMPRESS_SCRIPTS' ) ) {
$compress_scripts = COMPRESS_SCRIPTS ? __ ( 'Enabled' ) : __ ( 'Disabled' );
$compress_scripts_debug = COMPRESS_SCRIPTS ? 'true' : 'false' ;
} else {
$compress_scripts = __ ( 'Undefined' );
$compress_scripts_debug = 'undefined' ;
}
// Check COMPRESS_CSS.
if ( defined ( 'COMPRESS_CSS' ) ) {
$compress_css = COMPRESS_CSS ? __ ( 'Enabled' ) : __ ( 'Disabled' );
$compress_css_debug = COMPRESS_CSS ? 'true' : 'false' ;
} else {
$compress_css = __ ( 'Undefined' );
$compress_css_debug = 'undefined' ;
}
// Check WP_ENVIRONMENT_TYPE.
2024-10-01 13:59:17 -04:00
if ( defined ( 'WP_ENVIRONMENT_TYPE' ) ) {
$wp_environment_type = WP_ENVIRONMENT_TYPE ? WP_ENVIRONMENT_TYPE : __ ( 'Empty value' );
$wp_environment_type_debug = WP_ENVIRONMENT_TYPE ;
2024-08-05 17:39:11 -04:00
} else {
2024-10-01 13:59:17 -04:00
$wp_environment_type = __ ( 'Undefined' );
$wp_environment_type_debug = 'undefined' ;
2024-08-05 17:39:11 -04:00
}
2024-09-30 21:12:17 -04:00
// Check DB_COLLATE.
2024-10-01 13:59:17 -04:00
if ( defined ( 'DB_COLLATE' ) ) {
$db_collate = DB_COLLATE ? DB_COLLATE : __ ( 'Empty value' );
$db_collate_debug = DB_COLLATE ;
2024-09-30 21:12:17 -04:00
} else {
2024-10-01 13:59:17 -04:00
$db_collate = __ ( 'Undefined' );
$db_collate_debug = 'undefined' ;
2024-09-30 21:12:17 -04:00
}
2024-08-05 17:39:11 -04:00
$fields = array (
'ABSPATH' => array (
'label' => 'ABSPATH' ,
'value' => ABSPATH ,
'private' => true ,
),
'WP_HOME' => array (
'label' => 'WP_HOME' ,
'value' => ( defined ( 'WP_HOME' ) ? WP_HOME : __ ( 'Undefined' ) ),
'debug' => ( defined ( 'WP_HOME' ) ? WP_HOME : 'undefined' ),
),
'WP_SITEURL' => array (
'label' => 'WP_SITEURL' ,
'value' => ( defined ( 'WP_SITEURL' ) ? WP_SITEURL : __ ( 'Undefined' ) ),
'debug' => ( defined ( 'WP_SITEURL' ) ? WP_SITEURL : 'undefined' ),
),
'WP_CONTENT_DIR' => array (
'label' => 'WP_CONTENT_DIR' ,
'value' => WP_CONTENT_DIR ,
),
'WP_PLUGIN_DIR' => array (
'label' => 'WP_PLUGIN_DIR' ,
'value' => WP_PLUGIN_DIR ,
),
'WP_MEMORY_LIMIT' => array (
'label' => 'WP_MEMORY_LIMIT' ,
'value' => WP_MEMORY_LIMIT ,
),
'WP_MAX_MEMORY_LIMIT' => array (
'label' => 'WP_MAX_MEMORY_LIMIT' ,
'value' => WP_MAX_MEMORY_LIMIT ,
),
'WP_DEBUG' => array (
'label' => 'WP_DEBUG' ,
'value' => WP_DEBUG ? __ ( 'Enabled' ) : __ ( 'Disabled' ),
'debug' => WP_DEBUG ,
),
'WP_DEBUG_DISPLAY' => array (
'label' => 'WP_DEBUG_DISPLAY' ,
'value' => WP_DEBUG_DISPLAY ? __ ( 'Enabled' ) : __ ( 'Disabled' ),
'debug' => WP_DEBUG_DISPLAY ,
),
'WP_DEBUG_LOG' => array (
'label' => 'WP_DEBUG_LOG' ,
'value' => $wp_debug_log_value ,
'debug' => WP_DEBUG_LOG ,
),
'SCRIPT_DEBUG' => array (
'label' => 'SCRIPT_DEBUG' ,
'value' => SCRIPT_DEBUG ? __ ( 'Enabled' ) : __ ( 'Disabled' ),
'debug' => SCRIPT_DEBUG ,
),
'WP_CACHE' => array (
'label' => 'WP_CACHE' ,
'value' => WP_CACHE ? __ ( 'Enabled' ) : __ ( 'Disabled' ),
'debug' => WP_CACHE ,
),
'CONCATENATE_SCRIPTS' => array (
'label' => 'CONCATENATE_SCRIPTS' ,
'value' => $concatenate_scripts ,
'debug' => $concatenate_scripts_debug ,
),
'COMPRESS_SCRIPTS' => array (
'label' => 'COMPRESS_SCRIPTS' ,
'value' => $compress_scripts ,
'debug' => $compress_scripts_debug ,
),
'COMPRESS_CSS' => array (
'label' => 'COMPRESS_CSS' ,
'value' => $compress_css ,
'debug' => $compress_css_debug ,
),
'WP_ENVIRONMENT_TYPE' => array (
'label' => 'WP_ENVIRONMENT_TYPE' ,
'value' => $wp_environment_type ,
2024-10-01 13:59:17 -04:00
'debug' => $wp_environment_type_debug ,
2024-08-05 17:39:11 -04:00
),
'WP_DEVELOPMENT_MODE' => array (
'label' => 'WP_DEVELOPMENT_MODE' ,
'value' => WP_DEVELOPMENT_MODE ? WP_DEVELOPMENT_MODE : __ ( 'Disabled' ),
'debug' => WP_DEVELOPMENT_MODE ,
),
'DB_CHARSET' => array (
'label' => 'DB_CHARSET' ,
'value' => ( defined ( 'DB_CHARSET' ) ? DB_CHARSET : __ ( 'Undefined' ) ),
'debug' => ( defined ( 'DB_CHARSET' ) ? DB_CHARSET : 'undefined' ),
),
'DB_COLLATE' => array (
'label' => 'DB_COLLATE' ,
2024-10-01 13:59:17 -04:00
'value' => $db_collate ,
'debug' => $db_collate_debug ,
2024-08-05 17:39:11 -04:00
),
);
return array (
'label' => __ ( 'WordPress Constants' ),
'description' => __ ( 'These settings alter where and how parts of WordPress are loaded.' ),
'fields' => $fields ,
);
}
2024-09-02 16:44:16 -04:00
/**
* Gets the WordPress database section of the debug data .
*
* @ since 6.7 . 0
*
* @ global wpdb $wpdb WordPress database abstraction object .
*
* @ return array
*/
2024-10-03 20:11:19 -04:00
private static function get_wp_database () : array {
2024-09-02 16:44:16 -04:00
global $wpdb ;
// Populate the database debug fields.
if ( is_object ( $wpdb -> dbh ) ) {
// mysqli or PDO.
$extension = get_class ( $wpdb -> dbh );
} else {
// Unknown sql extension.
$extension = null ;
}
$server = $wpdb -> get_var ( 'SELECT VERSION()' );
$client_version = $wpdb -> dbh -> client_info ;
$fields = array (
'extension' => array (
'label' => __ ( 'Database Extension' ),
'value' => $extension ,
),
'server_version' => array (
'label' => __ ( 'Server version' ),
'value' => $server ,
),
'client_version' => array (
'label' => __ ( 'Client version' ),
'value' => $client_version ,
),
'database_user' => array (
'label' => __ ( 'Database username' ),
'value' => $wpdb -> dbuser ,
'private' => true ,
),
'database_host' => array (
'label' => __ ( 'Database host' ),
'value' => $wpdb -> dbhost ,
'private' => true ,
),
'database_name' => array (
'label' => __ ( 'Database name' ),
'value' => $wpdb -> dbname ,
'private' => true ,
),
'database_prefix' => array (
'label' => __ ( 'Table prefix' ),
'value' => $wpdb -> prefix ,
'private' => true ,
),
'database_charset' => array (
'label' => __ ( 'Database charset' ),
'value' => $wpdb -> charset ,
'private' => true ,
),
'database_collate' => array (
'label' => __ ( 'Database collation' ),
'value' => $wpdb -> collate ,
'private' => true ,
),
'max_allowed_packet' => array (
'label' => __ ( 'Max allowed packet size' ),
'value' => self :: get_mysql_var ( 'max_allowed_packet' ),
),
'max_connections' => array (
'label' => __ ( 'Max connections number' ),
'value' => self :: get_mysql_var ( 'max_connections' ),
),
);
return array (
'label' => __ ( 'Database' ),
'fields' => $fields ,
);
}
2024-07-29 14:22:12 -04:00
/**
* Gets the file system section of the debug data .
*
* @ since 6.7 . 0
*
* @ return array
*/
private static function get_wp_filesystem () : array {
$upload_dir = wp_upload_dir ();
$is_writable_abspath = wp_is_writable ( ABSPATH );
$is_writable_wp_content_dir = wp_is_writable ( WP_CONTENT_DIR );
$is_writable_upload_dir = wp_is_writable ( $upload_dir [ 'basedir' ] );
$is_writable_wp_plugin_dir = wp_is_writable ( WP_PLUGIN_DIR );
$is_writable_template_directory = wp_is_writable ( get_theme_root ( get_template () ) );
$is_writable_fonts_dir = wp_is_writable ( wp_get_font_dir ()[ 'basedir' ] );
$fields = array (
'wordpress' => array (
'label' => __ ( 'The main WordPress directory' ),
'value' => ( $is_writable_abspath ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_abspath ? 'writable' : 'not writable' ),
),
'wp-content' => array (
'label' => __ ( 'The wp-content directory' ),
'value' => ( $is_writable_wp_content_dir ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_wp_content_dir ? 'writable' : 'not writable' ),
),
'uploads' => array (
'label' => __ ( 'The uploads directory' ),
'value' => ( $is_writable_upload_dir ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_upload_dir ? 'writable' : 'not writable' ),
),
'plugins' => array (
'label' => __ ( 'The plugins directory' ),
'value' => ( $is_writable_wp_plugin_dir ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_wp_plugin_dir ? 'writable' : 'not writable' ),
),
'themes' => array (
'label' => __ ( 'The themes directory' ),
'value' => ( $is_writable_template_directory ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_template_directory ? 'writable' : 'not writable' ),
),
'fonts' => array (
'label' => __ ( 'The fonts directory' ),
'value' => ( $is_writable_fonts_dir ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_fonts_dir ? 'writable' : 'not writable' ),
),
);
// Add more filesystem checks.
if ( defined ( 'WPMU_PLUGIN_DIR' ) && is_dir ( WPMU_PLUGIN_DIR ) ) {
$is_writable_wpmu_plugin_dir = wp_is_writable ( WPMU_PLUGIN_DIR );
$fields [ 'mu-plugins' ] = array (
'label' => __ ( 'The must use plugins directory' ),
'value' => ( $is_writable_wpmu_plugin_dir ? __ ( 'Writable' ) : __ ( 'Not writable' ) ),
'debug' => ( $is_writable_wpmu_plugin_dir ? 'writable' : 'not writable' ),
);
}
return array (
'label' => __ ( 'Filesystem Permissions' ),
'description' => __ ( 'Shows whether WordPress is able to write to the directories it needs access to.' ),
'fields' => $fields ,
);
}
2021-08-01 10:02:00 -04:00
/**
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
* Returns the value of a MySQL system variable .
2021-08-01 10:02:00 -04:00
*
* @ since 5.9 . 0
*
2021-08-01 10:04:56 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
* @ param string $mysql_var Name of the MySQL system variable .
2021-08-01 10:02:00 -04:00
* @ return string | null The variable value on success . Null if the variable does not exist .
*/
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
public static function get_mysql_var ( $mysql_var ) {
2021-08-01 10:02:00 -04:00
global $wpdb ;
$result = $wpdb -> get_row (
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
$wpdb -> prepare ( 'SHOW VARIABLES LIKE %s' , $mysql_var ),
2021-08-01 10:02:00 -04:00
ARRAY_A
);
if ( ! empty ( $result ) && array_key_exists ( 'Value' , $result ) ) {
return $result [ 'Value' ];
}
return null ;
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
/**
2022-09-09 04:47:08 -04:00
* Formats the information gathered for debugging , in a manner suitable for copying to a forum or support ticket .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
* @ since 5.2 . 0
*
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
* @ param array $info_array Information gathered from the `WP_Debug_Data::debug_data()` function .
* @ param string $data_type The data type to return , either 'info' or 'debug' .
2019-03-27 18:31:52 -04:00
* @ return string The formatted data .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*/
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
public static function format ( $info_array , $data_type ) {
2019-04-06 11:36:51 -04:00
$return = " ` \n " ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
foreach ( $info_array as $section => $details ) {
// Skip this section if there are no fields, or the section has been declared as private.
if ( empty ( $details [ 'fields' ] ) || ( isset ( $details [ 'private' ] ) && $details [ 'private' ] ) ) {
continue ;
}
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
$section_label = 'debug' === $data_type ? $section : $details [ 'label' ];
2019-04-10 01:07:51 -04:00
2019-03-27 18:31:52 -04:00
$return .= sprintf (
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
" ### %s%s ### \n \n " ,
2019-04-10 01:07:51 -04:00
$section_label ,
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
( isset ( $details [ 'show_count' ] ) && $details [ 'show_count' ] ? sprintf ( ' (%d)' , count ( $details [ 'fields' ] ) ) : '' )
);
2019-04-10 01:07:51 -04:00
foreach ( $details [ 'fields' ] as $field_name => $field ) {
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
if ( isset ( $field [ 'private' ] ) && true === $field [ 'private' ] ) {
continue ;
}
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
if ( 'debug' === $data_type && isset ( $field [ 'debug' ] ) ) {
2019-04-10 01:07:51 -04:00
$debug_data = $field [ 'debug' ];
} else {
$debug_data = $field [ 'value' ];
}
// Can be array, one level deep only.
if ( is_array ( $debug_data ) ) {
$value = '' ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
2019-04-18 12:26:51 -04:00
foreach ( $debug_data as $sub_field_name => $sub_field_value ) {
$value .= sprintf ( " \n \t %s: %s " , $sub_field_name , $sub_field_value );
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
2019-04-10 01:07:51 -04:00
} elseif ( is_bool ( $debug_data ) ) {
$value = $debug_data ? 'true' : 'false' ;
} elseif ( empty ( $debug_data ) && '0' !== $debug_data ) {
$value = 'undefined' ;
} else {
$value = $debug_data ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/class-wp-debug-data.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit renames the `$var` parameter to `$mysql_var` in `WP_Debug_Data::get_mysql_var()`.
Additionally, `$type` is renamed to `$data_type` in `WP_Debug_Data::format()` for clarity.
Follow-up to [51522], [52946], [52996], [52997], [52998].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53003
git-svn-id: http://core.svn.wordpress.org/trunk@52592 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-28 09:24:01 -04:00
if ( 'debug' === $data_type ) {
2019-04-10 01:07:51 -04:00
$label = $field_name ;
} else {
$label = $field [ 'label' ];
}
$return .= sprintf ( " %s: %s \n " , $label , $value );
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
2019-04-10 01:07:51 -04:00
2019-03-27 18:31:52 -04:00
$return .= " \n " ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
2019-03-27 18:31:52 -04:00
2019-04-06 12:02:52 -04:00
$return .= '`' ;
2019-04-06 11:36:51 -04:00
2019-03-27 18:31:52 -04:00
return $return ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
/**
2022-09-09 04:47:08 -04:00
* Fetches the total size of all the database tables for the active database user .
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
*
* @ since 5.2 . 0
*
2022-12-09 06:54:13 -05:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
* @ return int The size of the database , in bytes .
*/
public static function get_database_size () {
global $wpdb ;
$size = 0 ;
$rows = $wpdb -> get_results ( 'SHOW TABLE STATUS' , ARRAY_A );
if ( $wpdb -> num_rows > 0 ) {
foreach ( $rows as $row ) {
$size += $row [ 'Data_length' ] + $row [ 'Index_length' ];
}
}
2019-04-02 19:33:53 -04:00
return ( int ) $size ;
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}
2019-04-12 15:24:51 -04:00
/**
2022-09-09 04:47:08 -04:00
* Fetches the sizes of the WordPress directories : `wordpress` ( ABSPATH ), `plugins` , `themes` , and `uploads` .
2019-04-12 15:24:51 -04:00
* Intended to supplement the array returned by `WP_Debug_Data::debug_data()` .
*
* @ since 5.2 . 0
*
* @ return array The sizes of the directories , also the database size and total installation size .
*/
public static function get_sizes () {
$size_db = self :: get_database_size ();
$upload_dir = wp_get_upload_dir ();
/*
* We will be using the PHP max execution time to prevent the size calculations
* from causing a timeout . The default value is 30 seconds , and some
* hosts do not allow you to read configuration values .
*/
if ( function_exists ( 'ini_get' ) ) {
$max_execution_time = ini_get ( 'max_execution_time' );
}
2023-07-09 15:52:24 -04:00
/*
* The max_execution_time defaults to 0 when PHP runs from cli .
* We still want to limit it below .
*/
2019-04-12 15:24:51 -04:00
if ( empty ( $max_execution_time ) ) {
Coding Standards: Clarify time units for various timeout or expiration values.
This changeset implements a clearer and more consistent timeout/duration/expiration format. It updates time durations used in various files, as per WordPress coding standards:
- If the value can be represented as an integer (not a fractional) number of minutes (hours, etc.), use the appropriate constant (e.g.: `MINUTE_IN_SECONDS`) multiplied by that number.
- Otherwise, keep the value as is and add a comment with the units for clarity.
Follow-up to [11823], [13177], [21996], [37747], [53714].
Props hztyfoon, audrasjb, arrasel403, krupalpanchal, GaryJ, SergeyBiryukov, peterwilsoncc, rudlinkon, costdev, robinwpdeveloper.
Fixes #56293.
See #55647.
Built from https://develop.svn.wordpress.org/trunk@54113
git-svn-id: http://core.svn.wordpress.org/trunk@53672 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-09 04:16:18 -04:00
$max_execution_time = 30 ; // 30 seconds.
2019-04-12 15:24:51 -04:00
}
if ( $max_execution_time > 20 ) {
2023-07-09 15:52:24 -04:00
/*
* If the max_execution_time is set to lower than 20 seconds , reduce it a bit to prevent
* edge - case timeouts that may happen after the size loop has finished running .
*/
2019-04-12 15:24:51 -04:00
$max_execution_time -= 2 ;
}
2023-07-09 15:52:24 -04:00
/*
* Go through the various installation directories and calculate their sizes .
* No trailing slashes .
*/
2019-04-16 19:02:51 -04:00
$paths = array (
'wordpress_size' => untrailingslashit ( ABSPATH ),
'themes_size' => get_theme_root (),
'plugins_size' => WP_PLUGIN_DIR ,
'uploads_size' => $upload_dir [ 'basedir' ],
Site Health: Add fonts upload location to Site Health report.
Just like Site Health lists the paths to the plugins/themes/uploads directories, this changeset adds the path to the fonts directory (and its size).
Props swissspidy, andr3ribeiro, krupajnanda, ironprogrammer, iamfarhan09, naeemhaque, imasikur22, tofajjal02, sarkarripon, prottoysarkar, zunaid321, imranhasanraaz, rajinsharwar, nazmul111, audrasjb, peterwilsoncc.
Fixes #60719.
Built from https://develop.svn.wordpress.org/trunk@58299
git-svn-id: http://core.svn.wordpress.org/trunk@57759 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2024-06-03 12:56:16 -04:00
'fonts_size' => wp_get_font_dir ()[ 'basedir' ],
2019-04-12 15:24:51 -04:00
);
2019-04-16 19:02:51 -04:00
$exclude = $paths ;
unset ( $exclude [ 'wordpress_size' ] );
$exclude = array_values ( $exclude );
2019-04-12 15:24:51 -04:00
$size_total = 0 ;
2019-04-16 19:02:51 -04:00
$all_sizes = array ();
2019-04-12 15:24:51 -04:00
// Loop over all the directories we want to gather the sizes for.
2019-04-16 19:02:51 -04:00
foreach ( $paths as $name => $path ) {
2019-04-12 15:24:51 -04:00
$dir_size = null ; // Default to timeout.
2019-04-16 19:02:51 -04:00
$results = array (
'path' => $path ,
'raw' => 0 ,
);
2019-04-12 15:24:51 -04:00
2024-08-12 00:54:15 -04:00
// If the directory does not exist, skip checking it, as it will skew the other results.
if ( ! is_dir ( $path ) ) {
$all_sizes [ $name ] = array (
'path' => $path ,
'raw' => 0 ,
'size' => __ ( 'The directory does not exist.' ),
'debug' => 'directory not found' ,
);
continue ;
}
2019-04-12 15:24:51 -04:00
if ( microtime ( true ) - WP_START_TIMESTAMP < $max_execution_time ) {
2019-04-16 19:02:51 -04:00
if ( 'wordpress_size' === $name ) {
$dir_size = recurse_dirsize ( $path , $exclude , $max_execution_time );
} else {
$dir_size = recurse_dirsize ( $path , null , $max_execution_time );
}
2019-04-12 15:24:51 -04:00
}
if ( false === $dir_size ) {
// Error reading.
2019-04-16 19:02:51 -04:00
$results [ 'size' ] = __ ( 'The size cannot be calculated. The directory is not accessible. Usually caused by invalid permissions.' );
$results [ 'debug' ] = 'not accessible' ;
2019-04-12 15:24:51 -04:00
// Stop total size calculation.
$size_total = null ;
} elseif ( null === $dir_size ) {
// Timeout.
2019-04-16 19:02:51 -04:00
$results [ 'size' ] = __ ( 'The directory size calculation has timed out. Usually caused by a very large number of sub-directories and files.' );
$results [ 'debug' ] = 'timeout while calculating size' ;
2019-04-12 15:24:51 -04:00
// Stop total size calculation.
$size_total = null ;
} else {
2019-04-16 19:02:51 -04:00
if ( null !== $size_total ) {
2019-04-12 15:24:51 -04:00
$size_total += $dir_size ;
}
2019-04-16 19:02:51 -04:00
$results [ 'raw' ] = $dir_size ;
$results [ 'size' ] = size_format ( $dir_size , 2 );
$results [ 'debug' ] = $results [ 'size' ] . " ( { $dir_size } bytes) " ;
2019-04-12 15:24:51 -04:00
}
2019-04-16 19:02:51 -04:00
$all_sizes [ $name ] = $results ;
2019-04-12 15:24:51 -04:00
}
if ( $size_db > 0 ) {
$database_size = size_format ( $size_db , 2 );
$all_sizes [ 'database_size' ] = array (
2019-04-16 19:02:51 -04:00
'raw' => $size_db ,
2019-04-12 15:24:51 -04:00
'size' => $database_size ,
2019-04-16 19:02:51 -04:00
'debug' => $database_size . " ( { $size_db } bytes) " ,
2019-04-12 15:24:51 -04:00
);
} else {
$all_sizes [ 'database_size' ] = array (
'size' => __ ( 'Not available' ),
'debug' => 'not available' ,
);
}
if ( null !== $size_total && $size_db > 0 ) {
2019-04-16 20:45:50 -04:00
$total_size = $size_total + $size_db ;
2019-04-16 19:02:51 -04:00
$total_size_mb = size_format ( $total_size , 2 );
2019-04-12 15:24:51 -04:00
$all_sizes [ 'total_size' ] = array (
2019-04-16 19:02:51 -04:00
'raw' => $total_size ,
'size' => $total_size_mb ,
'debug' => $total_size_mb . " ( { $total_size } bytes) " ,
2019-04-12 15:24:51 -04:00
);
} else {
$all_sizes [ 'total_size' ] = array (
'size' => __ ( 'Total size is not available. Some errors were encountered when determining the size of your installation.' ),
'debug' => 'not available' ,
);
}
return $all_sizes ;
}
Admin: Introduce the Site Health screens.
The Site Health tool serves two purposes:
- Provide site owners with information to improve the performance, reliability, and security of their site.
- Collect comprehensive debug information about the site.
By encouraging site owners to maintain their site and adhere to modern best practices, we ultimately improve the software hygeine of both the WordPress ecosystem, and the open internet as a whole.
Props Clorith, hedgefield, melchoyce, xkon, karmatosed, jordesign, earnjam, ianbelanger, wpscholar, desrosj, pedromendonca, peterbooker, jcastaneda, garyj, soean, pento, timothyblynjacobs, zodiac1978, dgroddick, garrett-eclipse, netweb, tobifjellner, pixolin, afercia, joedolson, birgire.
See #46573.
Built from https://develop.svn.wordpress.org/trunk@44986
git-svn-id: http://core.svn.wordpress.org/trunk@44817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-03-22 23:55:53 -04:00
}