wp_filter_wp_template_unique_post_slug

函数
wp_filter_wp_template_unique_post_slug ( $override_slug, $slug, $post_ID, $post_status, $post_type )
Access
Private
参数
  • (string) $override_slug The filtered value of the slug (starts as `null` from apply_filter).
    Required:
  • (string) $slug The original/un-filtered slug (post_name).
    Required:
  • (int) $post_ID Post ID.
    Required:
  • (string) $post_status No uniqueness checks are made if the post is still draft or pending.
    Required:
  • (string) $post_type Post type.
    Required:
返回值
  • (string) The original, desired slug.
定义位置
相关方法
wp_unique_post_slug_filter_block_template_part_area_wp_filter_build_unique_idwp_dependencies_unique_hostswp_filter_global_styles_post
引入
5.8.0
弃用
-

wp_filter_wp_template_unique_post_slug:这个过滤器是用来修改为一个文章生成的唯一lug。它把唯一的lug作为参数,并返回修改后的唯一lug。

为模板生成一个独特的slug。

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 = wp_get_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;
}

常见问题

FAQs
查看更多 >