wp_sitemaps_get_max_urls() │ WP 5.5.0

Получает максимальное количество элементов для отдельной Карты ссылок указанного провайдера. По умолчанию 2000.

Эта функция — это обертка для числа - сколько ссылок выводить на одной странице Карты сайта указанного провайдера. Задача этой функции - пропустить число через фильтр wp_sitemaps_max_urls, чтобы его можно было изменить. Функцию нужно использовать при создании своего провайдера.

Хуки из функции

wp_sitemaps_max_urls

Возвращает

int. Максимальное кол-во URL (ссылок).

Использование

wp_sitemaps_get_max_urls( $object_type );

$object_type(строка) (обязательный): Название объекта данных с которым работает провайдер. Он единственный для каждого провайдера. Например, для дефолтного провайдера WP taxonomies объектом является term (элемент таксономии). Другие варианты из ядра: post, term, user.

В функцию передается $object_type, а не имя провайдера, по сути это одно и тоже, так как провайдер всегда работает с каким-то одним объектом данных.

Примеры

#1 Пример использования

Это кусочек из примера по созданию Провайдера Карты сайта.

$per_page = wp_sitemaps_get_max_urls( $this->object_type );
$offset = ( $arg->paged - 1 ) * $per_page;
$LIMIT = sprintf( "LIMIT %d, %d", $offset, $per_page );

$sql = "SELECT $SELECT FROM $wpdb->wp_core_data WHERE $WHERE $LIMIT";

Список изменений

С версии 5.5.0

Введена.

Код `wp_sitemaps_get_max_urls() wp sitemaps get max urls` ^{WP 6.2.2}

wp-includes/sitemaps.php

function wp_sitemaps_get_max_urls( $object_type ) {
	/**
	 * Filters the maximum number of URLs displayed on a sitemap.
	 *
	 * @since 5.5.0
	 *
	 * @param int    $max_urls    The maximum number of URLs included in a sitemap. Default 2000.
	 * @param string $object_type Object type for sitemap to be filtered (e.g. 'post', 'term', 'user').
	 */
	return apply_filters( 'wp_sitemaps_max_urls', 2000, $object_type );
}