map_meta_cap( string $cap, int $user_id, mixed $args ): string[]

45function map_meta_cap( $cap, $user_id, ...$args ) {46	$caps = array();47 48	switch ( $cap ) {49		case 'remove_user':50			// In multisite the user must be a super admin to remove themselves.51			if ( isset( $args[0] ) && $user_id === (int) $args[0] && ! is_super_admin( $user_id ) ) {52				$caps[] = 'do_not_allow';53			} else {54				$caps[] = 'remove_users';55			}56			break;57		case 'promote_user':58		case 'add_users':59			$caps[] = 'promote_users';60			break;61		case 'edit_user':62		case 'edit_users':63			// Non-existent users can't edit users, not even themselves.64			if ( $user_id < 1 ) {65				$caps[] = 'do_not_allow';66				break;67			}68 69			// Allow user to edit themselves.70			if ( 'edit_user' === $cap && isset( $args[0] ) && $user_id === (int) $args[0] ) {71				break;72			}73 74			// In multisite the user must have manage_network_users caps. If editing a super admin, the user must be a super admin.75			if ( is_multisite() && ( ( ! is_super_admin( $user_id ) && 'edit_user' === $cap && is_super_admin( $args[0] ) ) || ! user_can( $user_id, 'manage_network_users' ) ) ) {76				$caps[] = 'do_not_allow';77			} else {78				$caps[] = 'edit_users'; // edit_user maps to edit_users.79			}80			break;81		case 'delete_post':82		case 'delete_page':83			if ( ! isset( $args[0] ) ) {84				if ( 'delete_post' === $cap ) {85					/* translators: %s: Capability name. */86					$message = __( 'When checking for the %s capability, you must always check it against a specific post.' );87				} else {88					/* translators: %s: Capability name. */89					$message = __( 'When checking for the %s capability, you must always check it against a specific page.' );90				}91 92				_doing_it_wrong(93					__FUNCTION__,94					sprintf( $message, '<code>' . $cap . '</code>' ),95					'6.1.0'96				);97 98				$caps[] = 'do_not_allow';99				break;100			}101 102			$post = get_post( $args[0] );103			if ( ! $post ) {104				$caps[] = 'do_not_allow';105				break;106			}107 108			if ( 'revision' === $post->post_type ) {109				$caps[] = 'do_not_allow';110				break;111			}112 113			if ( (int) get_option( 'page_for_posts' ) === $post->ID114				|| (int) get_option( 'page_on_front' ) === $post->ID115			) {116				$caps[] = 'manage_options';117				break;118			}119 120			$post_type = get_post_type_object( $post->post_type );121			if ( ! $post_type ) {122				/* translators: 1: Post type, 2: Capability name. */123				$message = __( '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.' );124