<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[53877] trunk/src: Docs: Correct and improve the documented types for various functions and hooks.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { white-space: pre-line; overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="https://core.trac.wordpress.org/changeset/53877">53877</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"https://core.trac.wordpress.org/changeset/53877","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>johnbillion</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2022-08-11 14:01:35 +0000 (Thu, 11 Aug 2022)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>Docs: Correct and improve the documented types for various functions and hooks.
See <a href="https://core.trac.wordpress.org/ticket/55646">#55646</a></pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpadminincludestemplatephp">trunk/src/wp-admin/includes/template.php</a></li>
<li><a href="#trunksrcwpincludesblockssearchphp">trunk/src/wp-includes/blocks/search.php</a></li>
<li><a href="#trunksrcwpincludesblockstemplatepartphp">trunk/src/wp-includes/blocks/template-part.php</a></li>
<li><a href="#trunksrcwpincludesclasswpblocktypephp">trunk/src/wp-includes/class-wp-block-type.php</a></li>
<li><a href="#trunksrcwpincludesclasswpcustomizepanelphp">trunk/src/wp-includes/class-wp-customize-panel.php</a></li>
<li><a href="#trunksrcwpincludeslinktemplatephp">trunk/src/wp-includes/link-template.php</a></li>
<li><a href="#trunksrcwpincludesmetaphp">trunk/src/wp-includes/meta.php</a></li>
<li><a href="#trunksrcwpincludespostphp">trunk/src/wp-includes/post.php</a></li>
<li><a href="#trunksrcwpincludesrestapiendpointsclasswprestpluginscontrollerphp">trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-plugins-controller.php</a></li>
<li><a href="#trunksrcwpincludesrestapisearchclasswpresttermsearchhandlerphp">trunk/src/wp-includes/rest-api/search/class-wp-rest-term-search-handler.php</a></li>
<li><a href="#trunksrcwpincludesrestapiphp">trunk/src/wp-includes/rest-api.php</a></li>
<li><a href="#trunksrcwpincludesrevisionphp">trunk/src/wp-includes/revision.php</a></li>
<li><a href="#trunksrcwpincludestaxonomyphp">trunk/src/wp-includes/taxonomy.php</a></li>
<li><a href="#trunksrcwpincludesuserphp">trunk/src/wp-includes/user.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpadminincludestemplatephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-admin/includes/template.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/includes/template.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-admin/includes/template.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1776,7 +1776,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.0.0
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.3.0 Added `warning` and `info` as possible values for `$type`.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @global array $wp_settings_errors Storage array of errors registered during this pageload
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @global array[] $wp_settings_errors Storage array of errors registered during this pageload
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $setting Slug title of the setting to which this error applies.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1813,7 +1813,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 3.0.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @global array $wp_settings_errors Storage array of errors registered during this pageload
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @global array[] $wp_settings_errors Storage array of errors registered during this pageload
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $setting Optional. Slug title of a specific setting whose errors you want.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param bool $sanitize Optional. Whether to re-sanitize the setting value before returning errors.
</span></span></pre></div>
<a id="trunksrcwpincludesblockssearchphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/blocks/search.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/blocks/search.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/blocks/search.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -180,7 +180,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array $attributes The block attributes.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Style HTML attribute.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string[] Style HTML attributes.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function styles_for_block_core_search( $attributes ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $wrapper_styles = array();
</span></span></pre></div>
<a id="trunksrcwpincludesblockstemplatepartphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/blocks/template-part.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/blocks/template-part.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/blocks/template-part.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -159,9 +159,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="cx" style="display: block; padding: 0 10px"> /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * Returns an array of variation objects for the template part block.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Returns an array of variation arrays for the template part block.
</ins><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Array containing the block variation objects.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return array[] Array containing the block variation data in an array.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function build_template_part_block_variations() {
</span><span class="cx" style="display: block; padding: 0 10px"> $variations = array();
</span></span></pre></div>
<a id="trunksrcwpincludesclasswpblocktypephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/class-wp-block-type.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-block-type.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/class-wp-block-type.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -54,7 +54,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * when nested within the specified blocks.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.5.0
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @var array|null
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @var string[]|null
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public $parent = null;
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -63,7 +63,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * block types at any position of the ancestor's block subtree.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 6.0.0
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @var array|null
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @var string[]|null
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public $ancestor = null;
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -112,7 +112,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Block variations.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.8.0
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @var array
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @var array[]
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public $variations = array();
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -152,7 +152,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Context values inherited by blocks of this type.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.5.0
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @var array
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @var string[]
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public $uses_context = array();
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -160,7 +160,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Context provided by blocks of this type.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.5.0
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @var array|null
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @var string[]|null
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public $provides_context = null;
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -239,9 +239,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $title Human-readable block type label.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string|null $category Block type category classification, used in
</span><span class="cx" style="display: block; padding: 0 10px"> * search interfaces to arrange block types by category.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type array|null $parent Setting parent lets a block require that it is only
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @type string[]|null $parent Setting parent lets a block require that it is only
</ins><span class="cx" style="display: block; padding: 0 10px"> * available when nested within the specified blocks.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type array|null $ancestor Setting ancestor makes a block available only inside the specified
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @type string[]|null $ancestor Setting ancestor makes a block available only inside the specified
</ins><span class="cx" style="display: block; padding: 0 10px"> * block types at any position of the ancestor's block subtree.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string|null $icon Block type icon.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $description A detailed block type description.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -248,14 +248,14 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string[] $keywords Additional keywords to produce block type as
</span><span class="cx" style="display: block; padding: 0 10px"> * result in search interfaces.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string|null $textdomain The translation textdomain.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type array $styles Alternative block styles.
- * @type array $variations Block variations.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @type array[] $styles Alternative block styles.
+ * @type array[] $variations Block variations.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @type array|null $supports Supported features.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type array|null $example Structured data for the block preview.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type callable|null $render_callback Block type render callback.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type array|null $attributes Block type attributes property schemas.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type array $uses_context Context values inherited by blocks of this type.
- * @type array|null $provides_context Context provided by blocks of this type.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @type string[] $uses_context Context values inherited by blocks of this type.
+ * @type string[]|null $provides_context Context provided by blocks of this type.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @type string|null $editor_script Block type editor only script handle.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string|null $script Block type front end and editor script handle.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string|null $view_script Block type front end only script handle.
</span></span></pre></div>
<a id="trunksrcwpincludesclasswpcustomizepanelphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/class-wp-customize-panel.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-customize-panel.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/class-wp-customize-panel.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -72,7 +72,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * Theme features required to support the panel.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.0.0
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @var string|string[]
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @var mixed[]
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public $theme_supports = '';
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -146,7 +146,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * of panels and sections. Default 160.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $capability Capability required for the panel.
</span><span class="cx" style="display: block; padding: 0 10px"> * Default `edit_theme_options`.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type string|string[] $theme_supports Theme features required to support the panel.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @type mixed[] $theme_supports Theme features required to support the panel.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @type string $title Title of the panel to show in UI.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $description Description to show in the UI.
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $type Type of the panel.
</span></span></pre></div>
<a id="trunksrcwpincludeslinktemplatephp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/link-template.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/link-template.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/link-template.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4239,9 +4239,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @return array {
</span><span class="cx" style="display: block; padding: 0 10px"> * Along with the arguments passed in `$args`, this will contain a couple of extra arguments.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @type bool $found_avatar True if we were able to find an avatar for this user,
- * false or not set if we couldn't.
- * @type string $url The URL of the avatar we found.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @type bool $found_avatar True if an avatar was found for this user,
+ * false or not set if none was found.
+ * @type string|false $url The URL of the avatar that was found, or false.
</ins><span class="cx" style="display: block; padding: 0 10px"> * }
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_avatar_data( $id_or_email, $args = null ) {
</span></span></pre></div>
<a id="trunksrcwpincludesmetaphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/meta.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/meta.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/meta.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1231,7 +1231,13 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $primary_table Primary database table name.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $primary_id_column Primary ID column name.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param object $context Optional. The main query object
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Associative array of `JOIN` and `WHERE` SQL.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string[]|false {
+ * Array containing JOIN and WHERE SQL clauses to append to the main query,
+ * or false if no table exists for the requested meta type.
+ *
+ * @type string $join SQL fragment to append to the main JOIN clause.
+ * @type string $where SQL fragment to append to the main WHERE clause.
+ * }
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_meta_sql( $meta_query, $type, $primary_table, $primary_id_column, $context = null ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $meta_query_obj = new WP_Meta_Query( $meta_query );
</span></span></pre></div>
<a id="trunksrcwpincludespostphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/post.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/post.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/post.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -861,7 +861,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @param string $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which
</span><span class="cx" style="display: block; padding: 0 10px"> * correspond to a WP_Post object, an associative array, or a numeric array,
</span><span class="cx" style="display: block; padding: 0 10px"> * respectively. Default OBJECT.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return WP_Post[]|int[] Array of post objects or post IDs.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return WP_Post[]|array[]|int[] Array of post objects, arrays, or IDs, depending on `$output`.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_children( $args = '', $output = OBJECT ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $kids = array();
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -5806,9 +5806,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 1.5.1
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param int $page_id Page ID.
- * @param array $pages List of page objects from which descendants should be identified.
- * @return array List of page children.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param int $page_id Page ID.
+ * @param WP_Post[] $pages List of page objects from which descendants should be identified.
+ * @return WP_Post[] List of page children.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_page_children( $page_id, $pages ) {
</span><span class="cx" style="display: block; padding: 0 10px"> // Build a hash of ID -> children.
</span></span></pre></div>
<a id="trunksrcwpincludesrestapiendpointsclasswprestpluginscontrollerphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-plugins-controller.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-plugins-controller.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-plugins-controller.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -571,7 +571,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.5.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param mixed $item Unmarked up and untranslated plugin data from {@see get_plugin_data()}.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $item Unmarked up and untranslated plugin data from {@see get_plugin_data()}.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param WP_REST_Request $request Request object.
</span><span class="cx" style="display: block; padding: 0 10px"> * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
</span><span class="cx" style="display: block; padding: 0 10px"> */
</span></span></pre></div>
<a id="trunksrcwpincludesrestapisearchclasswpresttermsearchhandlerphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/rest-api/search/class-wp-rest-term-search-handler.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/rest-api/search/class-wp-rest-term-search-handler.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/rest-api/search/class-wp-rest-term-search-handler.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -41,9 +41,14 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.6.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param WP_REST_Request $request Full REST request.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Associative array containing an `WP_REST_Search_Handler::RESULT_IDS` containing
- * an array of found IDs and `WP_REST_Search_Handler::RESULT_TOTAL` containing the
- * total count for the matching search results.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return array {
+ * Associative array containing found IDs and total count for the matching search results.
+ *
+ * @type int[] $ids Found IDs.
+ * @type string|int|WP_Error $total Numeric string containing the number of terms in that
+ * taxonomy, 0 if there are no results, or WP_Error if
+ * the requested taxonomy does not exist.
+ * }
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public function search_items( WP_REST_Request $request ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $taxonomies = $request[ WP_REST_Search_Controller::PROP_SUBTYPE ];
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -132,7 +137,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.6.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param int $id Item ID.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Links for the given item.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return array[] Array of link arrays for the given item.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> public function prepare_item_links( $id ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $term = get_term( $id );
</span></span></pre></div>
<a id="trunksrcwpincludesrestapiphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/rest-api.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/rest-api.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/rest-api.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1191,7 +1191,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param mixed $id_or_email The Gravatar to retrieve a URL for. Accepts a user_id, gravatar md5 hash,
</span><span class="cx" style="display: block; padding: 0 10px"> * user email, WP_User object, WP_Post object, or WP_Comment object.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Avatar URLs keyed by size. Each value can be a URL string or boolean false.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return (string|false)[] Avatar URLs keyed by size. Each value can be a URL string or boolean false.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function rest_get_avatar_urls( $id_or_email ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $avatar_sizes = rest_get_avatar_sizes();
</span></span></pre></div>
<a id="trunksrcwpincludesrevisionphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/revision.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/revision.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/revision.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -17,7 +17,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array|WP_Post $post Optional. A post array or a WP_Post object being processed
</span><span class="cx" style="display: block; padding: 0 10px"> * for insertion as a post revision. Default empty array.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param bool $deprecated Not used.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array Array of fields that can be versioned.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string[] Array of fields that can be versioned.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function _wp_post_revision_fields( $post = array(), $deprecated = false ) {
</span><span class="cx" style="display: block; padding: 0 10px"> static $fields = null;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -47,9 +47,9 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 2.6.0
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.5.0 The `$post` parameter was added.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param array $fields List of fields to revision. Contains 'post_title',
- * 'post_content', and 'post_excerpt' by default.
- * @param array $post A post array being processed for insertion as a post revision.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string[] $fields List of fields to revision. Contains 'post_title',
+ * 'post_content', and 'post_excerpt' by default.
+ * @param array $post A post array being processed for insertion as a post revision.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $fields = apply_filters( '_wp_post_revision_fields', $fields, $post );
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -489,7 +489,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`.
</span><span class="cx" style="display: block; padding: 0 10px"> * @param array|null $args Optional. Arguments for retrieving post revisions. Default null.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array An array of revisions, or an empty array if none.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return WP_Post[]|int[] Array of revision objects or IDs, or an empty array if none.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function wp_get_post_revisions( $post = 0, $args = null ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $post = get_post( $post );
</span></span></pre></div>
<a id="trunksrcwpincludestaxonomyphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/taxonomy.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/taxonomy.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/taxonomy.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1856,8 +1856,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @internal The `$deprecated` parameter is parsed for backward compatibility only.
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param array|string $args Optional. Array of arguments that get passed to get_terms().
- * Default empty array.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array|string $args Optional. Array or string of arguments. See WP_Term_Query::__construct()
+ * for information on accepted arguments. Default empty array.
</ins><span class="cx" style="display: block; padding: 0 10px"> * @param array|string $deprecated Optional. Argument array, when using the legacy function parameter format.
</span><span class="cx" style="display: block; padding: 0 10px"> * If present, this parameter will be interpreted as `$args`, and the first
</span><span class="cx" style="display: block; padding: 0 10px"> * function parameter will be parsed as a taxonomy or array of taxonomies.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4700,7 +4700,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @type string $term_template Template for displaying a single term in the list. Default is the term name
</span><span class="cx" style="display: block; padding: 0 10px"> * linked to its archive.
</span><span class="cx" style="display: block; padding: 0 10px"> * }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array List of taxonomies.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string[] List of taxonomies.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function get_the_taxonomies( $post = 0, $args = array() ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $post = get_post( $post );
</span></span></pre></div>
<a id="trunksrcwpincludesuserphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/user.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/user.php 2022-08-11 13:53:51 UTC (rev 53876)
+++ trunk/src/wp-includes/user.php 2022-08-11 14:01:35 UTC (rev 53877)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1213,10 +1213,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 5.1.0
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param null|string $result The value to return instead. Default null to continue with the query.
- * @param string $strategy Optional. The computational strategy to use when counting the users.
- * Accepts either 'time' or 'memory'. Default 'time'.
- * @param int|null $site_id Optional. The site ID to count users for. Defaults to the current site.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param null|array $result The value to return instead. Default null to continue with the query.
+ * @param string $strategy Optional. The computational strategy to use when counting the users.
+ * Accepts either 'time' or 'memory'. Default 'time'.
+ * @param int $site_id The site ID to count users for.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> $pre = apply_filters( 'pre_count_users', null, $strategy, $site_id );
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3743,7 +3743,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.9.6
</span><span class="cx" style="display: block; padding: 0 10px"> * @access private
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return array List of core privacy action types.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return string[] List of core privacy action types.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function _wp_privacy_action_request_types() {
</span><span class="cx" style="display: block; padding: 0 10px"> return array(
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3757,8 +3757,8 @@
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><span class="cx" style="display: block; padding: 0 10px"> * @since 4.9.6
</span><span class="cx" style="display: block; padding: 0 10px"> *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param array $exporters An array of personal data exporters.
- * @return array An array of personal data exporters.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array[] $exporters An array of personal data exporters.
+ * @return array[] An array of personal data exporters.
</ins><span class="cx" style="display: block; padding: 0 10px"> */
</span><span class="cx" style="display: block; padding: 0 10px"> function wp_register_user_personal_data_exporter( $exporters ) {
</span><span class="cx" style="display: block; padding: 0 10px"> $exporters['wordpress-user'] = array(
</span></span></pre>
</div>
</div>
</body>
</html>