<!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>[43510] branches/4.9: REST API: Support meta registration for specific object subtypes.</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/43510">43510</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/43510","name":"Review Commit"}}</script></dd>

<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>kadamwhite</dd>

<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2018-07-19 18:48:52 +0000 (Thu, 19 Jul 2018)</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'>REST API: Support meta registration for specific object subtypes.

Introduce an object_subtype argument to the args array for register_meta() which can be used to limit meta registration to a single subtype (e.g. a custom post type or taxonomy, vs all posts or taxonomies).

Introduce register_post_meta() and register_term_meta() wrapper methods for register_meta to provide a convenient interface for the common case of registering meta for a specific taxonomy or post type. These methods work the way plugin developers have often expected register_meta to function, and should be used in place of direct register_meta where possible.

Props flixos90, tharsheblows, spacedmonkey.

Merges <a href="https://core.trac.wordpress.org/changeset/43378">[43378]</a> to the 4.9 branch.

Fixes <a href="https://core.trac.wordpress.org/ticket/38323">#38323</a>.</pre>

<h3>Modified Paths</h3>

<ul>

<li><a href="#branches49srcwpincludescapabilitiesphp">branches/4.9/src/wp-includes/capabilities.php</a></li>

<li><a href="#branches49srcwpincludesmetaphp">branches/4.9/src/wp-includes/meta.php</a></li>

<li><a href="#branches49srcwpincludespostphp">branches/4.9/src/wp-includes/post.php</a></li>

<li><a href="#branches49srcwpincludesrestapifieldsclasswprestcommentmetafieldsphp">branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php</a></li>

<li><a href="#branches49srcwpincludesrestapifieldsclasswprestmetafieldsphp">branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-meta-fields.php</a></li>

<li><a href="#branches49srcwpincludesrestapifieldsclasswprestpostmetafieldsphp">branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php</a></li>

<li><a href="#branches49srcwpincludesrestapifieldsclasswpresttermmetafieldsphp">branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-term-meta-fields.php</a></li>

<li><a href="#branches49srcwpincludesrestapifieldsclasswprestusermetafieldsphp">branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-user-meta-fields.php</a></li>

<li><a href="#branches49srcwpincludestaxonomyphp">branches/4.9/src/wp-includes/taxonomy.php</a></li>

<li><a href="#branches49testsphpunittestsmetaregisterMetaphp">branches/4.9/tests/phpunit/tests/meta/registerMeta.php</a></li>

<li><a href="#branches49testsphpunittestspostmetaphp">branches/4.9/tests/phpunit/tests/post/meta.php</a></li>

<li><a href="#branches49testsphpunittestsrestapirestpostmetafieldsphp">branches/4.9/tests/phpunit/tests/rest-api/rest-post-meta-fields.php</a></li>

<li><a href="#branches49testsphpunitteststermmetaphp">branches/4.9/tests/phpunit/tests/term/meta.php</a></li>

</ul>

</div>

<div id="patch">

<h3>Diff</h3>

<a id="branches49srcwpincludescapabilitiesphp"></a>

<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: branches/4.9/src/wp-includes/capabilities.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- branches/4.9/src/wp-includes/capabilities.php     2018-07-19 12:16:47 UTC (rev 43509)

+++ branches/4.9/src/wp-includes/capabilities.php       2018-07-19 18:48:52 UTC (rev 43510)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -276,46 +276,9 @@

</span><span class="cx" style="display: block; padding: 0 10px">        case 'add_user_meta':

</span><span class="cx" style="display: block; padding: 0 10px">                list( $_, $object_type, $_ ) = explode( '_', $cap );

</span><span class="cx" style="display: block; padding: 0 10px">                $object_id = (int) $args[0];

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                $object_subtype = get_object_subtype( $object_type, $object_id );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                switch ( $object_type ) {

-                       case 'post':

-                               $post = get_post( $object_id );

-                               if ( ! $post ) {

-                                       break;

-                               }

-

-                               $sub_type = get_post_type( $post );

-                               break;

-

-                       case 'comment':

-                               $comment = get_comment( $object_id );

-                               if ( ! $comment ) {

-                                       break;

-                               }

-

-                               $sub_type = empty( $comment->comment_type ) ? 'comment' : $comment->comment_type;

-                               break;

-

-                       case 'term':

-                               $term = get_term( $object_id );

-                               if ( ! $term instanceof WP_Term ) {

-                                       break;

-                               }

-

-                               $sub_type = $term->taxonomy;

-                               break;

-

-                       case 'user':

-                               $user = get_user_by( 'id', $object_id );

-                               if ( ! $user ) {

-                                       break;

-                               }

-

-                               $sub_type = 'user';

-                               break;

-               }

-

-               if ( empty( $sub_type ) ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( empty( $object_subtype ) ) {

</ins><span class="cx" style="display: block; padding: 0 10px">                         $caps[] = 'do_not_allow';

</span><span class="cx" style="display: block; padding: 0 10px">                        break;

</span><span class="cx" style="display: block; padding: 0 10px">                }

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -324,57 +287,79 @@

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">                $meta_key = isset( $args[1] ) ? $args[1] : false;

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                $has_filter = has_filter( "auth_{$object_type}_meta_{$meta_key}" ) || has_filter( "auth_{$object_type}_{$sub_type}_meta_{$meta_key}" );

-               if ( $meta_key && $has_filter ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( $meta_key ) {

+                       $allowed = ! is_protected_meta( $meta_key, $object_type );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                        /**

-                        * Filters whether the user is allowed to edit meta.

-                        *

-                        * Use the {@see auth_post_$object_type_meta_$meta_key} filter to modify capabilities for

-                        * specific object types. Return true to have the mapped meta caps from edit_{$object_type} apply.

-                        *

-                        * The dynamic portion of the hook name, `$object_type` refers to the object type being filtered.

-                        * The dynamic portion of the hook name, `$meta_key`, refers to the meta key passed to map_meta_cap().

-                        *

-                        * @since 3.3.0 As 'auth_post_meta_{$meta_key}'.

-                        * @since 4.6.0

-                        *

-                        * @param bool   $allowed  Whether the user can add the post meta. Default false.

-                        * @param string $meta_key The meta key.

-                        * @param int    $post_id  Post ID.

-                        * @param int    $user_id  User ID.

-                        * @param string $cap      Capability name.

-                        * @param array  $caps     User capabilities.

-                        */

-                       $allowed = apply_filters( "auth_{$object_type}_meta_{$meta_key}", false, $meta_key, $object_id, $user_id, $cap, $caps );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 if ( ! empty( $object_subtype ) && has_filter( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}" ) ) {

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                        /**

-                        * Filters whether the user is allowed to add post meta to a post of a given type.

-                        *

-                        * Use the {@see auth_$object_type_$sub_type_meta_$meta_key} filter to modify capabilities for

-                        * specific object types/subtypes. Return true to have the mapped meta caps from edit_{$object_type} apply.

-                        *

-                        * The dynamic portion of the hook name, `$object_type` refers to the object type being filtered.

-                        * The dynamic portion of the hook name, `$sub_type` refers to the object subtype being filtered.

-                        * The dynamic portion of the hook name, `$meta_key`, refers to the meta key passed to map_meta_cap().

-                        *

-                        * @since 4.6.0 As 'auth_post_{$post_type}_meta_{$meta_key}'.

-                        * @since 4.7.0

-                        *

-                        * @param bool   $allowed  Whether the user can add the post meta. Default false.

-                        * @param string $meta_key The meta key.

-                        * @param int    $post_id  Post ID.

-                        * @param int    $user_id  User ID.

-                        * @param string $cap      Capability name.

-                        * @param array  $caps     User capabilities.

-                        */

-                       $allowed = apply_filters( "auth_{$object_type}_{$sub_type}_meta_{$meta_key}", $allowed, $meta_key, $object_id, $user_id, $cap, $caps );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         /**

+                                * Filters whether the user is allowed to edit a specific meta key of a specific object type and subtype.

+                                *

+                                * The dynamic portions of the hook name, `$object_type`, `$meta_key`,

+                                * and `$object_subtype`, refer to the metadata object type (comment, post, term or user),

+                                * the meta key value, and the object subtype respectively.

+                                *

+                                * @since 4.9.8

+                                *

+                                * @param bool     $allowed   Whether the user can add the object meta. Default false.

+                                * @param string   $meta_key  The meta key.

+                                * @param int      $object_id Object ID.

+                                * @param int      $user_id   User ID.

+                                * @param string   $cap       Capability name.

+                                * @param string[] $caps      Array of the user's capabilities.

+                                */

+                               $allowed = apply_filters( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $allowed, $meta_key, $object_id, $user_id, $cap, $caps );

+                       } else {

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                                /**

+                                * Filters whether the user is allowed to edit a specific meta key of a specific object type.

+                                *

+                                * Return true to have the mapped meta caps from `edit_{$object_type}` apply.

+                                *

+                                * The dynamic portion of the hook name, `$object_type` refers to the object type being filtered.

+                                * The dynamic portion of the hook name, `$meta_key`, refers to the meta key passed to map_meta_cap().

+                                *

+                                * @since 3.3.0 As `auth_post_meta_{$meta_key}`.

+                                * @since 4.6.0

+                                *

+                                * @param bool     $allowed   Whether the user can add the object meta. Default false.

+                                * @param string   $meta_key  The meta key.

+                                * @param int      $object_id Object ID.

+                                * @param int      $user_id   User ID.

+                                * @param string   $cap       Capability name.

+                                * @param string[] $caps      Array of the user's capabilities.

+                                */

+                               $allowed = apply_filters( "auth_{$object_type}_meta_{$meta_key}", $allowed, $meta_key, $object_id, $user_id, $cap, $caps );

+                       }

+

+                       if ( ! empty( $object_subtype ) ) {

+

+                               /**

+                                * Filters whether the user is allowed to edit meta for specific object types/subtypes.

+                                *

+                                * Return true to have the mapped meta caps from `edit_{$object_type}` apply.

+                                *

+                                * The dynamic portion of the hook name, `$object_type` refers to the object type being filtered.

+                                * The dynamic portion of the hook name, `$object_subtype` refers to the object subtype being filtered.

+                                * The dynamic portion of the hook name, `$meta_key`, refers to the meta key passed to map_meta_cap().

+                                *

+                                * @since 4.6.0 As `auth_post_{$post_type}_meta_{$meta_key}`.

+                                * @since 4.7.0

+                                * @deprecated 4.9.8 Use `auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}`

+                                *

+                                * @param bool     $allowed   Whether the user can add the object meta. Default false.

+                                * @param string   $meta_key  The meta key.

+                                * @param int      $object_id Object ID.

+                                * @param int      $user_id   User ID.

+                                * @param string   $cap       Capability name.

+                                * @param string[] $caps      Array of the user's capabilities.

+                                */

+                               $allowed = apply_filters_deprecated( "auth_{$object_type}_{$object_subtype}_meta_{$meta_key}", array( $allowed, $meta_key, $object_id, $user_id, $cap, $caps ), '4.9.8', "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}" );

+                       }

+

</ins><span class="cx" style="display: block; padding: 0 10px">                         if ( ! $allowed ) {

</span><span class="cx" style="display: block; padding: 0 10px">                                $caps[] = $cap;

</span><span class="cx" style="display: block; padding: 0 10px">                        }

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } elseif ( $meta_key && is_protected_meta( $meta_key, $object_type ) ) {

-                       $caps[] = $cap;

</del><span class="cx" style="display: block; padding: 0 10px">                 }

</span><span class="cx" style="display: block; padding: 0 10px">                break;

</span><span class="cx" style="display: block; padding: 0 10px">        case 'edit_comment':

</span></span></pre></div>

<a id="branches49srcwpincludesmetaphp"></a>

<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: branches/4.9/src/wp-includes/meta.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- branches/4.9/src/wp-includes/meta.php     2018-07-19 12:16:47 UTC (rev 43509)

+++ branches/4.9/src/wp-includes/meta.php       2018-07-19 18:48:52 UTC (rev 43510)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -44,12 +44,14 @@

</span><span class="cx" style="display: block; padding: 0 10px">                return false;

</span><span class="cx" style="display: block; padding: 0 10px">        }

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+        $meta_subtype = get_object_subtype( $meta_type, $object_id );

+

</ins><span class="cx" style="display: block; padding: 0 10px">         $column = sanitize_key($meta_type . '_id');

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        // expected_slashed ($meta_key)

</span><span class="cx" style="display: block; padding: 0 10px">        $meta_key = wp_unslash($meta_key);

</span><span class="cx" style="display: block; padding: 0 10px">        $meta_value = wp_unslash($meta_value);

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        $meta_value = sanitize_meta( $meta_key, $meta_value, $meta_type );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $meta_value = sanitize_meta( $meta_key, $meta_value, $meta_type, $meta_subtype );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        /**

<span class="cx" style="display: block; padding: 0 10px">         * Filters whether to add metadata of a specific type.

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -157,6 +159,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">                return false;

</span><span class="cx" style="display: block; padding: 0 10px">        }

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+        $meta_subtype = get_object_subtype( $meta_type, $object_id );

+

</ins><span class="cx" style="display: block; padding: 0 10px">         $column = sanitize_key($meta_type . '_id');

</span><span class="cx" style="display: block; padding: 0 10px">        $id_column = 'user' == $meta_type ? 'umeta_id' : 'meta_id';

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -165,7 +169,7 @@

</span><span class="cx" style="display: block; padding: 0 10px">        $meta_key = wp_unslash($meta_key);

</span><span class="cx" style="display: block; padding: 0 10px">        $passed_value = $meta_value;

</span><span class="cx" style="display: block; padding: 0 10px">        $meta_value = wp_unslash($meta_value);

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        $meta_value = sanitize_meta( $meta_key, $meta_value, $meta_type );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $meta_value = sanitize_meta( $meta_key, $meta_value, $meta_type, $meta_subtype );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        /**

<span class="cx" style="display: block; padding: 0 10px">         * Filters whether to update metadata of a specific type.

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -640,10 +644,12 @@

</span><span class="cx" style="display: block; padding: 0 10px">                        return false;

</span><span class="cx" style="display: block; padding: 0 10px">                }

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                $meta_subtype = get_object_subtype( $meta_type, $object_id );

+

</ins><span class="cx" style="display: block; padding: 0 10px">                 // Sanitize the meta

</span><span class="cx" style="display: block; padding: 0 10px">                $_meta_value = $meta_value;

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                $meta_value = sanitize_meta( $meta_key, $meta_value, $meta_type );

-               $meta_value = maybe_serialize( $meta_value );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         $meta_value  = sanitize_meta( $meta_key, $meta_value, $meta_type, $meta_subtype );

+               $meta_value  = maybe_serialize( $meta_value );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

<span class="cx" style="display: block; padding: 0 10px">                // Format the data query arguments.

</span><span class="cx" style="display: block; padding: 0 10px">                $data = array(

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -935,6 +941,7 @@

<span class="cx" style="display: block; padding: 0 10px">  * Sanitize meta value.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 3.1.3

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @since 4.9.8 The `$object_subtype` parameter was added.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @param string $meta_key       Meta key.

<span class="cx" style="display: block; padding: 0 10px">  * @param mixed  $meta_value     Meta value to sanitize.

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -942,7 +949,26 @@

</span><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @return mixed Sanitized $meta_value.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-function sanitize_meta( $meta_key, $meta_value, $object_type ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+function sanitize_meta( $meta_key, $meta_value, $object_type, $object_subtype = '' ) {

+       if ( ! empty( $object_subtype ) && has_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}" ) ) {

+

+               /**

+                * Filters the sanitization of a specific meta key of a specific meta type and subtype.

+                *

+                * The dynamic portions of the hook name, `$object_type`, `$meta_key`,

+                * and `$object_subtype`, refer to the metadata object type (comment, post, term or user),

+                * the meta key value, and the object subtype respectively.

+                *

+                * @since 4.9.8

+                *

+                * @param mixed  $meta_value     Meta value to sanitize.

+                * @param string $meta_key       Meta key.

+                * @param string $object_type    Object type.

+                * @param string $object_subtype Object subtype.

+                */

+               return apply_filters( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $meta_value, $meta_key, $object_type, $object_subtype );

+       }

+

</ins><span class="cx" style="display: block; padding: 0 10px">         /**

<span class="cx" style="display: block; padding: 0 10px">         * Filters the sanitization of a specific meta key of a specific meta type.

</span><span class="cx" style="display: block; padding: 0 10px">         *

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -962,10 +988,18 @@

</span><span class="cx" style="display: block; padding: 0 10px"> /**

<span class="cx" style="display: block; padding: 0 10px">  * Registers a meta key.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * It is recommended to register meta keys for a specific combination of object type and object subtype. If passing

+ * an object subtype is omitted, the meta key will be registered for the entire object type, however it can be partly

+ * overridden in case a more specific meta key of the same name exists for the same object type and a subtype.

+ *

+ * If an object type does not support any subtypes, such as users or comments, you should commonly call this function

+ * without passing a subtype.

+ *

</ins><span class="cx" style="display: block; padding: 0 10px">  * @since 3.3.0

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 4.6.0 {@link https://core.trac.wordpress.org/ticket/35658 Modified

</span><span class="cx" style="display: block; padding: 0 10px">  *              to support an array of data to attach to registered meta keys}. Previous arguments for

<span class="cx" style="display: block; padding: 0 10px">  *              `$sanitize_callback` and `$auth_callback` have been folded into this array.

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @since 4.9.8 The `$object_subtype` argument was added to the arguments array.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @param string $object_type    Type of object this meta is registered to.

<span class="cx" style="display: block; padding: 0 10px">  * @param string $meta_key       Meta key to register.

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -972,6 +1006,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">  * @param array  $args {

<span class="cx" style="display: block; padding: 0 10px">  *     Data used to describe the meta key when registered.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ *     @type string $object_subtype    A subtype; e.g. if the object type is "post", the post type. If left empty,

+ *                                     the meta key will be registered on the entire object type. Default empty.

</ins><span class="cx" style="display: block; padding: 0 10px">  *     @type string $type              The type of data associated with this meta key.

<span class="cx" style="display: block; padding: 0 10px">  *                                     Valid values are 'string', 'boolean', 'integer', and 'number'.

<span class="cx" style="display: block; padding: 0 10px">  *     @type string $description       A description of the data attached to this meta key.

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -994,6 +1030,7 @@

</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">        $defaults = array(

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                'object_subtype'    => '',

</ins><span class="cx" style="display: block; padding: 0 10px">                 'type'              => 'string',

</span><span class="cx" style="display: block; padding: 0 10px">                'description'       => '',

</span><span class="cx" style="display: block; padding: 0 10px">                'single'            => false,

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1034,6 +1071,8 @@

</span><span class="cx" style="display: block; padding: 0 10px">        $args = apply_filters( 'register_meta_args', $args, $defaults, $object_type, $meta_key );

</span><span class="cx" style="display: block; padding: 0 10px">        $args = wp_parse_args( $args, $defaults );

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+        $object_subtype = ! empty( $args['object_subtype'] ) ? $args['object_subtype'] : '';

+

</ins><span class="cx" style="display: block; padding: 0 10px">         // If `auth_callback` is not provided, fall back to `is_protected_meta()`.

</span><span class="cx" style="display: block; padding: 0 10px">        if ( empty( $args['auth_callback'] ) ) {

</span><span class="cx" style="display: block; padding: 0 10px">                if ( is_protected_meta( $meta_key, $object_type ) ) {

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1045,17 +1084,27 @@

</span><span class="cx" style="display: block; padding: 0 10px"> 

<span class="cx" style="display: block; padding: 0 10px">        // Back-compat: old sanitize and auth callbacks are applied to all of an object type.

</span><span class="cx" style="display: block; padding: 0 10px">        if ( is_callable( $args['sanitize_callback'] ) ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                add_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'], 10, 3 );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( ! empty( $object_subtype ) ) {

+                       add_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['sanitize_callback'], 10, 4 );

+               } else {

+                       add_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'], 10, 3 );

+               }

</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">        if ( is_callable( $args['auth_callback'] ) ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                add_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'], 10, 6 );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( ! empty( $object_subtype ) ) {

+                       add_filter( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['auth_callback'], 10, 6 );

+               } else {

+                       add_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'], 10, 6 );

+               }

</ins><span class="cx" style="display: block; padding: 0 10px">         }

</span><span class="cx" style="display: block; padding: 0 10px"> 

<span class="cx" style="display: block; padding: 0 10px">        // Global registry only contains meta keys registered with the array of arguments added in 4.6.0.

</span><span class="cx" style="display: block; padding: 0 10px">        if ( ! $has_old_auth_cb && ! $has_old_sanitize_cb ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                $wp_meta_keys[ $object_type ][ $meta_key ] = $args;

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         unset( $args['object_subtype'] );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                $wp_meta_keys[ $object_type ][ $object_subtype ][ $meta_key ] = $args;

+

</ins><span class="cx" style="display: block; padding: 0 10px">                 return true;

</span><span class="cx" style="display: block; padding: 0 10px">        }

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1066,28 +1115,19 @@

<span class="cx" style="display: block; padding: 0 10px">  * Checks if a meta key is registered.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 4.6.0

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @since 4.9.8 The `$object_subtype` parameter was added.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @param string $object_type    The type of object.

<span class="cx" style="display: block; padding: 0 10px">  * @param string $meta_key       The meta key.

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $object_subtype Optional. The subtype of the object type.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @return bool True if the meta key is registered to the object type. False if not.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @return bool True if the meta key is registered to the object type and, if provided,

+ *              the object subtype. False if not.

</ins><span class="cx" style="display: block; padding: 0 10px">  */

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-function registered_meta_key_exists( $object_type, $meta_key ) {

-       global $wp_meta_keys;

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+function registered_meta_key_exists( $object_type, $meta_key, $object_subtype = '' ) {

+       $meta_keys = get_registered_meta_keys( $object_type, $object_subtype );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        if ( ! is_array( $wp_meta_keys ) ) {

-               return false;

-       }

-

-       if ( ! isset( $wp_meta_keys[ $object_type ] ) ) {

-               return false;

-       }

-

-       if ( isset( $wp_meta_keys[ $object_type ][ $meta_key ] ) ) {

-               return true;

-       }

-

-       return false;

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ return isset( $meta_keys[ $meta_key ] );

</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"> /**

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1094,31 +1134,44 @@

<span class="cx" style="display: block; padding: 0 10px">  * Unregisters a meta key from the list of registered keys.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 4.6.0

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @since 4.9.8 The `$object_subtype` parameter was added.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $object_type The type of object.

- * @param string $meta_key    The meta key.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $object_type    The type of object.

+ * @param string $meta_key       The meta key.

+ * @param string $object_subtype Optional. The subtype of the object type.

</ins><span class="cx" style="display: block; padding: 0 10px">  * @return bool True if successful. False if the meta key was not registered.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-function unregister_meta_key( $object_type, $meta_key ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+function unregister_meta_key( $object_type, $meta_key, $object_subtype = '' ) {

</ins><span class="cx" style="display: block; padding: 0 10px">         global $wp_meta_keys;

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        if ( ! registered_meta_key_exists( $object_type, $meta_key ) ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ if ( ! registered_meta_key_exists( $object_type, $meta_key, $object_subtype ) ) {

</ins><span class="cx" style="display: block; padding: 0 10px">                 return false;

</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">-        $args = $wp_meta_keys[ $object_type ][ $meta_key ];

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $args = $wp_meta_keys[ $object_type ][ $object_subtype ][ $meta_key ];

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        if ( isset( $args['sanitize_callback'] ) && is_callable( $args['sanitize_callback'] ) ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                remove_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'] );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( ! empty( $object_subtype ) ) {

+                       remove_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['sanitize_callback'] );

+               } else {

+                       remove_filter( "sanitize_{$object_type}_meta_{$meta_key}", $args['sanitize_callback'] );

+               }

</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">        if ( isset( $args['auth_callback'] ) && is_callable( $args['auth_callback'] ) ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                remove_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'] );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( ! empty( $object_subtype ) ) {

+                       remove_filter( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['auth_callback'] );

+               } else {

+                       remove_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'] );

+               }

</ins><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">-        unset( $wp_meta_keys[ $object_type ][ $meta_key ] );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ unset( $wp_meta_keys[ $object_type ][ $object_subtype ][ $meta_key ] );

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        // Do some clean up

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+        if ( empty( $wp_meta_keys[ $object_type ][ $object_subtype ] ) ) {

+               unset( $wp_meta_keys[ $object_type ][ $object_subtype ] );

+       }

</ins><span class="cx" style="display: block; padding: 0 10px">         if ( empty( $wp_meta_keys[ $object_type ] ) ) {

</span><span class="cx" style="display: block; padding: 0 10px">                unset( $wp_meta_keys[ $object_type ] );

</span><span class="cx" style="display: block; padding: 0 10px">        }

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1130,23 +1183,28 @@

<span class="cx" style="display: block; padding: 0 10px">  * Retrieves a list of registered meta keys for an object type.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @since 4.6.0

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @since 4.9.8 The `$object_subtype` parameter was added.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param string $object_type The type of object. Post, comment, user, term.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param string $object_type    The type of object. Post, comment, user, term.

+ * @param string $object_subtype Optional. The subtype of the object type.

</ins><span class="cx" style="display: block; padding: 0 10px">  * @return array List of registered meta keys.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-function get_registered_meta_keys( $object_type ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+function get_registered_meta_keys( $object_type, $object_subtype = '' ) {

</ins><span class="cx" style="display: block; padding: 0 10px">         global $wp_meta_keys;

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        if ( ! is_array( $wp_meta_keys ) || ! isset( $wp_meta_keys[ $object_type ] ) ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ if ( ! is_array( $wp_meta_keys ) || ! isset( $wp_meta_keys[ $object_type ] ) || ! isset( $wp_meta_keys[ $object_type ][ $object_subtype ] ) ) {

</ins><span class="cx" style="display: block; padding: 0 10px">                 return array();

</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">-        return $wp_meta_keys[ $object_type ];

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ return $wp_meta_keys[ $object_type ][ $object_subtype ];

</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"> /**

<span class="cx" style="display: block; padding: 0 10px">  * Retrieves registered metadata for a specified object.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * The results include both meta that is registered specifically for the

+ * object's subtype and meta that is registered for the entire object type.

+ *

</ins><span class="cx" style="display: block; padding: 0 10px">  * @since 4.6.0

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @param string $object_type Type of object to request metadata for. (e.g. comment, post, term, user)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1154,14 +1212,21 @@

</span><span class="cx" style="display: block; padding: 0 10px">  * @param string $meta_key    Optional. Registered metadata key. If not specified, retrieve all registered

<span class="cx" style="display: block; padding: 0 10px">  *                            metadata for the specified object.

</span><span class="cx" style="display: block; padding: 0 10px">  * @return mixed A single value or array of values for a key if specified. An array of all registered keys

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- *               and values for an object ID if not.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ *               and values for an object ID if not. False if a given $meta_key is not registered.

</ins><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="cx" style="display: block; padding: 0 10px"> function get_registered_metadata( $object_type, $object_id, $meta_key = '' ) {

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+        $object_subtype = get_object_subtype( $object_type, $object_id );

+

</ins><span class="cx" style="display: block; padding: 0 10px">         if ( ! empty( $meta_key ) ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                if ( ! registered_meta_key_exists( $object_type, $meta_key ) ) {

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         if ( ! empty( $object_subtype ) && ! registered_meta_key_exists( $object_type, $meta_key, $object_subtype ) ) {

+                       $object_subtype = '';

+               }

+

+               if ( ! registered_meta_key_exists( $object_type, $meta_key, $object_subtype ) ) {

</ins><span class="cx" style="display: block; padding: 0 10px">                         return false;

</span><span class="cx" style="display: block; padding: 0 10px">                }

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                $meta_keys = get_registered_meta_keys( $object_type );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+

+               $meta_keys     = get_registered_meta_keys( $object_type, $object_subtype );

</ins><span class="cx" style="display: block; padding: 0 10px">                 $meta_key_data = $meta_keys[ $meta_key ];

</span><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">                $data = get_metadata( $object_type, $object_id, $meta_key, $meta_key_data['single'] );

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1170,18 +1235,16 @@

</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">        $data = get_metadata( $object_type, $object_id );

</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+        if ( ! $data ) {

+               return array();

+       }

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><span class="cx" style="display: block; padding: 0 10px">        $meta_keys = get_registered_meta_keys( $object_type );

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        $registered_data = array();

-

-       // Someday, array_filter()

-       foreach ( $meta_keys as $k => $v ) {

-               if ( isset( $data[ $k ] ) ) {

-                       $registered_data[ $k ] = $data[ $k ];

-               }

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ if ( ! empty( $object_subtype ) ) {

+               $meta_keys = array_merge( $meta_keys, get_registered_meta_keys( $object_type, $object_subtype ) );

</ins><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">-        return $registered_data;

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ return array_intersect_key( $data, $meta_keys );

</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"> /**

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1190,22 +1253,77 @@

<span class="cx" style="display: block; padding: 0 10px">  * to be explicitly turned off is a warranty seal of sorts.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * @access private

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @since  4.6.0

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @since 4.6.0

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- * @param  array $args         Arguments from `register_meta()`.

- * @param  array $default_args Default arguments for `register_meta()`.

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * @param array $args         Arguments from `register_meta()`.

+ * @param array $default_args Default arguments for `register_meta()`.

</ins><span class="cx" style="display: block; padding: 0 10px">  *

<span class="cx" style="display: block; padding: 0 10px">  * @return array Filtered arguments.

</span><span class="cx" style="display: block; padding: 0 10px">  */

</span><span class="cx" style="display: block; padding: 0 10px"> function _wp_register_meta_args_whitelist( $args, $default_args ) {

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        $whitelist = array_keys( $default_args );

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ return array_intersect_key( $args, $default_args );

+}

</ins><span class="cx" style="display: block; padding: 0 10px"> 

</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        // In an anonymous function world, this would be better as an array_filter()

-       foreach ( $args as $key => $value ) {

-               if ( ! in_array( $key, $whitelist ) ) {

-                       unset( $args[ $key ] );

-               }

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+/**

+ * Returns the object subtype for a given object ID of a specific type.

+ *

+ * @since 4.9.8

+ *

+ * @param string $object_type Type of object to request metadata for. (e.g. comment, post, term, user)

+ * @param int    $object_id   ID of the object to retrieve its subtype.

+ * @return string The object subtype or an empty string if unspecified subtype.

+ */

+function get_object_subtype( $object_type, $object_id ) {

+       $object_id      = (int) $object_id;

+       $object_subtype = '';

+

+       switch ( $object_type ) {

+               case 'post':

+                       $post_type = get_post_type( $object_id );

+

+                       if ( ! empty( $post_type ) ) {

+                               $object_subtype = $post_type;

+                       }

+                       break;

+

+               case 'term':

+                       $term = get_term( $object_id );

+                       if ( ! $term instanceof WP_Term ) {

+                               break;

+                       }

+

+                       $object_subtype = $term->taxonomy;

+                       break;

+

+               case 'comment':

+                       $comment = get_comment( $object_id );

+                       if ( ! $comment ) {

+                               break;

+                       }

+

+                       $object_subtype = 'comment';

+                       break;

+

+               case 'user':

+                       $user = get_user_by( 'id', $object_id );

+                       if ( ! $user ) {

+                               break;

+                       }

+

+                       $object_subtype = 'user';

+                       break;

</ins><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">-        return $args;

</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ /**

+        * Filters the object subtype identifier for a non standard object type.

+        *

+        * The dynamic portion of the hook, `$object_type`, refers to the object

+        * type (post, comment, term, or user).

+        *

+        * @since 4.9.8

+        *

+        * @param string $object_subtype Empty string to override.

+        * @param int    $object_id      ID of the object to get the subtype for.

+        */

+       return apply_filters( "get_object_subtype_{$object_type}", $object_subtype, $object_id );

</ins><span class="cx" style="display: block; padding: 0 10px"> }

</span></span></pre></div>

<a id="branches49srcwpincludespostphp"></a>

<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: branches/4.9/src/wp-includes/post.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- branches/4.9/src/wp-includes/post.php     2018-07-19 12:16:47 UTC (rev 43509)

+++ branches/4.9/src/wp-includes/post.php       2018-07-19 18:48:52 UTC (rev 43510)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1884,6 +1884,39 @@

</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"> /**

<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ * Registers a meta key for posts.

+ *

+ * @since 4.9.8

+ *

+ * @param string $post_type Post type to register a meta key for. Pass an empty string

+ *                          to register the meta key across all existing post types.

+ * @param string $meta_key  The meta key to register.

+ * @param array  $args      Data used to describe the meta key when registered. See

+ *                          {@see register_meta()} for a list of supported arguments.

+ * @return bool True if the meta key was successfully registered, false if not.

+ */

+function register_post_meta( $post_type, $meta_key, array $args ) {

+       $args['object_subtype'] = $post_type;

+

+       return register_meta( 'post', $meta_key, $args );

+}

+

+/**

+ * Unregisters a meta key for posts.

+ *

+ * @since 4.9.8

+ *

+ * @param string $post_type Post type the meta key is currently registered for. Pass

+ *                          an empty string if the meta key is registered across all

+ *                          existing post types.

+ * @param string $meta_key  The meta key to unregister.

+ * @return bool True on success, false if the meta key was not previously registered.

+ */

+function unregister_post_meta( $post_type, $meta_key ) {

+       return unregister_meta_key( 'post', $meta_key, $post_type );

+}

+

+/**

</ins><span class="cx" style="display: block; padding: 0 10px">  * Retrieve post meta fields, based on post ID.

</span><span class="cx" style="display: block; padding: 0 10px">  *

</span><span class="cx" style="display: block; padding: 0 10px">  * The post meta fields are retrieved from the cache where possible,

</span></span></pre></div>

<a id="branches49srcwpincludesrestapifieldsclasswprestcommentmetafieldsphp"></a>

<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php</h4>

<pre class="diff"><span>

<span class="info" style="display: block; padding: 0 10px; color: #888">--- branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php        2018-07-19 12:16:47 UTC (rev 43509)

+++ branches/4.9/src/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php  2018-07-19 18:48:52 UTC (rev 43510)

</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -28,6 +28,17 @@

</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">        /**