Ticket #38323: 38323.7.wrappers.diff

src/wp-includes/comment.php

@@ -513 +513 @@
 }
 
 /**
+ * Registers a meta key for comments.
+ *
+ * @since 5.0.0
+ *
+ * @param string $comment_type Comment type to register a meta key for. Pass an empty string
+ *                             to register the meta key across all existing comment 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_comment_meta( $comment_type, $meta_key, array $args ) {
+        $args['object_subtype'] = $comment_type;
+
+        return register_meta( 'comment', $meta_key, $args );
+}
+
+/**
+ * Unregisters a meta key for comments.
+ *
+ * @since 5.0.0
+ *
+ * @param string $comment_type Comment type the meta key is currently registered for. Pass
+ *                             an empty string if the meta key is registered across all
+ *                             existing comment 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_comment_meta( $comment_type, $meta_key ) {
+        return unregister_meta_key( 'comment', $meta_key, $comment_type );
+}
+
+/**
  * Queues comments for metadata lazy-loading.
  *
  * @since 4.5.0

src/wp-includes/post.php

@@ -1990 +1990 @@
 }
 
 /**
+ * Registers a meta key for posts.
+ *
+ * @since 5.0.0
+ *
+ * @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 5.0.0
+ *
+ * @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 );
+}
+
+/**
  * Retrieve post meta fields, based on post ID.
  *
  * The post meta fields are retrieved from the cache where possible,

src/wp-includes/taxonomy.php

@@ -1323 +1323 @@
 }
 
 /**
+ * Registers a meta key for terms.
+ *
+ * @since 5.0.0
+ *
+ * @param string $taxonomy Taxonomy to register a meta key for. Pass an empty string
+ *                         to register the meta key across all existing taxonomies.
+ * @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_term_meta( $taxonomy, $meta_key, array $args ) {
+        $args['object_subtype'] = $taxonomy;
+
+        return register_meta( 'term', $meta_key, $args );
+}
+
+/**
+ * Unregisters a meta key for terms.
+ *
+ * @since 5.0.0
+ *
+ * @param string $taxonomy Taxonomy the meta key is currently registered for. Pass
+ *                         an empty string if the meta key is registered across all
+ *                         existing taxonomies.
+ * @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_term_meta( $taxonomy, $meta_key ) {
+        return unregister_meta_key( 'term', $meta_key, $taxonomy );
+}
+
+/**
  * Determines whether a term exists.
  *
  * Formerly is_term(), introduced in 2.3.0.

src/wp-includes/user.php

@@ -857 +857 @@
 }
 
 /**
+ * Registers a meta key for users.
+ *
+ * @since 5.0.0
+ *
+ * @param string $user_type User type to register a meta key for. Pass an empty string
+ *                          to register the meta key across all existing user 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_user_meta( $user_type, $meta_key, array $args ) {
+        $args['object_subtype'] = $user_type;
+
+        return register_meta( 'user', $meta_key, $args );
+}
+
+/**
+ * Unregisters a meta key for users.
+ *
+ * @since 5.0.0
+ *
+ * @param string $user_type User type the meta key is currently registered for. Pass
+ *                          an empty string if the meta key is registered across all
+ *                          existing user 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_user_meta( $user_type, $meta_key ) {
+        return unregister_meta_key( 'user', $meta_key, $user_type );
+}
+
+/**
  * Count number of users who have each of the user roles.
  *
  * Assumes there are neither duplicated nor orphaned capabilities meta_values.