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 Description
See also See also
Parameters Parameters
- $field
-
(string) (Optional) Selects the field of the users record. See get_the_author_meta() for the list of possible fields.
Default value: ''
- $user_id
-
(int|false) (Optional) User ID.
Default value: false
More Information 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 Source
File: wp-includes/author-template.php
function the_author_meta( $field = '', $user_id = false ) {
$author_meta = get_the_author_meta( $field, $user_id );
/**
* 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 );
}
Expand full source code Collapse full source code View on Trac View on GitHub
Changelog Changelog
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |
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:
<?php $authorDesc = the_author_meta('description'); echo $authorDesc; ?>