WP_Sitemaps_Users::get_url_list( int $page_num, string $object_subtype =  ): array[]

In this article

Gets a URL list for a user sitemap.

Parameters

$page_numintrequired
Page of results.
$object_subtypestringoptional
Not applicable for Users but required for compatibility with the parent provider class.

Default:''

Return

array[] Array of URL information for a sitemap.

Source

public function get_url_list( $page_num, $object_subtype = '' ) {
	/**
	 * Filters the users URL list before it is generated.
	 *
	 * Returning a non-null value will effectively short-circuit the generation,
	 * returning that value instead.
	 *
	 * @since 5.5.0
	 *
	 * @param array[]|null $url_list The URL list. Default null.
	 * @param int        $page_num Page of results.
	 */
	$url_list = apply_filters(
		'wp_sitemaps_users_pre_url_list',
		null,
		$page_num
	);

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

	$args          = $this->get_users_query_args();
	$args['paged'] = $page_num;

	$query    = new WP_User_Query( $args );
	$users    = $query->get_results();
	$url_list = array();

	foreach ( $users as $user ) {
		$sitemap_entry = array(
			'loc' => get_author_posts_url( $user->ID ),
		);

		/**
		 * Filters the sitemap entry for an individual user.
		 *
		 * @since 5.5.0
		 *
		 * @param array   $sitemap_entry Sitemap entry for the user.
		 * @param WP_User $user          User object.
		 */
		$sitemap_entry = apply_filters( 'wp_sitemaps_users_entry', $sitemap_entry, $user );
		$url_list[]    = $sitemap_entry;
	}

	return $url_list;
}

Hooks

apply_filters( ‘wp_sitemaps_users_entry’, array $sitemap_entry, WP_User $user )

Filters the sitemap entry for an individual user.

apply_filters( ‘wp_sitemaps_users_pre_url_list’, array[]|null $url_list, int $page_num )

Filters the users URL list before it is generated.

Changelog

VersionDescription
5.5.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.