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{}
Hooks from the method
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
Since 5.5.0 | Introduced. |
Code of WP_Sitemaps_Taxonomies::get_url_list() WP Sitemaps Taxonomies::get url list WP 5.6
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;
}