user_trailingslashit() – Function | Developer.WordPress.org

Retrieves a trailing-slashed string if the site is set for adding trailing slashes.

Description

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.

Parameters

$urlstringrequired: URL with or without a trailing slash.
$type_of_urlstringoptional: The type of URL being considered (e.g. single, category, etc) for use in the filter.
Default:''

Return

string The URL with the trailing slash appended or stripped.

Source

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 );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘user_trailingslashit’, string $url, string $type_of_url ): Filters the trailing-slashed string, depending on whether the site is set to use trailing slashes.

Uses	Description
untrailingslashit()`wp-includes/formatting.php`	Removes trailing forward slashes and backslashes if they exist.
trailingslashit()`wp-includes/formatting.php`	Appends a trailing slash.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Used by	Description
wp_get_canonical_url()`wp-includes/link-template.php`	Returns the canonical URL for a post.
get_post_embed_url()`wp-includes/embed.php`	Retrieves the URL to embed a specific post in an iframe.
paginate_links()`wp-includes/general-template.php`	Retrieves paginated links for archive post pages.
get_index_rel_link()`wp-includes/deprecated.php`	Get site index relational link.
wp_old_slug_redirect()`wp-includes/query.php`	Redirect old slugs to the correct permalink.
get_term_link()`wp-includes/taxonomy.php`	Generates a permalink for a taxonomy term archive.
get_comments_pagenum_link()`wp-includes/link-template.php`	Retrieves the comments page number link.
paginate_comments_links()`wp-includes/link-template.php`	Displays or retrieves pagination links for the comments on the current post.
get_pagenum_link()`wp-includes/link-template.php`	Retrieves the link for a page number.
get_post_type_archive_link()`wp-includes/link-template.php`	Retrieves the permalink for a post type archive.
get_term_feed_link()`wp-includes/link-template.php`	Retrieves the feed link for a term.
get_search_link()`wp-includes/link-template.php`	Retrieves the permalink for a search.
get_month_link()`wp-includes/link-template.php`	Retrieves the permalink for the month archives with year.
get_day_link()`wp-includes/link-template.php`	Retrieves the permalink for the day archives with year and month.
get_feed_link()`wp-includes/link-template.php`	Retrieves the permalink for the feed type.
get_post_comments_feed_link()`wp-includes/link-template.php`	Retrieves the permalink for the post comments feed.
get_author_feed_link()`wp-includes/link-template.php`	Retrieves the feed link for a given author.
get_permalink()`wp-includes/link-template.php`	Retrieves the full permalink for the current post or post ID.
get_post_permalink()`wp-includes/link-template.php`	Retrieves the permalink for a post of a custom post type.
_get_page_link()`wp-includes/link-template.php`	Retrieves the page permalink.
get_attachment_link()`wp-includes/link-template.php`	Retrieves the permalink for an attachment.
get_year_link()`wp-includes/link-template.php`	Retrieves the permalink for the year archives.
_wp_link_page()`wp-includes/post-template.php`	Helper function for wp_link_pages() .
redirect_canonical()`wp-includes/canonical.php`	Redirects incoming links to the proper URL based on the site url.
redirect_guess_404_permalink()`wp-includes/canonical.php`	Attempts to guess the correct URL for a 404 request based on query vars.
get_author_posts_url()`wp-includes/author-template.php`	Retrieves the URL to the author page for the user with the ID provided.
get_trackback_url()`wp-includes/comment-template.php`	Retrieves the current post’s trackback URL.
get_comment_link()`wp-includes/comment-template.php`	Retrieves the link to a given comment.

Show 23 more Show less

Changelog

Version	Description
2.2.0	Introduced.

User Contributed Notes

Divyesh_kakrecha 4 years ago

-3

you can remove category from wordpress url. See example below.

function wpdocs_remove_category( $string, $type ) {
	if ( 'single' !== $type && 'category' === $type && false !== strpos( $string, 'category' ) ) {
		$url_without_category = str_replace( '/category/', '/', $string );
		return trailingslashit( $url_without_category );
	}      
	return $string;
}    
add_filter( 'user_trailingslashit', 'wpdocs_remove_category', 100, 2 );

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

In this article