get_the_author_link( bool $use_title_attr = true ): string

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

Description

If the author has a home page set, return an HTML link, otherwise just return the author’s name.

Parameters

$use_title_attrbooloptional: Whether to add a title attribute.

Default:true

Return

string An HTML link if the author’s URL exists in user meta, otherwise the result of get_the_author() .

Source

function get_the_author_link( $use_title_attr = true ) {
	if ( get_the_author_meta( 'url' ) ) {
		global $authordata;

		$author_url          = get_the_author_meta( 'url' );
		$author_display_name = get_the_author();

		/* translators: %s: Author's display name. */
		$author_title = sprintf( __( 'Visit %s&#8217;s website' ), $author_display_name );

		$link = sprintf(
			'<a href="%1$s"%2$s rel="author external">%3$s</a>',
			esc_url( $author_url ),
			$use_title_attr ? ' title="' . esc_attr( $author_title ) . '"' : '',
			$author_display_name
		);

		/**
		 * Filters the author URL link HTML.
		 *
		 * @since 6.0.0
		 *
		 * @param string  $link       The default rendered author HTML link.
		 * @param string  $author_url Author's URL.
		 * @param WP_User $authordata Author user data.
		 */
		return apply_filters( 'the_author_link', $link, $author_url, $authordata );
	} else {
		return get_the_author();
	}
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘the_author_link’, string $link, string $author_url, WP_User $authordata ): Filters the author URL link HTML.

Uses	Description
get_the_author_meta()`wp-includes/author-template.php`	Retrieves the requested data of the author of the current post.
get_the_author()`wp-includes/author-template.php`	Retrieves the author of the current post.
__()`wp-includes/l10n.php`	Retrieves the translation of $text.
esc_url()`wp-includes/formatting.php`	Checks and cleans a URL.
esc_attr()`wp-includes/formatting.php`	Escaping for HTML attributes.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 4 more Show less

Used by	Description
the_author_link()`wp-includes/author-template.php`	Displays either author’s link or author’s name.

Changelog

Version	Description
7.0.0	Added `$use_title_attr` parameter.
3.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex 11 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
This example displays the author’s Website URL as a link and the text for the link is the author’s Profile Display Name. In this example, the author’s Display Name is James Smith.
```
<p>Written by: 
<?php echo get_the_author_link(); ?></p>
```
Which displays as:

Written by: James Smith
Log in to add feedback

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

get_the_author_link( bool $use_title_attr = true ): string

In this article