diff --git a/wp-includes/capabilities.php b/wp-includes/capabilities.php index 6b1a67295a..7d362b5525 100644 --- a/wp-includes/capabilities.php +++ b/wp-includes/capabilities.php @@ -314,45 +314,43 @@ function map_meta_cap( $cap, $user_id ) { if ( $meta_key && $has_filter ) { /** - * Filters whether the user is allowed to edit meta. + * Filters whether the user is allowed to edit meta for specific object types. * - * 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. + * 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 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. + * @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 array $caps User capabilities. */ $allowed = apply_filters( "auth_{$object_type}_meta_{$meta_key}", false, $meta_key, $object_id, $user_id, $cap, $caps ); /** - * Filters whether the user is allowed to add post meta to a post of a given type. + * Filters whether the user is allowed to edit meta for specific object types/subtypes. * - * 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. + * 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.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. + * @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 array $caps User capabilities. */ $allowed = apply_filters( "auth_{$object_type}_{$sub_type}_meta_{$meta_key}", $allowed, $meta_key, $object_id, $user_id, $cap, $caps ); diff --git a/wp-includes/version.php b/wp-includes/version.php index a89eb77775..9dd8266a26 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '5.0-alpha-42808'; +$wp_version = '5.0-alpha-42809'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.