the_author_meta( string $field = '', int|false $user_id = false )
Outputs the field from the user’s DB object. Defaults to current post’s author.
Contents
Description
See also
Parameters
-
$fieldstring Optional -
Selects the field of the users record. See get_the_author_meta() for the list of possible fields.
More Arguments from get_the_author_meta( ... $field )
The user field to retrieve.Default:
'' -
$user_idint|false Optional -
User ID. Defaults to the current post author.
Default:
false
More Information
This template tag displays a desired meta data field for a user. Only one field is returned at a time, you need to specify which you want.
If this tag is used within The Loop, the user ID value need not be specified, and the displayed data is that of the current post author. A user ID can be specified if this tag is used outside The Loop.
If the meta field does not exist, nothing is printed.
NOTE: Use get_the_author_meta() if you need to return (and do something with) the field, rather than just display it.
For parameter $userID, if the user ID fields is used, then this function display the specific field for this user ID.
Source
File: wp-includes/author-template.php.
View all references
function the_author_meta( $field = '', $user_id = false ) {
$author_meta = get_the_author_meta( $field, $user_id );
/**
* Filters the value of the requested user metadata.
*
* The filter name is dynamic and depends on the $field parameter of the function.
*
* @since 2.8.0
*
* @param string $author_meta The value of the metadata.
* @param int|false $user_id The user ID.
*/
echo apply_filters( "the_author_{$field}", $author_meta, $user_id );
}
Hooks
-
apply_filters( "the_author_{$field}",
string $author_meta ,int|false $user_id ) -
Filters the value of the requested user metadata.
Changelog
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Display a User Email Address
Displays the email address for user ID 25.
Advanced Uses
A plugin may add an additional field in the registration or manage users, which adds a new value in the
wp_usermeta(wherewp_is your data base prefix. For this example we will use a Twitter ID if a plugin set meta_key value to “twitter” and meta_value to “wordpress” thenwould return:
This author’s Twitter name is WordPress
And if you actually want to show the Author description using this function you can just do: