is_user_logged_in()

Determines whether the current visitor is a logged in user.

Contents

Description Description

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

Top ↑

Return Return

(bool) True if user is logged in, false if not logged in.

Top ↑

Source Source

File: wp-includes/pluggable.php 

	function is_user_logged_in() {
		$user = wp_get_current_user();

		return $user->exists();
	}

Expand full source code Collapse full source code View on Trac

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/block-template.php: locate_block_template()

Find a block template with equal or higher specificity than a given PHP template file.
wp-includes/block-template.php: get_the_block_template_html()

Returns the markup for the current template.
wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php: WP_REST_Application_Passwords_Controller::get_user()

Gets the requested user.
wp-includes/class-wp-recovery-mode.php: WP_Recovery_Mode::handle_exit_recovery_mode()

Handles a request to exit Recovery Mode.
wp-admin/includes/class-wp-site-health.php: WP_Site_Health::check_wp_version_check_exists()

Test if wp_version_check is blocked.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::handle_dismiss_autosave_or_lock_request()

Delete a given auto-draft changeset or the autosave revision for a given changeset or delete changeset lock.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::handle_changeset_trash_request()

Handle request to trash a changeset.
wp-includes/general-template.php: wp_enqueue_code_editor()

Enqueue assets needed by the code editor for the given settings.
wp-includes/rest-api.php: rest_authorization_required_code()

Returns a contextual HTTP error code for authorization failure.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::changeset_data()

Get changeset data.
wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php: WP_REST_Comments_Controller::create_item_permissions_check()

Checks if a given request has access to create a comment.
wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php: WP_REST_Comments_Controller::create_item()

Creates a comment.
wp-includes/comment.php: wp_check_comment_flood()

Checks whether comment flooding is occurring.
wp-includes/rest-api.php: rest_send_cors_headers()

Sends Cross-Origin Resource Sharing headers with API requests.
wp-includes/rest-api.php: rest_cookie_check_errors()

Checks for errors when using cookie-based authentication.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::customize_pane_settings()

Print JavaScript settings for parent window.
wp-includes/rest-api/class-wp-rest-server.php: WP_REST_Server::serve_request()

Handles serving a REST API request.
wp-includes/user.php: retrieve_password()

Handles sending a password retrieval email to a user.
wp-signup.php: validate_another_blog_signup()

Validate a new site signup for an existing user.
wp-signup.php: show_blog_form()

Generates and displays the Signup and Create Site forms
wp-signup.php: validate_blog_form()

Validate the new site signup
wp-admin/includes/ms.php: _access_denied_splash()

Displays an access denied message when a user tries to view a site’s dashboard they do not have access to.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::save()

Handle customize_save WP Ajax request to save/update a changeset.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::setup_theme()

Start preview and customize theme.
wp-includes/general-template.php: wp_heartbeat_settings()

Default settings for heartbeat
wp-includes/general-template.php: user_can_richedit()

Whether the user can access the visual editor.
wp-includes/general-template.php: wp_loginout()

Display the Log In/Out link.
wp-includes/general-template.php: wp_register()

Display the Registration or Admin link.
wp-includes/class-wp.php: WP::send_headers()

Sends additional HTTP headers for caching, content type, etc.
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieves an array of posts based on query variables.
wp-includes/class-wp-query.php: WP_Query::parse_search()

Generates SQL for the WHERE clause based on passed search terms.
wp-includes/functions.php: wp_auth_check()

Check whether a user is still logged in, for the heartbeat.
wp-includes/functions.php: wp_auth_check_load()

Load the auth check for monitoring whether the user is still logged in.
wp-includes/link-template.php: get_adjacent_post()

Retrieves the adjacent post.
wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::_render()
wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::initialize()
wp-includes/admin-bar.php: wp_admin_bar_site_menu()

Add the “Site Name” menu.
wp-includes/admin-bar.php: wp_admin_bar_my_sites_menu()

Add the “My Sites/[Site Name]” menu and all submenus.
wp-includes/admin-bar.php: is_admin_bar_showing()

Determines whether the admin bar should be showing.
wp-includes/post-template.php: get_body_class()

Retrieves an array of the class names for the body element.
wp-includes/post.php: get_posts_by_author_sql()

Retrieve the post SQL based on capability, author, and type.
wp-includes/post.php: _count_posts_cache_key()

Return the cache key for wp_count_posts() based on the passed arguments.
wp-includes/post.php: wp_count_posts()

Count number of posts of a post type and if user has permissions to view.
wp-includes/comment-template.php: get_post_reply_link()

Retrieves HTML content for reply to post link.
wp-includes/comment-template.php: wp_list_comments()

Displays a list of comments.
wp-includes/comment-template.php: comment_form()

Outputs a complete commenting form for use within a template.
wp-includes/comment-template.php: comments_template()

Loads the comment template specified in $file.
wp-includes/comment-template.php: get_comment_reply_link()

Retrieves HTML content for reply to comment link.
wp-includes/class-wp-customize-widgets.php: WP_Customize_Widgets::wp_ajax_update_widget()

Updates widget settings asynchronously.
wp-includes/comment.php: get_page_of_comment()

Calculate what page number a comment will appear on for comment paging.
Show 45 more used by Hide more used by

Top ↑

Changelog Changelog

Changelog
Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 12You must log in to vote on the helpfulness of this note
    Contributed by Marco Panichi —

    Please note that is_user_logged_in is a pluggable function and you could get a fatal error if you call it too early.

    To solve this problem, you can wrap the login check within a function hooked to the init action:

    function example_function()
{
	if ( is_user_logged_in() ) 
	{
		// code
	}
}
add_action('init', 'example_function');
  3. Skip to note 3 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note
    Contributed by Zain Neil B Ul Abadin —

    Example: In case somebody want to add login and logout link in the template somewhere.

     		
<?php if ( is_user_logged_in() ) { ?>
    <a href="<?php echo wp_logout_url(); ?>">Logout</a>
<?php } else { ?>
    <a href="/wp-login.php" title="Members Area Login" rel="home">Members Area</a>
<?php } ?>
  4. Skip to note 4 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
    Contributed by WP Sites - Brad Dalton —

    Example: From your functions file, this code displays a personal message for logged in users.

    /**
 * Give a personalized message for logged in users and a generic one for anonymous visitors
 */
function wpdocs_personal_message_when_logged_in() {
	if ( is_user_logged_in() ) {
		$current_user = wp_get_current_user();
		printf( 'Personal Message For %s!', esc_html( $current_user->user_firstname ) );
	} else {
		echo( 'Non-Personalized Message!' );
	}
}
add_action( 'loop_start', 'wpdocs_personal_message_when_logged_in' );
  5. Skip to note 5 content
    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
    Contributed by Arslan — 
    /**
 * Redirect to Home page if user attempts to try go to login if logged in
 * @author Arslan <[email protected]>
 * @return void
 */
function redirect_to() {
	global $pagenow;

	if ( !is_customize_preview() && is_user_logged_in() && 'index.php' !== $pagenow ) {
		wp_redirect( home_url(), 302 );
		exit();
	}
}
  6. Skip to note 6 content
    You must log in to vote on the helpfulness of this noteVote results for this note: -8You must log in to vote on the helpfulness of this note
    Contributed by jonburnaby —

    This function is more accurate if used at, or after, the ‘template_redirect’ Action. Before that, under unusual circumstances, it will give unexpected results.

    The most common case is for a Site Address (URL) without a “www.” when an http:// request is received with a “www.” specified.

    Background: between the ‘wp’ and ‘template_redirect’ Action, the Rewrite rules are applied for Pretty Permalinks. During this process, $_SERVER[‘SERVER_NAME’] is corrected in the common case listed above by removing “www.”

You must log in before being able to contribute a note or feedback.