wp_xmlrpc_server::login( string $username, string $password ): WP_User|false

Log user in.

Parameters
Return
Source
Hooks
Related
- Uses
- Used By
Changelog
User Contributed Notes

Parameters

$username string Required: User's username.
$password string Required: User's password.

Top ↑

Return

WP_User|false WP_User object if authentication passed, false otherwise

Top ↑

Source

File: wp-includes/class-wp-xmlrpc-server.php. View all references

public function login( $username, $password ) {
	if ( ! $this->is_enabled ) {
		$this->error = new IXR_Error( 405, sprintf( __( 'XML-RPC services are disabled on this site.' ) ) );
		return false;
	}

	if ( $this->auth_failed ) {
		$user = new WP_Error( 'login_prevented' );
	} else {
		$user = wp_authenticate( $username, $password );
	}

	if ( is_wp_error( $user ) ) {
		$this->error = new IXR_Error( 403, __( 'Incorrect username or password.' ) );

		// Flag that authentication has failed once on this wp_xmlrpc_server instance.
		$this->auth_failed = true;

		/**
		 * Filters the XML-RPC user login error message.
		 *
		 * @since 3.5.0
		 *
		 * @param IXR_Error $error The XML-RPC error message.
		 * @param WP_Error  $user  WP_Error object.
		 */
		$this->error = apply_filters( 'xmlrpc_login_error', $this->error, $user );
		return false;
	}

	wp_set_current_user( $user->ID );
	return $user;
}

View on Trac View on GitHub

Top ↑

Hooks

apply_filters( 'xmlrpc_login_error', IXR_Error $error, WP_Error $user )

Filters the XML-RPC user login error message.

Top ↑

Uses

Uses
Uses	Description
wp_authenticate() wp-includes/pluggable.php	Authenticates a user, confirming the login credentials are valid.
wp_set_current_user() wp-includes/pluggable.php	Changes the current user by ID or name.
IXR_Error::__construct() wp-includes/IXR/class-IXR-error.php	PHP5 constructor.
__() wp-includes/l10n.php	Retrieves the translation of $text.
apply_filters() wp-includes/plugin.php	Calls the callback functions that have been added to a filter hook.
is_wp_error() wp-includes/load.php	Checks whether the given variable is a WordPress Error.
WP_Error::__construct() wp-includes/class-wp-error.php	Initializes the error.

Show 5 more uses Hide more uses

Top ↑

Used By

Used By
Used By	Description
wp_xmlrpc_server::mt_getPostCategories() wp-includes/class-wp-xmlrpc-server.php	Retrieve post categories.
wp_xmlrpc_server::mt_setPostCategories() wp-includes/class-wp-xmlrpc-server.php	Sets categories for a post.
wp_xmlrpc_server::mt_publishPost() wp-includes/class-wp-xmlrpc-server.php	Sets a post’s publish status to ‘publish’.
wp_xmlrpc_server::mw_editPost() wp-includes/class-wp-xmlrpc-server.php	Edit a post.
wp_xmlrpc_server::mw_getPost() wp-includes/class-wp-xmlrpc-server.php	Retrieve post.
wp_xmlrpc_server::mw_getRecentPosts() wp-includes/class-wp-xmlrpc-server.php	Retrieve list of recent posts.
wp_xmlrpc_server::mw_getCategories() wp-includes/class-wp-xmlrpc-server.php	Retrieve the list of categories on a given blog.
wp_xmlrpc_server::mw_newMediaObject() wp-includes/class-wp-xmlrpc-server.php	Uploads a file, following your settings.
wp_xmlrpc_server::mt_getRecentPostTitles() wp-includes/class-wp-xmlrpc-server.php	Retrieve the post titles of recent posts.
wp_xmlrpc_server::mt_getCategoryList() wp-includes/class-wp-xmlrpc-server.php	Retrieve list of all categories on blog.
wp_xmlrpc_server::blogger_getUserInfo() wp-includes/class-wp-xmlrpc-server.php	Retrieve user’s data.
wp_xmlrpc_server::blogger_getPost() wp-includes/class-wp-xmlrpc-server.php	Retrieve post.
wp_xmlrpc_server::blogger_getRecentPosts() wp-includes/class-wp-xmlrpc-server.php	Retrieve list of recent posts.
wp_xmlrpc_server::blogger_newPost() wp-includes/class-wp-xmlrpc-server.php	Creates new post.
wp_xmlrpc_server::blogger_editPost() wp-includes/class-wp-xmlrpc-server.php	Edit a post.
wp_xmlrpc_server::blogger_deletePost() wp-includes/class-wp-xmlrpc-server.php	Remove a post.
wp_xmlrpc_server::mw_newPost() wp-includes/class-wp-xmlrpc-server.php	Create a new post.
wp_xmlrpc_server::wp_getOptions() wp-includes/class-wp-xmlrpc-server.php	Retrieve blog options.
wp_xmlrpc_server::wp_setOptions() wp-includes/class-wp-xmlrpc-server.php	Update blog options.
wp_xmlrpc_server::wp_getMediaItem() wp-includes/class-wp-xmlrpc-server.php	Retrieve a media item by ID
wp_xmlrpc_server::wp_getMediaLibrary() wp-includes/class-wp-xmlrpc-server.php	Retrieves a collection of media library items (or attachments)
wp_xmlrpc_server::wp_getPostFormats() wp-includes/class-wp-xmlrpc-server.php	Retrieves a list of post formats used by the site.
wp_xmlrpc_server::wp_getPostType() wp-includes/class-wp-xmlrpc-server.php	Retrieves a post type
wp_xmlrpc_server::wp_getPostTypes() wp-includes/class-wp-xmlrpc-server.php	Retrieves a post types
wp_xmlrpc_server::wp_getRevisions() wp-includes/class-wp-xmlrpc-server.php	Retrieve revisions for a specific post.
wp_xmlrpc_server::wp_restoreRevision() wp-includes/class-wp-xmlrpc-server.php	Restore a post revision
wp_xmlrpc_server::blogger_getUsersBlogs() wp-includes/class-wp-xmlrpc-server.php	Retrieve blogs that user owns.
wp_xmlrpc_server::wp_getComments() wp-includes/class-wp-xmlrpc-server.php	Retrieve comments.
wp_xmlrpc_server::wp_deleteComment() wp-includes/class-wp-xmlrpc-server.php	Delete a comment.
wp_xmlrpc_server::wp_editComment() wp-includes/class-wp-xmlrpc-server.php	Edit comment.
wp_xmlrpc_server::wp_newComment() wp-includes/class-wp-xmlrpc-server.php	Create new comment.
wp_xmlrpc_server::wp_getCommentStatusList() wp-includes/class-wp-xmlrpc-server.php	Retrieve all of the comment status.
wp_xmlrpc_server::wp_getCommentCount() wp-includes/class-wp-xmlrpc-server.php	Retrieve comment count.
wp_xmlrpc_server::wp_getPostStatusList() wp-includes/class-wp-xmlrpc-server.php	Retrieve post statuses.
wp_xmlrpc_server::wp_getPageStatusList() wp-includes/class-wp-xmlrpc-server.php	Retrieve page statuses.
wp_xmlrpc_server::wp_getPageTemplates() wp-includes/class-wp-xmlrpc-server.php	Retrieve page templates.
wp_xmlrpc_server::wp_getPages() wp-includes/class-wp-xmlrpc-server.php	Retrieve Pages.
wp_xmlrpc_server::wp_newPage() wp-includes/class-wp-xmlrpc-server.php	Create new page.
wp_xmlrpc_server::wp_deletePage() wp-includes/class-wp-xmlrpc-server.php	Delete page.
wp_xmlrpc_server::wp_editPage() wp-includes/class-wp-xmlrpc-server.php	Edit page.
wp_xmlrpc_server::wp_getPageList() wp-includes/class-wp-xmlrpc-server.php	Retrieve page list.
wp_xmlrpc_server::wp_getAuthors() wp-includes/class-wp-xmlrpc-server.php	Retrieve authors list.
wp_xmlrpc_server::wp_getTags() wp-includes/class-wp-xmlrpc-server.php	Get list of all tags
wp_xmlrpc_server::wp_newCategory() wp-includes/class-wp-xmlrpc-server.php	Create new category.
wp_xmlrpc_server::wp_deleteCategory() wp-includes/class-wp-xmlrpc-server.php	Remove category.
wp_xmlrpc_server::wp_suggestCategories() wp-includes/class-wp-xmlrpc-server.php	Retrieve category list.
wp_xmlrpc_server::wp_getComment() wp-includes/class-wp-xmlrpc-server.php	Retrieve comment.
wp_xmlrpc_server::wp_getPosts() wp-includes/class-wp-xmlrpc-server.php	Retrieve posts.
wp_xmlrpc_server::wp_newTerm() wp-includes/class-wp-xmlrpc-server.php	Create a new term.
wp_xmlrpc_server::wp_editTerm() wp-includes/class-wp-xmlrpc-server.php	Edit a term.
wp_xmlrpc_server::wp_deleteTerm() wp-includes/class-wp-xmlrpc-server.php	Delete a term.
wp_xmlrpc_server::wp_getTerm() wp-includes/class-wp-xmlrpc-server.php	Retrieve a term.
wp_xmlrpc_server::wp_getTerms() wp-includes/class-wp-xmlrpc-server.php	Retrieve all terms for a taxonomy.
wp_xmlrpc_server::wp_getTaxonomy() wp-includes/class-wp-xmlrpc-server.php	Retrieve a taxonomy.
wp_xmlrpc_server::wp_getTaxonomies() wp-includes/class-wp-xmlrpc-server.php	Retrieve all taxonomies.
wp_xmlrpc_server::wp_getUser() wp-includes/class-wp-xmlrpc-server.php	Retrieve a user.
wp_xmlrpc_server::wp_getUsers() wp-includes/class-wp-xmlrpc-server.php	Retrieve users.
wp_xmlrpc_server::wp_getProfile() wp-includes/class-wp-xmlrpc-server.php	Retrieve information about the requesting user.
wp_xmlrpc_server::wp_editProfile() wp-includes/class-wp-xmlrpc-server.php	Edit user’s profile.
wp_xmlrpc_server::wp_getPage() wp-includes/class-wp-xmlrpc-server.php	Retrieve page.
wp_xmlrpc_server::wp_newPost() wp-includes/class-wp-xmlrpc-server.php	Create a new post for any registered post type.
wp_xmlrpc_server::wp_editPost() wp-includes/class-wp-xmlrpc-server.php	Edit a post for any registered post type.
wp_xmlrpc_server::wp_deletePost() wp-includes/class-wp-xmlrpc-server.php	Delete a post for any registered post type.
wp_xmlrpc_server::wp_getPost() wp-includes/class-wp-xmlrpc-server.php	Retrieve a post.
wp_xmlrpc_server::wp_getUsersBlogs() wp-includes/class-wp-xmlrpc-server.php	Retrieve the blogs of the user.
wp_xmlrpc_server::login_pass_ok() wp-includes/class-wp-xmlrpc-server.php	Check user’s credentials. Deprecated.