在WP 4.2之前,具有相同s in(例如,标签和分享s lug“”a a a a a a a a in in in in in in。。。。。。。。)))))。。。。 从WordPress 4.2开始,当这些共享术语中的一个更新时,它将被拆分:更新的术语将被分配一个新的术语ID。
在绝大多数情况下,这种更新将是无缝和平静的。 然而,一些插件和主题在选项,后期元数据,用户元数据或其他地方存储术语ID。 WP 4.2将包括两种不同的工具来帮助这些插件和主题的作者过渡。
##'split_shared_term'动作
当共享术语被分配一个新的术语ID时,会触发一个新的“split_shared_term”操作。 存储术语ID的插件和主题应挂接到此操作以执行必要的迁移。 挂钩的文档如下:
```
/**
* Fires after a previously shared taxonomy term is split into two separate terms.
*
* @since 4.2.0
*
* @param int $term_id ID of the formerly shared term.
* @param int $new_term_id ID of the new term created for the $term_taxonomy_id.
* @param int $term_taxonomy_id ID for the term_taxonomy row affected by the split.
* @param string $taxonomy Taxonomy for the split term.
*/
```
以下是插件和主题作者如何利用此操作确保存储的术语ID更新的几个示例。
##更新存储在选项中的术语ID
假设你的插件存储一个名为“featured_tags”的选项,它包含一个术语ID数组(update_option('featured_tags',array(4,6,10)))。 在这个例子中,你将钩住'split_shared_term',检查更新后的术语ID是否在数组中,如有必要,进行更新。
```
/**
* Update featured tags when a term gets split.
*
* @param int $term_id ID of the formerly shared term.
* @param int $new_term_id ID of the new term created for the $term_taxonomy_id.
* @param int $term_taxonomy_id ID for the term_taxonomy row affected by the split.
* @param string $taxonomy Taxonomy for the split term.
*/
function my_featured_tags_split_shared_term( $term_id, $new_term_id, $term_taxonomy_id, $taxonomy ) {
// We only care about tags, so we'll first verify that the term is a tag.
if ( 'post_tag' == $taxonomy ) {
// Get the current featured tags.
$featured_tags = get_option( 'featured_tags' );
// If the updated term is in the array, note the array key.
$found_term = array_search( $term_id, $featured_tags );
if ( false !== $found_term ) {
// The updated term is a featured tag! Replace it in the array, and resave.
$featured_tags[ $found_term ] = $new_term_id;
update_option( 'featured_tags', $featured_tags );
}
}
}
add_action( 'split_shared_term', 'my_featured_tags_split_shared_term', 10, 4 );
```
##更新存储在后期元中的术语ID
有时一个插件可能会在post meta中存储术语ids。 在这种情况下,使用get_posts()查询来定位具有元键“primary_category”的帖子以及与分割术语ID匹配的元值。 确定帖子后,请使用update_post_meta()更改存储在数据库中的值。
```
/**
* Check primary categories when a term gets split to see if any of them
* need to be updated.
*
* @param int $term_id ID of the formerly shared term.
* @param int $new_term_id ID of the new term created for the $term_taxonomy_id.
* @param int $term_taxonomy_id ID for the term_taxonomy row affected by the split.
* @param string $taxonomy Taxonomy for the split term.
*/
function my_primary_category_split_shared_term( $term_id, $new_term_id, $term_taxonomy_id, $taxonomy ) {
// Ignore all updates except those to categories
if ( 'category' == $taxonomy ) {
// Find all the posts where the primary category matches the old term ID.
$post_ids = get_posts( array(
'fields' => 'ids',
'meta_key' => 'primary_category',
'meta_value' => $term_id,
) );
// If we found posts, update the term ID stored in post meta.
if ( $post_ids ) {
foreach ( $post_ids as $post_id ) {
update_post_meta( $post_id, 'primary_category', $new_term_id, $term_id );
}
}
}
}
add_action( 'split_shared_term', 'my_primary_category_split_shared_term', 10, 4 );
```
## `wp_get_split_term()`函数
'split_shared_term'是处理术语ID更改的首选方法。 但是,可能有些情况 - 例如延迟插件更新 - 哪些术语被拆分,没有插件有机会钩住'split_shared_term'动作。 WP 4.2存储有关已分裂的分类术语的信息,并提供wp_get_split_term()实用程序函数,以帮助开发人员检索此信息。
考虑上面的情况,您的插件在名为“featured_tags”的选项中存储术语ID。 您可能需要构建一个验证这些标记ID的功能(可能要在插件更新中运行),以确保没有任何功能标签已被拆分:
```
function my_featured_tags_check_for_split_terms() {
$featured_tag_ids = get_option( 'featured_tags', array() );
// Check to see whether any IDs correspond to post_tag terms that have been split.
foreach ( $featured_tag_ids as $index => $featured_tag_id ) {
$new_term_id = wp_get_split_term( $featured_tag_id, 'post_tag' );
if ( $new_term_id ) {
$featured_tag_ids[ $index ] = $new_term_id;
}
}
// Resave.
update_option( 'featured_tags', $featured_tag_ids );
}
```
>[info] 请注意,wp_get_split_term()具有两个参数 - $ old_term_id和$ taxonomy - 并返回一个整数。 如果您需要检索与旧术语ID相关联的所有拆分术语的列表,无论分类如何,请使用wp_get_split_terms($ old_term_id)。
- 简介
- 主题开发
- WordPress许可证
- 什么是主题
- 开发环境
- 主题开发示例
- 主题基础
- 模板文件
- 主样式表(style.css)
- 文章类型
- 规划主题文件
- 模板层级
- 模板标签
- 循环
- 主题函数
- 连接主题文件和目录
- 使用CSS和JavaScript
- 条件标签
- 类别,标签和自定义分类
- 模板文件
- 内容模板文件
- 页面模板文件
- 附件模板文件
- 自定义内容类型
- 部分和其他模板文件
- 评论模板
- 分类模板
- 404页面
- 主题功能
- 核心支持的功能
- 管理菜单
- 自定义Headers
- 自定义Logo
- 文章格式
- 置顶文章
- Sidebars
- Widgets
- 导航菜单
- 分页
- 媒体
- Audio
- Images
- Galleries
- Video
- 精选图片和缩略图
- 国际化
- 本地化
- 辅助功能
- 主题选项 – 自定义API
- 定制对象
- 改进用户体验的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定义控件
- 高级用法
- 主题安全
- 数据消毒/逃避
- 数据验证
- 使用随机数
- 常见漏洞
- 高级主题
- 子主题
- UI最佳实践
- JavaScript最佳做法
- 主题单元测试
- 验证你的主题
- Plugin API Hooks
- 发布你的主题
- 所需的主题文件
- 测试
- 主题评论指南
- 写文档
- 提交你的主题到WordPress.org
- 参考文献
- 模板标签列表
- 条件标签列表
- 编码标准
- HTML编码标准
- CSS编码标准
- JavaScript编码标准
- PHP编码标准
- 插件开发
- 插件开发简介
- 什么是插件
- 插件基础
- 头部要求
- 包括软件许可证
- 启用 / 停用 Hooks
- 卸载方法
- 最佳做法
- 插件安全
- 检查用户功能
- 数据验证
- 保护输入
- 保护输出
- 随机数
- Hooks
- Actions
- Filters
- 自定义Hooks
- 高级主题
- 管理菜单
- 顶级菜单
- 子菜单
- 短代码
- 基本短码
- 封闭短码
- 带参数的短代码
- TinyMCE增强型短码
- 设置
- 设置API
- 使用设置API
- 选项API
- 自定义设置页面
- 元数据
- 管理帖子元数据
- 自定义元数据
- 渲染元数据
- 自定义文章类型
- 注册自定义文章类型
- 使用自定义文章类型
- 分类
- 使用自定义分类
- 在WP 4.2+中使用“split术语”
- 用户
- 创建和管理用户
- 使用用户元数据
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服务器端PHP和入队
- Heartbeat API
- 概要
- 计划任务
- 了解WP-Cron计划
- 安排WP-Cron 事件
- 将WP-Cron挂接到系统任务计划程序中
- WP-Cron简单测试
- 国际化
- 本地化
- 如何国际化您的插件
- 国际化安全
- WordPress.org
- 详细插件指南
- 规划您的插件
- 如何使用Subversion
- 插件开发者常见问题
- 开发工具
- Debug Bar 和附加组件
- 辅助插件
- REST API手册
- 资源
- 文章
- 文章修订
- 文章类型
- 文章状态
- 类别
- 标签
- 页面
- 评论
- 分类
- 媒体
- 用户
- 设置
- 使用REST API
- 全局参数
- 分页
- 链接和嵌入
- 发现
- 认证
- 经常问的问题
- 骨干JavaScript客户端
- 客户端库
- 扩展REST API
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类