WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

get_pagenum_link() WP 1.5

Получает УРЛ на страницу пагинации соответствующую текущему запросу (архив, автор и т.д.).

Номер страницы указывается в параметре $pagenum, например $pagenum=2 получит УРЛ на вторую страницу пагинации.

Хуки из функции
Возвращает

Строку. URL.

Использование

get_pagenum_link( $pagenum, $escape );
$pagenum(число)
Ссылку на какую страницу пагинации надо получить.
По умолчанию: 1
$escape(логический)
Обрабатывать ли УРЛ функцией esc_url(), в противном случае ссылка будет обработана функцией esc_url_raw().
По умолчанию: true

Примеры

#1. Пример использования ссылки на разных страницах

echo get_pagenum_link( 4 );

// На главной
// вернет: http://example.com/page/4

// На странице http://example.com/article
// вернет: http://example.com/article/page/4

#2. Изменим ссылку пагинации

Допустим на главной странице is_home() нужно добавить /article/ в ссылки пагинации, т.е. из http://example.com/page/1 нужно сделать http://example.com/article/page/1:

add_filter( 'get_pagenum_link', 'edit_paginate_url_for_home_page' );
function edit_paginate_url_for_home_page( $url ){

	if( ! is_home() || is_paged() )
		return;

	$site = home_url();
	$add  = 'article';
	$url  = preg_replace( "@$site/(.*)@", "$site/$add/\\1", $url );

	return $url;
}

Заметки

  • Global. WP_Rewrite. $wp_rewrite WordPress rewrite component.

Список изменений

С версии 1.5.0 Введена.

Код get_pagenum_link() WP 5.5.1

wp-includes/link-template.php
<?php
function get_pagenum_link( $pagenum = 1, $escape = true ) {
	global $wp_rewrite;

	$pagenum = (int) $pagenum;

	$request = remove_query_arg( 'paged' );

	$home_root = parse_url( home_url() );
	$home_root = ( isset( $home_root['path'] ) ) ? $home_root['path'] : '';
	$home_root = preg_quote( $home_root, '|' );

	$request = preg_replace( '|^' . $home_root . '|i', '', $request );
	$request = preg_replace( '|^/+|', '', $request );

	if ( ! $wp_rewrite->using_permalinks() || is_admin() ) {
		$base = trailingslashit( get_bloginfo( 'url' ) );

		if ( $pagenum > 1 ) {
			$result = add_query_arg( 'paged', $pagenum, $base . $request );
		} else {
			$result = $base . $request;
		}
	} else {
		$qs_regex = '|\?.*?$|';
		preg_match( $qs_regex, $request, $qs_match );

		if ( ! empty( $qs_match[0] ) ) {
			$query_string = $qs_match[0];
			$request      = preg_replace( $qs_regex, '', $request );
		} else {
			$query_string = '';
		}

		$request = preg_replace( "|$wp_rewrite->pagination_base/\d+/?$|", '', $request );
		$request = preg_replace( '|^' . preg_quote( $wp_rewrite->index, '|' ) . '|i', '', $request );
		$request = ltrim( $request, '/' );

		$base = trailingslashit( get_bloginfo( 'url' ) );

		if ( $wp_rewrite->using_index_permalinks() && ( $pagenum > 1 || '' !== $request ) ) {
			$base .= $wp_rewrite->index . '/';
		}

		if ( $pagenum > 1 ) {
			$request = ( ( ! empty( $request ) ) ? trailingslashit( $request ) : $request ) . user_trailingslashit( $wp_rewrite->pagination_base . '/' . $pagenum, 'paged' );
		}

		$result = $base . $request . $query_string;
	}

	/**
	 * Filters the page number link for the current request.
	 *
	 * @since 2.5.0
	 * @since 5.2.0 Added the `$pagenum` argument.
	 *
	 * @param string $result  The page number link.
	 * @param int    $pagenum The page number.
	 */
	$result = apply_filters( 'get_pagenum_link', $result, $pagenum );

	if ( $escape ) {
		return esc_url( $result );
	} else {
		return esc_url_raw( $result );
	}
}

Cвязанные функции

Из метки: permalink (постоянные ссылки ЧПУ)

Еще из раздела: Архивы

3 коммента