Function Reference/get usermeta

This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists. See also wp-includes/deprecated.php. Use get_user_meta instead.

This page redirects to an external site: https://developer.wordpress.org/reference/functions/get_usermeta/

1 Description
2 Usage
3 Parameters
4 Example
5 Change Log
6 Source File
7 Related

Description

This function returns the value of a specific metakey pertaining to the user whose ID is passed via the userid parameter.

Version 2.9.2 currently requires the use of this function despite previous notes stating that it is deprecated. Using the new function causes undefined function error.

Usage

<?php get_usermeta( $userid, $metakey ); ?>

Parameters

$userid

(integer) (required) The ID of the user whose data should be retrieved.

Default: None

$metakey

(string) (required) The metakey value to be returned.

'metakey' The meta_key in the wp_usermeta table for the meta_value to be returned.

Default: None

Example

This example returns and then displays the last name for user id 9.

<?php $user_last = get_usermeta(9,'last_name'); ?>
<?php echo('User ID 9's last name: ' . $user_last . '\n'); ?>

User ID 9's last name: Jones

NOTE: If the meta value does not exist, the function will return an empty string or an empty array.

Change Log

Deprecated: 3.0.0
Since: 2.0.0

Codex