WP_Sitemaps_Taxonomies::get_max_num_pages() WordPress Method

The WP_Sitemaps_Taxonomies::get_max_num_pages() method is used to get the maximum number of pages for a taxonomy sitemap. This is useful for creating a navigation for a taxonomy sitemap.

WP_Sitemaps_Taxonomies::get_max_num_pages( string $object_subtype = '' ) #

Gets the max number of pages available for the object type.


Parameters

$object_subtype

(string)(Optional) Taxonomy name.

Default value: ''


Top ↑

Return

(int) Total number of pages.


Top ↑

Source

File: wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php

	public function get_max_num_pages( $object_subtype = '' ) {
		if ( empty( $object_subtype ) ) {
			return 0;
		}

		// Restores the more descriptive, specific name for use within this method.
		$taxonomy = $object_subtype;

		/**
		 * Filters the max number of pages for a taxonomy sitemap before it is generated.
		 *
		 * Passing a non-null value will short-circuit the generation,
		 * returning that value instead.
		 *
		 * @since 5.5.0
		 *
		 * @param int|null $max_num_pages The maximum number of pages. Default null.
		 * @param string   $taxonomy      Taxonomy name.
		 */
		$max_num_pages = apply_filters( 'wp_sitemaps_taxonomies_pre_max_num_pages', null, $taxonomy );

		if ( null !== $max_num_pages ) {
			return $max_num_pages;
		}

		$term_count = wp_count_terms( $this->get_taxonomies_query_args( $taxonomy ) );

		return (int) ceil( $term_count / wp_sitemaps_get_max_urls( $this->object_type ) );
	}


Top ↑

Changelog

Changelog
VersionDescription
5.9.0Renamed $taxonomy to $object_subtype to match parent class for PHP 8 named parameter support.
5.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.