WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_Query::is_author()

WP_Query::is_author( int|string|int[]|string[] $author = ” ): bool

In this article

Back to top

Determines whether the query is for an existing author archive page.

Description

If the $author parameter is specified, this function will additionally check if the query is for one of the authors specified.

Parameters

$authorint|string|int[]|string[]optional
User ID, nickname, nicename, or array of such to check against.

Default:''

Return

bool Whether the query is for an existing author archive page.

Source

public function is_author( $author = '' ) {
	if ( ! $this->is_author ) {
		return false;
	}

	if ( empty( $author ) ) {
		return true;
	}

	$author_obj = $this->get_queried_object();
	if ( ! $author_obj ) {
		return false;
	}

	$author = array_map( 'strval', (array) $author );

	if ( in_array( (string) $author_obj->ID, $author, true ) ) {
		return true;
	} elseif ( in_array( $author_obj->nickname, $author, true ) ) {
		return true;
	} elseif ( in_array( $author_obj->user_nicename, $author, true ) ) {
		return true;
	}

	return false;
}

View all references View on Trac View on GitHub

UsesDescription
WP_Query::get_queried_object()wp-includes/class-wp-query.php

Retrieves the currently queried object.

Used byDescription
WP::register_globals()wp-includes/class-wp.php

Set up the WordPress Globals.

is_author()wp-includes/query.php

Determines whether the query is for an existing author archive page.

Changelog

VersionDescription
3.1.0Introduced.

User Contributed Notes

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