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

Top ↑

See also

Top ↑

Parameters

$field string 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_id int|false Optional
User ID.

Default: false

Top ↑

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.

Top ↑

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 );
}

View on Trac View on GitHub

Top ↑

Hooks

Top ↑

Top ↑

Used By

Used By
Used By Description
the_author_icq() wp-includes/deprecated.php

Display the ICQ number of the author of the current post.
the_author_yim() wp-includes/deprecated.php

Display the Yahoo! IM name of the author of the current post.
the_author_msn() wp-includes/deprecated.php

Display the MSN address of the author of the current post.
the_author_aim() wp-includes/deprecated.php

Display the AIM address of the author of the current post.
the_author_url() wp-includes/deprecated.php

Display the URL to the home page of the author of the current post.
the_author_ID() wp-includes/deprecated.php

Display the ID of the author of the current post.
the_author_description() wp-includes/deprecated.php

Display the description of the author of the current post.
the_author_login() wp-includes/deprecated.php

Display the login name of the author of the current post.
the_author_firstname() wp-includes/deprecated.php

Display the first name of the author of the current post.
the_author_lastname() wp-includes/deprecated.php

Display the last name of the author of the current post.
the_author_nickname() wp-includes/deprecated.php

Display the nickname of the author of the current post.
the_author_email() wp-includes/deprecated.php

Display the email of the author of the current post.
Show 7 more used by Hide more used by

Top ↑

Changelog

Changelog
Version Description
2.8.0 Introduced.

Top ↑

User Contributed Notes

  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Advanced Uses
    A plugin may add an additional field in the registration or manage users, which adds a new value in the wp_usermeta (where wp_ 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” then

    <p><?php printf( __( 'This author’s Twitter name is %s', 'textdomain' ), get_the_author_meta( 'twitter' ) ); ?></p>

    would return:

    This author’s Twitter name is WordPress

You must log in before being able to contribute a note or feedback.