Updated Wiki: $().SPServices.SPGetCurrentUser

Function

$().SPServices.SPGetCurrentUser

Certification

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.*

Functionality

This utility function, which is also publicly available, returns information about the current user.

How It Works

The SPGetCurrentUser function does an AJAX call to grab /_layouts/userdisp.aspx?Force=True and "scrapes" the values from the page based on the internal field name (aka StaticName).

Syntax

$().SPServices.SPGetCurrentUser({  webURL: "",		// Added in 2013.01
  fieldName: "Name",  fieldNames: {},     	// Added in v0.7.2 to allow multiple columns
  debug: false
});

webURL
URL of the target Site Collection.  If not specified, the current Web is used.

fieldName
You can specify which value from userdisp.aspx you'd like returned with this option. The default is the user's account (Name in theField Internal Name column below). You can specify any of theField Internal Names for option fieldName. The fields listed below are the default out-of-the-box fields. If you’ve got custom fields which are exposed on theuserdisp.aspx page, then you should be able to retrieve them with this function as well.

Note that, as of v0.6.1, you can also request the ID of the user by specifying fieldName: "ID".

Field Name	Field Internal Name	WSS	MOSS
Account	Name	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
Name	Title	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
Work e-mail	EMail	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
About me	Notes	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
Picture	Picture	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
Department	Department	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
Job Title	JobTitle	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
SIP Address	SipAddress	Image may be NSFW. Clik here to view.	Image may be NSFW. Clik here to view.
First name	FirstName		Image may be NSFW. Clik here to view.
Last Name	LastName		Image may be NSFW. Clik here to view.
Work phone	WorkPhone		Image may be NSFW. Clik here to view.
Office	Office		Image may be NSFW. Clik here to view.
User name	UserName		Image may be NSFW. Clik here to view.
Web site	WebSite		Image may be NSFW. Clik here to view.
Responsibilities	SPResponsibility		Image may be NSFW. Clik here to view.

fieldNames
Added in v0.7.2 to allow requesting multiple column values. The column names can be passed in as an array, such as ["ID", "Last Name"]

debug
Setting debug: true indicates that you would like to receive messages if anything obvious is wrong with the function call, like specifying a value which doesn't exist. I call this debug mode.

Examples

var thisUserAccount = $().SPServices.SPGetCurrentUser({
	fieldName: "Name",
	debug: false
}); 

var thisUserName = $().SPServices.SPGetCurrentUser({
	fieldName: "Title",
	debug: false
});

var thisUserID = $().SPServices.SPGetCurrentUser({
	fieldName: "ID",
	debug: false
});

var thisUsersValues = $().SPServices.SPGetCurrentUser({
	fieldNames: ["ID", "Name", "SIP Address"],
	debug: false
}); 

* Attested by Geoff Varosky