钩子文档

wp_unique_term_slug_is_bad_slug

💡 云策文档标注

概述

wp_unique_term_slug_is_bad_slug 是一个 WordPress 过滤器,用于判断提议的唯一术语 slug 是否为不良 slug,从而影响是否需要添加后缀以确保唯一性。

关键要点

  • 这是一个过滤器,允许开发者自定义判断术语 slug 是否不良的逻辑。
  • 接受三个参数:$needs_suffix(布尔值,表示是否需要添加后缀)、$slug(字符串,提议的 slug)和 $term(对象,术语对象)。
  • 在 wp_unique_term_slug() 函数中被调用,用于确保术语 slug 的唯一性。
  • 自 WordPress 4.3.0 版本引入。

📄 原文内容

Filters whether the proposed unique term slug is bad.

Parameters

$needs_suffixbool
Whether the slug needs to be made unique with a suffix.
$slugstring
The slug.
$termobject
Term object.

Source

if ( apply_filters( 'wp_unique_term_slug_is_bad_slug', $needs_suffix, $slug, $term ) ) {

Changelog

Version Description
4.3.0 Introduced.