云策 WordPress 开发者社区

函数文档

get_author_posts_url()

查看官方原文 ↗
💡 云策文档标注

概述

get_author_posts_url() 函数用于根据用户 ID 获取作者页面的 URL。它处理固定链接设置，并可通过 author_link 过滤器进行自定义。

关键要点

  • 函数接受两个参数：必需的 $author_id（整数类型）和可选的 $author_nicename（字符串类型，默认为空）。
  • 返回值为字符串类型的作者页面 URL。
  • 内部逻辑根据 WP_Rewrite 的固定链接结构生成 URL，若未设置则使用查询字符串格式。
  • 提供 author_link 过滤器，允许开发者修改生成的 URL。
  • 函数未进行转义，使用时需注意安全处理。

代码示例

$author_id = get_post_field('post_author', get_the_ID());
$author_url = get_author_posts_url($author_id);
echo esc_url($author_url);

注意事项

由于函数输出未转义，建议在输出时使用 esc_url() 等函数进行转义以确保安全。

📄 原文内容

Retrieves the URL to the author page for the user with the ID provided.

Parameters

$author_idintrequired
Author ID.
$author_nicenamestringoptional
The author’s nicename (slug). Default empty.

Return

string The URL to the author’s page.

Source

function get_author_posts_url( $author_id, $author_nicename = '' ) {
	global $wp_rewrite;

	$author_id = (int) $author_id;
	$link      = $wp_rewrite->get_author_permastruct();

	if ( empty( $link ) ) {
		$file = home_url( '/' );
		$link = $file . '?author=' . $author_id;
	} else {
		if ( '' === $author_nicename ) {
			$user = get_userdata( $author_id );
			if ( ! empty( $user->user_nicename ) ) {
				$author_nicename = $user->user_nicename;
			}
		}
		$link = str_replace( '%author%', $author_nicename, $link );
		$link = home_url( user_trailingslashit( $link ) );
	}

	/**
	 * Filters the URL to the author's page.
	 *
	 * @since 2.1.0
	 *
	 * @param string $link            The URL to the author's page.
	 * @param int    $author_id       The author's ID.
	 * @param string $author_nicename The author's nice name.
	 */
	$link = apply_filters( 'author_link', $link, $author_id, $author_nicename );

	return $link;
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘author_link’, string $link, int $author_id, string $author_nicename )

Filters the URL to the author’s page.

Uses Description
user_trailingslashit()wp-includes/link-template.php

Retrieves a trailing-slashed string if the site is set for adding trailing slashes.
WP_Rewrite::get_author_permastruct()wp-includes/class-wp-rewrite.php

Retrieves the author permalink structure.
get_userdata()wp-includes/pluggable.php

Retrieves user info by user ID.
home_url()wp-includes/link-template.php

Retrieves the URL for the current site where the front end is accessible.
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Show 3 moreShow less

Used by Description
WP_Sitemaps_Users::get_url_list()wp-includes/sitemaps/providers/class-wp-sitemaps-users.php

Gets a URL list for a user sitemap.
WP_REST_Users_Controller::prepare_item_for_response()wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

Prepares a single user output for response.
get_oembed_response_data()wp-includes/embed.php

Retrieves the oEmbed response data for a given post.
get_the_author_posts_link()wp-includes/author-template.php

Retrieves an HTML link to the author page of the current post’s author.
WP_Users_List_Table::single_row()wp-admin/includes/class-wp-users-list-table.php

Generates HTML for a single row on the users.php admin panel.
get_author_link()wp-includes/deprecated.php

Returns or Prints link to the author’s posts.
get_author_feed_link()wp-includes/link-template.php

Retrieves the feed link for a given author.
wp_admin_bar_edit_menu()wp-includes/admin-bar.php

Provides an edit link for posts and terms.
redirect_canonical()wp-includes/canonical.php

Redirects incoming links to the proper URL based on the site url.
wp_list_authors()wp-includes/author-template.php

Lists all the authors of the site, with several options available.

Show 5 moreShow less

Changelog

Version Description
2.1.0 Introduced.

User Contributed Notes

  1. Skip to note 4 content


    Jon (Kenshino)


    You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

    Display the link of the author page for the author of the current post

    <a href="<?php echo esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ); ?>" title="<?php echo esc_attr( get_the_author() ); ?>"></a>

    Most get_ functions are not escaped and require escaping for safe usage.