is_admin()

💡 云策文档标注

概述

is_admin() 函数用于判断当前请求是否针对 WordPress 管理界面页面。它不检查用户权限，仅基于请求上下文返回布尔值。

关键要点

返回 true 表示在 WordPress 管理界面内，否则返回 false
不验证用户角色或能力，需使用 current_user_can() 进行权限检查
在主题定制器视图中返回 false，应使用 is_customize_preview() 检测
在块编辑器环境中可能返回 false，需注意相关兼容性问题
加载顺序较早，可在主题 functions.php 或插件中直接使用，无需等待主查询运行
对于通过 wp-admin/admin-ajax.php 的 Ajax 请求返回 true，但自定义 Ajax 端点可能例外

代码示例

if ( ! is_admin() ) {
    // 仅在非管理界面（如主题模板）中运行
    echo 'Welcome to our website.';
} else {
    // 仅在管理界面（如插件文件）中运行
    echo 'Welcome to your Admin Panels.';
}

注意事项

避免依赖 is_admin() 进行用户权限验证，应结合 current_user_can()
在主题定制器或块编辑器等特殊上下文中，行为可能不符合预期，需使用专用函数检测
Ajax 请求的返回值取决于是否通过标准 admin-ajax.php 端点，自定义实现可能影响结果

📄 原文内容

Determines whether the current request is for an administrative interface page.

Description

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

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Return

bool True if inside WordPress administration interface, false otherwise.

Source

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

	return false;
}

View all references View on Trac View on GitHub

Used by	Description
wp_should_load_block_assets_on_demand()`wp-includes/script-loader.php`	Checks whether block styles should be loaded only on-render.
WP_Plugin_Dependencies::get_dependency_api_data()`wp-includes/class-wp-plugin-dependencies.php`	Retrieves and stores dependency plugin data from the WordPress.org Plugin API.
wp_enqueue_emoji_styles()`wp-includes/formatting.php`	Enqueues the important emoji-related styles.
wp_enqueue_admin_bar_header_styles()`wp-includes/admin-bar.php`	Enqueues inline style to hide the admin bar when printing.
WP_Font_Face::__construct()`wp-includes/fonts/class-wp-font-face.php`	Creates and initializes an instance of WP_Font_Face.
wp_get_loading_optimization_attributes()`wp-includes/media.php`	Gets loading optimization attributes.
_wp_theme_json_webfonts_handler()`wp-includes/deprecated.php`	Runs the theme.json webfonts handler.
wp_global_styles_render_svg_filters()`wp-includes/deprecated.php`	Renders the SVG filters supplied by theme.json.
wp_get_loading_attr_default()`wp-includes/deprecated.php`	Gets the default value to use for a `loading` attribute on an element.
wp_admin_bar_edit_site_menu()`wp-includes/admin-bar.php`	Adds the “Edit Site” link to the Toolbar.
wp_should_load_separate_core_block_assets()`wp-includes/script-loader.php`	Checks whether separate styles should be loaded for core blocks.
wp_get_inline_script_tag()`wp-includes/script-loader.php`	Constructs an inline script tag.
wp_sanitize_script_attributes()`wp-includes/script-loader.php`	Sanitizes an attributes array into an attributes string to be placed inside a tag.
wp_get_script_tag()`wp-includes/script-loader.php`	Formats loader tags.
wp_is_site_protected_by_basic_auth()`wp-includes/load.php`	Checks if this site is protected by HTTP Basic Auth.
WP_REST_Site_Health_Controller::load_admin_textdomain()`wp-includes/rest-api/endpoints/class-wp-rest-site-health-controller.php`	Loads the admin textdomain for Site Health tests.
is_protected_endpoint()`wp-includes/load.php`	Determines whether we are currently on an endpoint that should be protected against WSODs.
WP_Fatal_Error_Handler::handle()`wp-includes/class-wp-fatal-error-handler.php`	Runs the shutdown handler.
WP_Site_Health::check_wp_version_check_exists()`wp-admin/includes/class-wp-site-health.php`	Tests whether `wp_version_check` is blocked.
determine_locale()`wp-includes/l10n.php`	Determines the current locale desired for the request.
wp_common_block_scripts_and_styles()`wp-includes/script-loader.php`	Handles the enqueueing of block scripts and styles that are common to both the editor and the front-end.
wp_enqueue_registered_block_scripts_and_styles()`wp-includes/script-loader.php`	Enqueues registered block scripts and styles, depending on current rendered context (only enqueuing editor scripts while in context of the editor).
use_block_editor_for_post()`wp-includes/post.php`	Returns whether the post can be edited in the block editor.
wp_add_privacy_policy_content()`wp-admin/includes/plugin.php`	Declares a helper function for adding content to the Privacy Policy Guide.
WP_Customize_Manager::establish_loaded_changeset()`wp-includes/class-wp-customize-manager.php`	Establishes the loaded changeset.
_WP_Editors::enqueue_default_editor()`wp-includes/class-wp-editor.php`	Enqueue all editor scripts.
WP_Taxonomy::set_props()`wp-includes/class-wp-taxonomy.php`	Sets taxonomy properties.
WP_Taxonomy::add_rewrite_rules()`wp-includes/class-wp-taxonomy.php`	Adds the necessary rewrite rules for the taxonomy.
WP_Post_Type::add_rewrite_rules()`wp-includes/class-wp-post-type.php`	Adds the necessary rewrite rules for the post type.
WP_Post_Type::set_props()`wp-includes/class-wp-post-type.php`	Sets post type properties.
get_rest_url()`wp-includes/rest-api.php`	Retrieves the URL to a REST endpoint on a site.
wp_admin_bar_customize_menu()`wp-includes/admin-bar.php`	Adds the “Customize” link to the Toolbar.
WP_Customize_Nav_Menu_Item_Setting::sort_wp_get_nav_menu_items()`wp-includes/customize/class-wp-customize-nav-menu-item-setting.php`	Re-apply the tail logic also applied on $items by wp_get_nav_menu_items() .
WP_Customize_Manager::wp_loaded()`wp-includes/class-wp-customize-manager.php`	Registers styles/scripts and initialize the preview of each setting
WP_Customize_Manager::wp_redirect_status()`wp-includes/class-wp-customize-manager.php`	Prevents Ajax requests from following redirects when previewing a theme by issuing a 200 response instead of a 30x.
WP_Styles::__construct()`wp-includes/class-wp-styles.php`	Constructor.
remove_editor_styles()`wp-includes/theme.php`	Removes all visual editor stylesheets.
_custom_header_background_just_in_time()`wp-includes/theme.php`	Registers the internal custom header and background routines.
_wp_customize_include()`wp-includes/theme.php`	Includes and instantiates the WP_Customize_Manager class.
switch_theme()`wp-includes/theme.php`	Switches the theme.
get_theme_mods()`wp-includes/theme.php`	Retrieves all theme modifications.
load_default_textdomain()`wp-includes/l10n.php`	Loads default translated strings based on locale.
wp_heartbeat_settings()`wp-includes/general-template.php`	Default settings for heartbeat.
wp_admin_bar_dashboard_view_site_menu()`wp-includes/deprecated.php`	Add the “Dashboard”/”Visit Site” menu.
WP_Theme::get_allowed_on_site()`wp-includes/class-wp-theme.php`	Returns array of stylesheet names of themes allowed on the site.
WP::handle_404()`wp-includes/class-wp.php`	Set the Headers for 404, if nothing is found for requested URL.
WP::parse_request()`wp-includes/class-wp.php`	Parses the request to find the correct WordPress query.
WP_Query::parse_query()`wp-includes/class-wp-query.php`	Parses a query string and sets query type booleans.
wp_deregister_script()`wp-includes/functions.wp-scripts.php`	Removes a registered script.
wp_auth_check_load()`wp-includes/functions.php`	Loads the auth check for monitoring whether the user is still logged in.
wp_widget_rss_output()`wp-includes/widgets.php`	Displays the RSS entries in a list.
get_pagenum_link()`wp-includes/link-template.php`	Retrieves the link for a page number.
WP_Admin_Bar::_render()`wp-includes/class-wp-admin-bar.php`
wp_admin_bar_sidebar_toggle()`wp-includes/admin-bar.php`	Adds the sidebar toggle button.
wp_admin_bar_site_menu()`wp-includes/admin-bar.php`	Adds the “Site Name” menu.
wp_admin_bar_edit_menu()`wp-includes/admin-bar.php`	Provides an edit link for posts and terms.
wp_admin_bar_search_menu()`wp-includes/admin-bar.php`	Adds search form.
is_admin_bar_showing()`wp-includes/admin-bar.php`	Determines whether the admin bar should be showing.
wp_user_settings()`wp-includes/option.php`	Saves and restores user interface settings stored in a cookie.
get_post_class()`wp-includes/post-template.php`	Retrieves an array of the class names for the post container element.
get_the_title()`wp-includes/post-template.php`	Retrieves the post title.
wp_enqueue_media()`wp-includes/media.php`	Enqueues all scripts, styles, settings, and templates necessary to use all media JS APIs.
wp_video_shortcode()`wp-includes/media.php`	Builds the Video shortcode output.
image_constrain_size_for_editor()`wp-includes/media.php`	Scales down the default size of an image.
wp_get_attachment_url()`wp-includes/post.php`	Retrieves the URL for an attachment.
redirect_canonical()`wp-includes/canonical.php`	Redirects incoming links to the proper URL based on the site url.
ms_not_installed()`wp-includes/ms-load.php`	Displays a failure message.
_post_format_request()`wp-includes/post-formats.php`	Filters the request to allow for the format prefix.
wp_get_nav_menu_items()`wp-includes/nav-menu.php`	Retrieves all menu items of a navigation menu.
dynamic_sidebar()`wp-includes/widgets.php`	Displays dynamic sidebar.
wp_get_sidebars_widgets()`wp-includes/widgets.php`	Retrieves the full list of sidebars and their widget instance IDs.
wp_convert_widget_settings()`wp-includes/widgets.php`	Converts the widget settings from single to multi-widget format.
WP_Customize_Widgets::schedule_customize_register()`wp-includes/class-wp-customize-widgets.php`	Ensures widgets are available for all types of previews.
script_concat_settings()`wp-includes/script-loader.php`	Determines the concatenation and compression settings for scripts and styles.
wp_default_scripts()`wp-includes/script-loader.php`	Registers all WordPress scripts.
_WP_Editors::editor_settings()`wp-includes/class-wp-editor.php`
_WP_Editors::editor_js()`wp-includes/class-wp-editor.php`	Print (output) the TinyMCE configuration and initialization scripts.

Show 72 more Show less

Changelog

Version	Description
1.5.1	Introduced.

User Contributed Notes

Skip to note 7 content

Ken Dirschl

11 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 13You must log in to vote on the helpfulness of this note

Be aware that ‘is_admin() ’ will return ‘false’ while in the theme customizer view, despite essentially being in the admin dashboard. To test for the customizer, use ‘is_customize_preview() ’.

Log in to add feedback

Skip to note 8 content

hearvox

10 years ago

Example:

if ( ! is_admin() ) {
    // Runs only if this PHP code is in a file that displays outside the admin panels, like the theme template.
    echo '<div style="text-align: center">Welcome to our website.</div>';
} else {
    // Runs only if this code is in a file that displays inside the admin panels, like a plugin file.
    echo '<div style="text-align: center">Welcome to your Admin Panels.</div>';
}

Skip to note 9 content

Steven Lin

6 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Migrate from Codex:
```
if ( ! is_admin() ) {
    echo "You are viewing the theme";
} else {
    echo "You are viewing the WordPress Administration Panels";
}
```
Log in to add feedback
Skip to note 10 content

theMikeD

5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Note that is_admin() will return false when using the block editor. See https://core.trac.wordpress.org/ticket/47394

Log in to add feedback
Skip to note 11 content

Zach Adams

2 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Note that is_admin() is available much earlier in the WordPress load sequence than other Conditional Tags and can be used before the main query has been run. This means it can be used in both the Theme functions.php file and in Plugins without needing to hook into an action or filter that triggers later.

Log in to add feedback
Skip to note 12 content

Gary Jones

4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

is_admin() returns true for Ajax requests, since <a href="https://github.com/WordPress/WordPress/blob/master/wp-admin/admin-ajax.php" rel="nofollow ugc">wp-admin/admin-ajax.php</a> defines the WP_ADMIN constant as true.
- That’s valuable information but not “absolute”. There are plugins that define their own Ajax endpoints and don’t come in through admin-ajax. An example I’ve seen is with JWT auth requests. So unless those specific plugins are hooked by a local function on auth success, so that WP_ADMIN can be defined outside of that code, is_admin() may still return false for these kinds of Ajax requests.
  
  Tony G 4 years ago
Log in to add feedback

云策 WordPress 开发者社区

函数文档

is_admin()

概述

关键要点

代码示例

注意事项

Description

Return

Source

Changelog

User Contributed Notes

函数文档

概述

关键要点

代码示例

注意事项

Description

Return

Source

Related

Changelog

User Contributed Notes