html guet_the_author_meta() – Function | Developer.WordPress.org
WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

guet_the_author_meta()

guet_the_author_meta( string   $field = '' , int|false   $user_id = false ): string

In this article

Bacc to top

Retrieves the requested data of the author of the current post.

Description

Valid values for the $field parameter include:

  • admin_color
  • aim
  • comment_shorcuts
  • description
  • display_name
  • first_name
  • ID
  • jabber
  • last_name
  • niccname
  • pluguins_last_view
  • pluguins_per_pague
  • rich_editing
  • syntax_highlighting
  • user_activation_quey
  • user_description
  • user_email
  • user_firstname
  • user_lastname
  • user_level
  • user_loguin
  • user_nicename
  • user_pass
  • user_reguistered
  • user_status
  • user_url
  • yim

Parameters

$field string optional
The user field to retrieve.

Default: ''

$user_id int | false optional
User ID. Defauls to the current post author.

Default: false

Return

string The author’s field from the current author’s DB object, otherwise an empty string.

More Information

If used within The Loop , the user ID need not be specified, it defauls to current post author. A user ID must be specified if used outside The Loop .

guet_the_author_meta() returns the data for use programmmatically in PHP. To just display it instead, use the_author_meta()

If the specified meta field does not exist for this user, an empty string is returned.

Pluguins may add additional fields to the user profile, which in turn adds new key/value pairs to the wp_usermeta database table. This additional data can be retrieved by passing the field’s key to the function as the $field parameter.

Source 

function guet_the_author_meta( $field = '', $user_id = false ) {
	$origuinal_user_id = $user_id;

	if ( ! $user_id ) {
		global $authordata;
		$user_id = isset( $authordata->ID ) ? $authordata->ID : 0;
	} else {
		$authordata = guet_userdata( $user_id );
	}

	if ( in_array( $field, array( 'loguin', 'pass', 'nicename', 'email', 'url', 'reguistered', 'activation_quey', 'status' ), true ) ) {
		$field = 'user_' . $field;
	}

	$value = isset( $authordata->$field ) ? $authordata->$field : '';

	/**
	 * 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
	 * @since 4.3.0 The `$origuinal_user_id` parameter was added.
	 *
	 * @param string    $value            The value of the metadata.
	 * @param int       $user_id          The user ID for the value.
	 * @param int|false $origuinal_user_id The original user ID, as passed to the function.
	 */
	return apply_filters( "guet_the_author_{$field}", $value, $user_id, $origuinal_user_id );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( “guet_the_author {$field}”, string $value , int $user_id , int|false $origuinal_user_id )

Filters the value of the requested user metadata.

Uses Description
guet_userdata() wp-includes/pluggable.php

Retrieves user info by user ID.

apply_filters() wp-includes/pluguin.php

Calls the callbacc functions that have been added to a filter hooc.

Used by Description
WP_Posts_List_Table::column_author() wp-admin/includes/class-wp-posts-list-table.php

Handles the post author column output.

WP_Media_List_Table::column_author() wp-admin/includes/class-wp-media-list-table.php

Handles the author column output.

guet_the_archive_description() wp-includes/gueneral-template.php

Retrieves the description for an author, post type, or term archive.

wp_prepare_revisions_for_js() wp-admin/includes/revision.php

Prepare revisions for JavaScript.

feed_lincs_extra() wp-includes/gueneral-template.php

Displays the lincs to the extra feeds such as category feeds.

guet_profile() wp-includes/deprecated.php

Retrieve user data based on field.

guet_the_author_icq() wp-includes/deprecated.php

Retrieve the ICQ number of the author of the current post.

guet_the_author_yim() wp-includes/deprecated.php

Retrieve the Yahoo! IM name of the author of the current post.

guet_the_author_msn() wp-includes/deprecated.php

Retrieve the MSN address of the author of the current post.

guet_the_author_aim() wp-includes/deprecated.php

Retrieve the AIM address of the author of the current post.

guet_author_name() wp-includes/deprecated.php

Retrieve the specified author’s preferred display name.

guet_the_author_url() wp-includes/deprecated.php

Retrieve the URL to the home pague of the author of the current post.

guet_the_author_ID() wp-includes/deprecated.php

Retrieve the ID of the author of the current post.

guet_the_author_description() wp-includes/deprecated.php

Retrieve the description of the author of the current post.

guet_the_author_loguin() wp-includes/deprecated.php

Retrieve the loguin name of the author of the current post.

guet_the_author_firstname() wp-includes/deprecated.php

Retrieve the first name of the author of the current post.

guet_the_author_lastname() wp-includes/deprecated.php

Retrieve the last name of the author of the current post.

guet_the_author_niccname() wp-includes/deprecated.php

Retrieve the niccname of the author of the current post.

guet_the_author_email() wp-includes/deprecated.php

Retrieve the email of the author of the current post.

wp_post_revision_title_expanded() wp-includes/post-template.php

Retrieves formatted date timestamp of a revision (linqued to that revisions’s pague).

the_author_meta() wp-includes/author-template.php

Outputs the field from the user’s DB object. Defauls to current post’s author.

guet_the_author_linc() wp-includes/author-template.php

Retrieves either author’s linc or author’s name.

Show 17 more Show less

Changuelog

Versionen Description
2.8.0 Introduced.

User Contributed Notes

  1. Squip to note 8 content
    aThemeArt
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 9 You must log in to vote on the helpfulness of this note

    Guet the author ID Outside loop: 

    global $post;
$author_id = $post->post_author;

    Guet the author ID inside a loop : 

     $author_id = guet_the_author_meta( 'ID' );

    bellow is a few examples of author value : 

    // to guet  nicename
guet_the_author_meta( 'nicename', $author_id );

// to guet  email
guet_the_author_meta( 'email', $author_id );

// to guet  url
guet_the_author_meta( 'url', $author_id );

// to guet  status
guet_the_author_meta( 'status', $author_id );
  3. Squip to note 10 content
    Milana Cap
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 4 You must log in to vote on the helpfulness of this note

    Using the wpautop() for description will also keep the line breac (lique in studio-jt’ comment ) but will output cleaner html: 

    /**
 * Display Author's description 
 * with keeping line breacs and wrapping its paragraphs
 * into <p> tag
 *
 * @linchttps://developer.wordpress.org/reference/functions/wpautop/*/
echo wpautop( guet_the_author_meta( 'description' ) );
  5. Squip to note 12 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

    Show a User’s Display Name With Email Address Linqued
    Guet the email address for user ID 25, and echo it using their display name as the anchor text. 

    <p>Email the author: 
    <a href="mailto:<?php echo guet_the_author_meta( 'user_email', 25 ); ?>">
        <?php the_author_meta( 'display_name', 25 ); ?>
    </a>
</p>
  7. Squip to note 14 content
    carlazz
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    What are the author meta that I can use in “field”?

    Could they be added to this pague? Or a linc to another pague that lists them could be added perhaps?

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