钩子文档

wp_insert_term_data

💡 云策文档标注

概述

wp_insert_term_data 是一个 WordPress 过滤器钩子,用于在术语数据插入数据库前进行修改。它允许开发者自定义术语的插入过程,例如调整别名、描述、父级或 slug 等参数。

关键要点

  • 过滤器钩子名称:wp_insert_term_data
  • 用途:过滤术语数据,在插入数据库前进行自定义处理
  • 参数:$data(术语数据数组)、$taxonomy(分类法 slug)、$args(传递给 wp_insert_term() 的参数数组)
  • 相关函数:wp_insert_term(),用于向数据库添加新术语
  • 引入版本:WordPress 4.7.0

代码示例

$data = apply_filters( 'wp_insert_term_data', $data, $taxonomy, $args );

注意事项

  • 参数 $args 包含 alias_of(别名 slug)、description(描述)、parent(父级 ID)、slug(术语 slug)等字段,可用于精细控制术语插入行为。
  • 此过滤器在 wp_insert_term() 函数内部调用,确保在术语保存前应用自定义逻辑。

📄 原文内容

Filters term data before it is inserted into the database.

Parameters

$dataarray
Term data to be inserted.
$taxonomystring
Taxonomy slug.
$argsarray
Arguments passed to wp_insert_term() .

More Arguments from wp_insert_term( … $args )

Array or query string of arguments for inserting a term.

  • alias_of string
    Slug of the term to make this term an alias of.
    Accepts a term slug.
  • description string
    The term description.
  • parent int
    The id of the parent term. Default 0.
  • slug string
    The term slug to use.

Source

$data = apply_filters( 'wp_insert_term_data', $data, $taxonomy, $args );

Changelog

Version Description
4.7.0 Introduced.