wp_filter_wp_template_unique_post_slug()
Generates a unique slug for templates.
Internal function — this function is designed to be used by the kernel itself. It is not recommended to use this function in your code.
No Hooks.
Return
String
. The original, desired slug.
Usage
wp_filter_wp_template_unique_post_slug( $override_slug, $slug, $post_id, $post_status, $post_type );
- $override_slug(string) (required)
- The filtered value of the slug (starts as null from apply_filter).
- $slug(string) (required)
- The original/un-filtered slug (post_name).
- $post_id(int) (required)
- Post ID.
- $post_status(string) (required)
- No uniqueness checks are made if the post is still draft or pending.
- $post_type(string) (required)
- Post type.
Changelog
Since 5.8.0 | Introduced. |
wp_filter_wp_template_unique_post_slug() wp filter wp template unique post slug code WP 6.6.2
function wp_filter_wp_template_unique_post_slug( $override_slug, $slug, $post_id, $post_status, $post_type ) { if ( 'wp_template' !== $post_type && 'wp_template_part' !== $post_type ) { return $override_slug; } if ( ! $override_slug ) { $override_slug = $slug; } /* * Template slugs must be unique within the same theme. * TODO - Figure out how to update this to work for a multi-theme environment. * Unfortunately using `get_the_terms()` for the 'wp-theme' term does not work * in the case of new entities since is too early in the process to have been saved * to the entity. So for now we use the currently activated theme for creation. */ $theme = get_stylesheet(); $terms = get_the_terms( $post_id, 'wp_theme' ); if ( $terms && ! is_wp_error( $terms ) ) { $theme = $terms[0]->name; } $check_query_args = array( 'post_name__in' => array( $override_slug ), 'post_type' => $post_type, 'posts_per_page' => 1, 'no_found_rows' => true, 'post__not_in' => array( $post_id ), 'tax_query' => array( array( 'taxonomy' => 'wp_theme', 'field' => 'name', 'terms' => $theme, ), ), ); $check_query = new WP_Query( $check_query_args ); $posts = $check_query->posts; if ( count( $posts ) > 0 ) { $suffix = 2; do { $query_args = $check_query_args; $alt_post_name = _truncate_post_slug( $override_slug, 200 - ( strlen( $suffix ) + 1 ) ) . "-$suffix"; $query_args['post_name__in'] = array( $alt_post_name ); $query = new WP_Query( $query_args ); ++$suffix; } while ( count( $query->posts ) > 0 ); $override_slug = $alt_post_name; } return $override_slug; }