user_trailingslashit() — описание функции WordPress на русском

Сигнатура

user_trailingslashit( string $url, string $type_of_url = '' ): string

Описание

При необходимости добавляет завершающий слеш, если структура постоянных ссылок содержит завершающий слеш, и убирает его в противном случае. Строка пропускается через фильтр ‘user_trailingslashit’. Убирает завершающий слеш из строки, если на сайте они не используются.

Оригинал (английский)

Conditionally adds a trailing slash if the permalink structure has a trailing slash, strips the trailing slash if not. The string is passed through the ‘user_trailingslashit’ filter. Will remove trailing slash from string, if site is not set to have them.

Параметры

$url string обязательный

URL с завершающим слешем или без него.

$type_of_url string необязательный = ''

Тип рассматриваемого URL (например, single, category и т. д.) для использования в фильтре.

Возвращаемое значение

string

Исходный код

wp-includes/link-template.php:47

function user_trailingslashit( $url, $type_of_url = '' ) {
	global $wp_rewrite;
	if ( $wp_rewrite->use_trailing_slashes ) {
		$url = trailingslashit( $url );
	} else {
		$url = untrailingslashit( $url );
	}

	/**
	 * Filters the trailing-slashed string, depending on whether the site is set to use trailing slashes.
	 *
	 * @since 2.2.0
	 *
	 * @param string $url         URL with or without a trailing slash.
	 * @param string $type_of_url The type of URL being considered. Accepts 'single', 'single_trackback',
	 *                            'single_feed', 'single_paged', 'commentpaged', 'paged', 'home', 'feed',
	 *                            'category', 'page', 'year', 'month', 'day', 'post_type_archive'.
	 */
	return apply_filters( 'user_trailingslashit', $url, $type_of_url );
}

История изменений

Версия	Описание
2.2.0	Introduced.