Outputs the field from the user’s DB object. Defaults to current post’s author.
$fieldstringoptional
Default:''
$user_idint|falseoptional
Default:false
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.
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 );
}
Filters the value of the requested user metadata.
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |
© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/the_author_meta