WP_Sitemaps_Taxonomies::get_url_list() public WP 5.5.0

Gets a URL list for a taxonomy sitemap.

{} It's a method of the class: WP_Sitemaps_Taxonomies{}

Return

Array. Array of URLs for a sitemap.

Usage

$WP_Sitemaps_Taxonomies = new WP_Sitemaps_Taxonomies();
$WP_Sitemaps_Taxonomies->get_url_list( $page_num, $taxonomy );

$page_num(int) (required)

Page of results.

$taxonomy(string)

Taxonomy name.
Default: ''

Changelog

Code of WP_Sitemaps_Taxonomies::get_url_list() WP Sitemaps Taxonomies::get url list ^{WP 5.6}

<?php
public function get_url_list( $page_num, $taxonomy = '' ) {
	$supported_types = $this->get_object_subtypes();

	// Bail early if the queried taxonomy is not supported.
	if ( ! isset( $supported_types[ $taxonomy ] ) ) {
		return array();
	}

	/**
	 * Filters the taxonomies URL list before it is generated.
	 *
	 * Passing a non-null value will effectively short-circuit the generation,
	 * returning that value instead.
	 *
	 * @since 5.5.0
	 *
	 * @param array  $url_list The URL list. Default null.
	 * @param string $taxonomy Taxonomy name.
	 * @param int    $page_num Page of results.
	 */
	$url_list = apply_filters(
		'wp_sitemaps_taxonomies_pre_url_list',
		null,
		$taxonomy,
		$page_num
	);

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

	$url_list = array();

	// Offset by how many terms should be included in previous pages.
	$offset = ( $page_num - 1 ) * wp_sitemaps_get_max_urls( $this->object_type );

	$args           = $this->get_taxonomies_query_args( $taxonomy );
	$args['offset'] = $offset;

	$taxonomy_terms = new WP_Term_Query( $args );

	if ( ! empty( $taxonomy_terms->terms ) ) {
		foreach ( $taxonomy_terms->terms as $term ) {
			$term_link = get_term_link( $term, $taxonomy );

			if ( is_wp_error( $term_link ) ) {
				continue;
			}

			$sitemap_entry = array(
				'loc' => $term_link,
			);

			/**
			 * Filters the sitemap entry for an individual term.
			 *
			 * @since 5.5.0
			 *
			 * @param array   $sitemap_entry Sitemap entry for the term.
			 * @param WP_Term $term          Term object.
			 * @param string  $taxonomy      Taxonomy name.
			 */
			$sitemap_entry = apply_filters( 'wp_sitemaps_taxonomies_entry', $sitemap_entry, $term, $taxonomy );
			$url_list[]    = $sitemap_entry;
		}
	}

	return $url_list;
}