云策 WordPress 开发者社区

函数文档

is_user_admin()

查看官方原文 ↗
💡 云策文档标注

概述

is_user_admin() 函数用于判断当前请求是否在 WordPress 用户管理界面中，例如 /wp-admin/user/。它不检查用户角色或权限，仅针对界面位置。

关键要点

  • 函数返回布尔值：如果在用户管理页面内则返回 true，否则返回 false。
  • 不验证用户是否为管理员，检查角色和权限应使用 current_user_can()。
  • 内部实现基于 $GLOBALS['current_screen'] 或 WP_USER_ADMIN 常量。

代码示例

function is_user_admin() {
    if ( isset( $GLOBALS['current_screen'] ) ) {
        return $GLOBALS['current_screen']->in_admin( 'user' );
    } elseif ( defined( 'WP_USER_ADMIN' ) ) {
        return WP_USER_ADMIN;
    }

    return false;
}

注意事项

  • 该函数自 WordPress 3.1.0 版本引入。
  • 常用于插件或主题开发中，根据界面上下文调整行为。
📄 原文内容

Determines whether the current request is for a user admin screen.

Description

e.g. /wp-admin/user/

Does not check if the user is an administrator; use current_user_can() for checking roles and capabilities.

Return

bool True if inside WordPress user administration pages.

Source

function is_user_admin() {
	if ( isset( $GLOBALS['current_screen'] ) ) {
		return $GLOBALS['current_screen']->in_admin( 'user' );
	} elseif ( defined( 'WP_USER_ADMIN' ) ) {
		return WP_USER_ADMIN;
	}

	return false;
}

View all references View on Trac View on GitHub

Used by Description
wp_dashboard_right_now()wp-admin/includes/dashboard.php

Dashboard widget that displays some basic stats about the site.
wp_dashboard_setup()wp-admin/includes/dashboard.php

Registers dashboard widgets.
self_admin_url()wp-includes/link-template.php

Retrieves the URL to the admin area for either the current site or the network depending on context.
get_edit_profile_url()wp-includes/link-template.php

Retrieves the URL to the user’s profile editor.
WP_Admin_Bar::add_menus()wp-includes/class-wp-admin-bar.php

Adds menus to the admin bar.
wp_admin_bar_site_menu()wp-includes/admin-bar.php

Adds the “Site Name” menu.

Show 1 moreShow less

Changelog

Version Description
3.1.0 Introduced.