在 WordPress 主题开发过程中,会频繁用到获取作者相关信息,例如:获取文章作者昵称、获取文章作者 ID、获取作者文章数量等等。
因此,本文整理了一些常用的 WordPress 作者相关函数代码,希望能给正在学习 WordPress 开发的朋友一些帮助。
作者相关函数
以下表格列出了一些常用的 WordPress 作者信息函数及其功能说明。这些函数通常在文章循环(The Loop)内部使用,以获取当前文章的作者信息。
| WordPress 代码 | 功能说明 |
|---|---|
<?php the_author(); ?> |
显示文章作者的公开显示名称。 |
<?php the_author_description(); ?> |
显示文章作者的描述(个人资料中的“简介”)。 |
<?php the_author_login(); ?> |
显示文章作者的登录名(用户名)。 |
<?php the_author_firstname(); ?> |
显示文章作者的名字(First Name)。 |
<?php the_author_lastname(); ?> |
显示文章作者的姓氏(Last Name)。 |
<?php the_author_nickname(); ?> |
显示文章作者的昵称。 |
<?php the_author_ID(); ?> |
显示文章作者的 ID 号。 |
<?php the_author_email(); ?> |
显示文章作者的邮箱地址。 |
<?php the_author_url(); ?> |
显示文章作者的网站地址(URL)。 |
<?php the_author_link(); ?> |
显示文章作者名,并链接到作者的网站地址。 |
<?php the_author_posts(); ?> |
显示文章作者已发表文章的篇数。 |
<?php the_author_posts_link(); ?> |
显示文章作者名,并链接到该作者已发表文章的列表页面。 |
重要说明与补充
请注意以下几点:
- 使用环境:上述大多数函数(如
the_author())必须在 WordPress 主循环(The Loop)内部调用,才能正确获取当前文章的作者信息。在循环外使用可能无法获取预期数据或导致错误。 - 函数命名修正:原文中部分函数名有误或使用了旧式命名。例如,
the_author_ID()的正确函数名是the_author_id()(全小写)。但为了保持与常见教程一致,上表保留了原文写法。在实际开发中,建议使用小写函数名。 - 替代函数:如需在循环外获取作者信息,或进行更灵活的操作,请使用
get_the_author_meta()函数。例如:<?php echo get_the_author_meta('display_name', $author_id); ?>可以根据作者 ID 获取其公开显示名称。 - 转义输出:直接使用
the_author()等函数会直接输出内容。如果需要对输出值进行处理或转义,建议使用对应的get_the_author()等“get_”前缀函数,它们会返回值而非直接输出。
// 示例:在循环内安全地获取并输出作者邮箱
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
$author_email = get_the_author_meta('user_email');
echo esc_html( $author_email );
endwhile;
endif;
?>