WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

_truncate_post_slug()

_truncate_post_slug( string $slug, int $length = 200 ): string

In this article

Back to top

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use utf8_uri_encode() instead.

Truncates a post slug.

Description

See also

Parameters

$slugstringrequired
The slug to truncate.
$lengthintoptional
Max length of the slug. Default 200 (characters).

Default:200

Return

string The truncated slug.

Source

function _truncate_post_slug( $slug, $length = 200 ) {
	if ( strlen( $slug ) > $length ) {
		$decoded_slug = urldecode( $slug );
		if ( $decoded_slug === $slug ) {
			$slug = substr( $slug, 0, $length );
		} else {
			$slug = utf8_uri_encode( $decoded_slug, $length, true );
		}
	}

	return rtrim( $slug, '-' );
}

View all references View on Trac View on GitHub

UsesDescription
utf8_uri_encode()wp-includes/formatting.php

Encodes the Unicode values to be used in the URI.

Used byDescription
wp_filter_wp_template_unique_post_slug()wp-includes/theme-templates.php

Generates a unique slug for templates.

wp_add_trashed_suffix_to_post_name_for_post()wp-includes/post.php

Adds a trashed suffix for a given post.

wp_unique_post_slug()wp-includes/post.php

Computes a unique slug for the post, when given the desired slug and some post details.

Changelog

VersionDescription
3.6.0Introduced.

User Contributed Notes

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