概述

get_previous_posts_page_link() 函数用于检索上一页文章链接，仅在非单页或单篇文章时返回字符串。该函数从 2.1.3 版本向后移植到 2.0.10。

关键要点

• 函数返回类型为 string|void，即返回上一页文章链接字符串，或在单页/单篇文章时无返回值。
• 函数内部使用全局变量 $paged 和 is_single() 条件判断，确保只在非单页时计算上一页链接。
• 相关函数包括 previous_posts()（用于显示或检索链接）、get_pagenum_link()（用于检索页码链接）和 is_single()（用于判断是否为单篇文章）。
• 该函数在 WordPress 2.0.10 版本中引入。

代码示例

function get_previous_posts_page_link() {
	global $paged;

	if ( ! is_single() ) {
		$previous_page = (int) $paged - 1;

		if ( $previous_page < 1 ) {
			$previous_page = 1;
		}

		return get_pagenum_link( $previous_page );
	}
}