get_pagenum_link() │ WP 1.5.0
Получает УРЛ на страницу пагинации соответствующую текущему запросу (архив, автор и т.д.).
Номер страницы указывается в параметре $pagenum , например $pagenum=2 получит УРЛ на вторую страницу пагинации.
Возвращает
Строку
. URL.
Использование
get_pagenum_link( $pagenum, $escape );
$pagenum(число)
Ссылку на какую страницу пагинации надо получить.
По умолчанию: 1
$escape(true|false)
Обрабатывать ли УРЛ функцией 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.
Список изменений
Код get_pagenum_link() get pagenum link
WP 6.5.2
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 );
$parts = array();
$parts[] = untrailingslashit( get_bloginfo( 'url' ) );
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, '/' );
if ( $wp_rewrite->using_index_permalinks() && ( $pagenum > 1 || '' !== $request ) ) {
$parts[] = $wp_rewrite->index;
}
$parts[] = untrailingslashit( $request );
if ( $pagenum > 1 ) {
$parts[] = $wp_rewrite->pagination_base;
$parts[] = $pagenum;
}
$result = user_trailingslashit( implode( '/', array_filter( $parts ) ), 'paged' );
if ( ! empty( $query_string ) ) {
$result .= $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 sanitize_url( $result );
}
}
Cвязанные функции