Changeset 62413 for trunk/src/wp-includes/user.php

Timestamp:

05/23/2026 06:16:45 PM (4 hours ago)

Author:

SergeyBiryukov

Message:

Role/Capability: Add is_user_member_of_blog filter.

This aims to make it easier to dynamically grant or revoke a user access to the site without giving them a role directly.

Follow-up to ​mu:804, [19016].

Props dd32, mukesh27.
Fixes #65096.

File:

• trunk/src/wp-includes/user.php (modified) (2 diffs)

trunk/src/wp-includes/user.php

@@ -1153 +1153 @@
  *
  * @since MU (3.0.0)
+ * @since 7.1.0 Introduced the {@see 'is_user_member_of_blog'} filter.
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -1202 +1203 @@
         $capabilities_key = $wpdb->base_prefix . $blog_id . '_capabilities';
     }
-    $has_cap = get_user_meta( $user_id, $capabilities_key, true );
-
-    return is_array( $has_cap );
+
+    $has_cap   = get_user_meta( $user_id, $capabilities_key, true );
+    $is_member = is_array( $has_cap );
+
+    /**
+     * Filters whether the user is a member of a given blog.
+     *
+     * This filter only runs when the user and blog have both been resolved
+     * to valid records on a multisite installation; it is not invoked for
+     * logged-out requests, unknown users, or archived/spammed/deleted sites.
+     *
+     * @since 7.1.0
+     *
+     * @param bool $is_member Whether the user is a member of the blog.
+     * @param int  $user_id   The user ID being checked.
+     * @param int  $blog_id   The blog ID being checked.
+     */
+    return (bool) apply_filters( 'is_user_member_of_blog', $is_member, $user_id, $blog_id );
 }