_wp_link_page( int $i ): string

Parameters

$iint

Page number.

Return

string

Link.

Uses · 10

• get_post()Retrieves post data given a post ID or post object.
• get_permalink()Retrieves the full permalink for the current post or post ID.
• get_option()Retrieves an option value based on an option name.
• add_query_arg()Retrieves a modified URL query string.
• trailingslashit()Appends a trailing slash.
• user_trailingslashit()Retrieves a trailing-slashed string if the site is set for adding trailing slashes.
• is_preview()Determines whether the query is for a post or page preview.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• get_preview_post_link()Retrieves the URL used for the post preview.
• esc_url()Checks and cleans a URL.

Used by · 1

• wp_link_pages()The formatted output of a list of pages.

Source

View on Trac ↗View on GitHub ↗

1066function _wp_link_page( $i ) {1067	global $wp_rewrite;1068	$post       = get_post();1069	$query_args = array();1070 1071	if ( 1 === $i ) {1072		$url = get_permalink();1073	} else {1074		if ( ! get_option( 'permalink_structure' ) || in_array( $post->post_status, array( 'draft', 'pending' ), true ) ) {1075			$url = add_query_arg( 'page', $i, get_permalink() );1076		} elseif ( 'page' === get_option( 'show_on_front' ) && (int) get_option( 'page_on_front' ) === $post->ID ) {1077			$url = trailingslashit( get_permalink() ) . user_trailingslashit( "$wp_rewrite->pagination_base/" . $i, 'single_paged' );1078		} else {1079			$url = trailingslashit( get_permalink() ) . user_trailingslashit( $i, 'single_paged' );1080		}1081	}1082 1083	if ( is_preview() ) {1084 1085		if ( ( 'draft' !== $post->post_status ) && isset( $_GET['preview_id'], $_GET['preview_nonce'] ) ) {1086			$query_args['preview_id']    = wp_unslash( $_GET['preview_id'] );1087			$query_args['preview_nonce'] = wp_unslash( $_GET['preview_nonce'] );1088		}1089 1090		$url = get_preview_post_link( $post, $query_args, $url );1091	}1092 1093	return '<a href="' . esc_url( $url ) . '" class="post-page-numbers">';1094}

History

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/post-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.