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_ofstringSlug of the term to make this term an alias of.
Accepts a term slug.descriptionstringThe term description.parentintThe id of the parent term. Default 0.slugstringThe term slug to use.
Source
$data = apply_filters( 'wp_insert_term_data', $data, $taxonomy, $args );
Changelog
| Version | Description |
|---|---|
| 4.7.0 | Introduced. |