Question

Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_wp_link_page( int $i )

Helper function for wp_link_pages().

---

description

---

参数

$i

(int) (Required) Page number.

---

返回值

(string) Link.

---

源代码

File: wp-includes/post-template.php

function _wp_link_page( $i ) {
	global $wp_rewrite;
	$post = get_post();
	$query_args = array();

	if ( 1 == $i ) {
		$url = get_permalink();
	} else {
		if ( '' == get_option('permalink_structure') || in_array($post->post_status, array('draft', 'pending')) )
			$url = add_query_arg( 'page', $i, get_permalink() );
		elseif ( 'page' == get_option('show_on_front') && get_option('page_on_front') == $post->ID )
			$url = trailingslashit(get_permalink()) . user_trailingslashit("$wp_rewrite->pagination_base/" . $i, 'single_paged');
		else
			$url = trailingslashit(get_permalink()) . user_trailingslashit($i, 'single_paged');
	}

	if ( is_preview() ) {

		if ( ( 'draft' !== $post->post_status ) && isset( $_GET['preview_id'], $_GET['preview_nonce'] ) ) {
			$query_args['preview_id'] = wp_unslash( $_GET['preview_id'] );
			$query_args['preview_nonce'] = wp_unslash( $_GET['preview_nonce'] );
		}

		$url = get_preview_post_link( $post, $query_args, $url );
	}

	return '<a href="' . esc_url( $url ) . '">';
}

---

更新日志

Version	description
3.1.0	Introduced.

---

相关函数

Uses

• wp-includes/link-template.php: get_preview_post_link()
• wp-includes/formatting.php: wp_unslash()
• wp-includes/formatting.php: esc_url()
• wp-includes/formatting.php: trailingslashit()
• wp-includes/query.php: is_preview()
• wp-includes/functions.php: add_query_arg()
• wp-includes/link-template.php: get_permalink()
• wp-includes/link-template.php: user_trailingslashit()
• wp-includes/option.php: get_option()
• wp-includes/post.php: get_post()
Show 5 more uses Hide more uses

---

Used By

• wp-includes/post-template.php: wp_link_pages()

---

User Contributed Notes