WordPress-C
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Docs: Further update the `debug_information` filter description per the documentation standards. 

Specifically, this ensures that the DocBlock follows the line wrapping recommendations.

Follow-up to [44986], [45156], [45259], [51949].

See #53399.
Built from https://develop.svn.wordpress.org/trunk@51956


git-svn-id: http://core.svn.wordpress.org/trunk@51545 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2021-10-30 13:41:02 +00:00
parent 6babc3833b
commit 4459eaf392
2 changed files with 34 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
wp-admin/includes/class-wp-debug-data.php
View File

@ -1410,48 +1410,58 @@ class WP_Debug_Data {
/** /**
* Add to or modify the debug information shown on the Tools -> Site Health -> Info screen. * Add to or modify the debug information shown on the Tools -> Site Health -> Info screen.
* *
* Plugin or themes may wish to introduce their own debug information without creating additional admin pages * Plugin or themes may wish to introduce their own debug information without creating
* they can utilize this filter to introduce their own sections or add more data to existing sections. * additional admin pages. They can utilize this filter to introduce their own sections
* or add more data to existing sections.
* *
* Array keys for sections added by core are all prefixed with `wp-`, plugins and themes should use their own slug as * Array keys for sections added by core are all prefixed with `wp-`. Plugins and themes
* a prefix, both for consistency as well as avoiding key collisions. Note that the array keys are used as labels * should use their own slug as a prefix, both for consistency as well as avoiding
* for the copied data. * key collisions. Note that the array keys are used as labels for the copied data.
* *
* All strings are expected to be plain text except `$description` that can contain inline HTML tags (see below). * All strings are expected to be plain text except `$description` that can contain
* inline HTML tags (see below).
* *
* @since 5.2.0 * @since 5.2.0
* *
* @param array $args { * @param array $args {
* The debug information to be added to the core information page. * The debug information to be added to the core information page.
* *
* This is an associative multi-dimensional array, up to three levels deep. The topmost array holds the sections, keyed by section ID. * This is an associative multi-dimensional array, up to three levels deep.
* The topmost array holds the sections, keyed by section ID.
* *
* @type array ...$0 { * @type array ...$0 {
* Each section has a `$fields` associative array (see below), and each `$value` in `$fields` can be * Each section has a `$fields` associative array (see below), and each `$value` in `$fields`
* another associative array of name/value pairs when there is more structured data to display. * can be another associative array of name/value pairs when there is more structured data
* to display.
* *
* @type string $label Required. The title for this section of the debug output. * @type string $label Required. The title for this section of the debug output.
* @type string $description Optional. A description for your information section which may contain basic HTML * @type string $description Optional. A description for your information section which
* markup, inline tags only as it is outputted in a paragraph. * may contain basic HTML markup, inline tags only as it is
* @type bool $show_count Optional. If set to `true` the amount of fields will be included in the title for * outputted in a paragraph.
* this section. * @type bool $show_count Optional. If set to `true`, the amount of fields will be included
* @type bool $private Optional. If set to `true` the section and all associated fields will be excluded * in the title for this section. Default false.
* from the copied data. 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.
* @type array $fields { * @type array $fields {
* Required. An associative array containing the fields to be displayed in the section, keyed by field ID. * Required. An associative array containing the fields to be displayed in the section,
* keyed by field ID.
* *
* @type array ...$0 { * @type array ...$0 {
* An associative array containing the data to be displayed for the field. * An associative array containing the data to be displayed for the field.
* *
* @type string $label Required. The label for this piece of information. * @type string $label Required. The label for this piece of information.
* @type mixed $value Required. The output that is displayed for this field. Text should be translated. Can be * @type mixed $value Required. The output that is displayed for this field.
* an associative array that is displayed as name/value pairs. * Text should be translated. Can be an associative array
* that is displayed as name/value pairs.
* Accepted types: `string|int|float|(string|int|float)[]`. * Accepted types: `string|int|float|(string|int|float)[]`.
* @type string $debug Optional. The output that is used for this field when the user copies the data. * @type string $debug Optional. The output that is used for this field when
* It should be more concise and not translated. If not set, the content of `$value` is used. * the user copies the data. It should be more concise and
* Note that the array keys are used as labels for the copied data. * not translated. If not set, the content of `$value`
* @type bool $private Optional. If set to `true` the field will not be included in the copied data * is used. Note that the array keys are used as labels
* allowing you to show, for example, API keys here. Default false. * 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.
* } * }
* } * }
* } * }

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.9-alpha-51955'; $wp_version = '5.9-alpha-51956';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.