Na}{

File Content: `pagination-helper.php`

<?php

namespace Yoast\WP\SEO\Helpers;

use Yoast\WP\SEO\Wrappers\WP_Query_Wrapper;
use Yoast\WP\SEO\Wrappers\WP_Rewrite_Wrapper;

/**
 * A helper object for pagination.
 *
 * Used for the canonical URL and the rel "next" and "prev" meta tags.
 */
class Pagination_Helper {

	/**
	 * Holds the WP rewrite wrapper instance.
	 *
	 * @var WP_Rewrite_Wrapper WP_Rewrite wrapper.
	 */
	protected $wp_rewrite_wrapper;

	/**
	 * Holds the WP query wrapper instance.
	 *
	 * @var WP_Query_Wrapper WP_Query wrapper.
	 */
	protected $wp_query_wrapper;

	/**
	 * Pagination_Helper constructor.
	 *
	 * @param WP_Rewrite_Wrapper $wp_rewrite_wrapper The rewrite wrapper.
	 * @param WP_Query_Wrapper   $wp_query_wrapper   The query wrapper.
	 */
	public function __construct(
		WP_Rewrite_Wrapper $wp_rewrite_wrapper,
		WP_Query_Wrapper $wp_query_wrapper
	) {
		$this->wp_rewrite_wrapper = $wp_rewrite_wrapper;
		$this->wp_query_wrapper   = $wp_query_wrapper;
	}

	/**
	 * Checks whether adjacent rel links are disabled.
	 *
	 * @return bool Whether adjacent rel links are disabled or not.
	 */
	public function is_rel_adjacent_disabled() {
		/**
		 * Filter: 'wpseo_disable_adjacent_rel_links' - Allows disabling of Yoast adjacent links if this is being handled by other code.
		 *
		 * @param bool $links_generated Indicates if other code has handled adjacent links.
		 */
		return \apply_filters( 'wpseo_disable_adjacent_rel_links', false );
	}

	/**
	 * Builds a paginated URL.
	 *
	 * @param string $url                   The un-paginated URL of the current archive.
	 * @param string $page                  The page number to add on to $url for the $link tag.
	 * @param bool   $add_pagination_base   Optional. Whether to add the pagination base (`page`) to the url.
	 * @param string $pagination_query_name Optional. The name of the query argument that holds the current page.
	 *
	 * @return string The paginated URL.
	 */
	public function get_paginated_url( $url, $page, $add_pagination_base = true, $pagination_query_name = 'page' ) {
		$wp_rewrite = $this->wp_rewrite_wrapper->get();

		$key_query_loop = $this->get_key_query_loop();
		if ( $key_query_loop ) {
			$pagination_query_name = $key_query_loop;
		}

		if ( $wp_rewrite->using_permalinks() && ! $key_query_loop ) {
			$url_parts      = \wp_parse_url( $url );
			$has_url_params = \array_key_exists( 'query', $url_parts );

			if ( $has_url_params ) {
				// We need to first remove the query params, before potentially adding the pagination parts.
				\wp_parse_str( $url_parts['query'], $query_parts );

				$url = \trailingslashit( \remove_query_arg( \array_keys( $query_parts ), $url ) );

				if ( $add_pagination_base ) {
					$url .= \trailingslashit( $wp_rewrite->pagination_base );
				}

				// We can now re-add the query params, after appending the last pagination parts.
				return \add_query_arg( $query_parts, \user_trailingslashit( $url . $page ) );
			}

			$url = \trailingslashit( $url );
			if ( $add_pagination_base ) {
				$url .= \trailingslashit( $wp_rewrite->pagination_base );
			}

			return \user_trailingslashit( $url . $page );
		}

		return \add_query_arg( $pagination_query_name, $page, \user_trailingslashit( $url ) );
	}

	/**
	 * Gets the number of archive pages.
	 *
	 * @return int The number of archive pages.
	 */
	public function get_number_of_archive_pages() {
		$wp_query = $this->wp_query_wrapper->get_query();

		return (int) $wp_query->max_num_pages;
	}

	/**
	 * Returns the current page for paged archives.
	 *
	 * @return int The current archive page.
	 */
	public function get_current_archive_page_number() {
		$wp_query    = $this->wp_query_wrapper->get_main_query();
		$page_number = (int) $wp_query->get( 'paged' );
		if ( $page_number > 1 ) {
			return $page_number;
		}

		$query_loop_page_number = $this->get_page_number_from_query_loop();

		if ( $query_loop_page_number ) {
			return $query_loop_page_number;
		}
		return 0;
	}

	/**
	 * Returns the current page for paged post types.
	 *
	 * @return int The current post page.
	 */
	public function get_current_post_page_number() {
		$wp_query = $this->wp_query_wrapper->get_main_query();

		$query_loop_page_number = $this->get_page_number_from_query_loop();

		if ( $query_loop_page_number ) {
			return $query_loop_page_number;
		}

		return (int) $wp_query->get( 'page' );
	}

	/**
	 * Returns the current page number.
	 *
	 * @return int The current page number.
	 */
	public function get_current_page_number() {
		// Get the page number for an archive page.
		$page_number = \get_query_var( 'paged', 1 );
		if ( $page_number > 1 ) {
			return $page_number;
		}

		$query_loop_page_number = $this->get_page_number_from_query_loop();

		if ( $query_loop_page_number ) {
			return $query_loop_page_number;
		}

		// Get the page number for a page in a paginated post.
		return \get_query_var( 'page', 1 );
	}

	/**
	 * Returns the key of the query loop.
	 *
	 * @return string The key of the query loop.
	 */
	public function get_key_query_loop() {
		$regex_pattern = '/^query-\d+-page$/';
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- not form data.
		foreach ( $_GET as $key => $value ) {
			if ( \preg_match( $regex_pattern, $key ) ) {
				return $key;
			}
		}
		return '';
	}

	/**
	 * Returns the page number from the query loop.
	 *
	 * @return string The page number from the query loop.
	 */
	public function get_page_number_from_query_loop() {
		$key_query_loop = $this->get_key_query_loop();

		if ( $key_query_loop ) {
			// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated,WordPress.Security.NonceVerification.Recommended -- Validated in get_key_query_loop().
			$page_number = (int) $_GET[ $key_query_loop ];
			if ( $page_number > 1 ) {
				return $page_number;
			}
		}
		return '';
	}
}

Name	Size	Permission
open-graph	---	0755
schema	---	0755
twitter	---	0755
aioseo-helper.php	1271 bytes	0644
asset-helper.php	2572 bytes	0644
attachment-cleanup-helper.php	2294 bytes	0644
author-archive-helper.php	5380 bytes	0644
blocks-helper.php	2378 bytes	0644
capability-helper.php	2116 bytes	0644
crawl-cleanup-helper.php	8293 bytes	0644
curl-helper.php	655 bytes	0644
current-page-helper.php	12964 bytes	0644
date-helper.php	3208 bytes	0644
environment-helper.php	793 bytes	0644
first-time-configuration-notice-helper.php	4871 bytes	0644
home-url-helper.php	770 bytes	0644
image-helper.php	11968 bytes	0644
import-cursor-helper.php	1395 bytes	0644
import-helper.php	716 bytes	0644
indexable-helper.php	7315 bytes	0644
indexable-to-postmeta-helper.php	6919 bytes	0644
indexing-helper.php	12994 bytes	0644
language-helper.php	2716 bytes	0644
meta-helper.php	2982 bytes	0644
notification-helper.php	546 bytes	0644
options-helper.php	3963 bytes	0644
pagination-helper.php	5820 bytes	0644
permalink-helper.php	1286 bytes	0644
post-helper.php	5558 bytes	0644
post-type-helper.php	7349 bytes	0644
primary-term-helper.php	1398 bytes	0644
product-helper.php	1103 bytes	0644
redirect-helper.php	1764 bytes	0644
request-helper.php	352 bytes	0644
require-file-helper.php	305 bytes	0644
robots-helper.php	1782 bytes	0644
robots-txt-helper.php	2722 bytes	0644
sanitization-helper.php	1056 bytes	0644
score-icon-helper.php	2846 bytes	0644
short-link-helper.php	3612 bytes	0644
site-helper.php	566 bytes	0644
social-profiles-helper.php	10990 bytes	0644
string-helper.php	1218 bytes	0644
taxonomy-helper.php	5100 bytes	0644
url-helper.php	8363 bytes	0644
user-helper.php	3763 bytes	0644
wincher-helper.php	2569 bytes	0644
woocommerce-helper.php	1312 bytes	0644
wordpress-helper.php	512 bytes	0644
wordproof-helper.php	3079 bytes	0644
wpdb-helper.php	940 bytes	0644

File Content: pagination-helper.php

File Content: `pagination-helper.php`