清理所有字段的术语。

原型

sanitize_term( array|object $term, string $taxonomy, string $context = 'display' )

描述

依靠sanitize_term_field()来消除该术语的消毒。不同之处在于此功能将清理所有字段。上下文基于sanitize_term_field()。

参数

$term (array|object) (Required) 要检查的术语。

$taxonomy (string) (Required) 要使用的分类名称。

$context (string) (Optional)  清理该术语的背景。接受’edit’,‘db’,‘display’,‘attribute’或’js’。

返回值

(array|object)  清除所有字段的术语。

源文件

路径:wp-includes/taxonomy.php

<?php
...
function sanitize_term($term, $taxonomy, $context = 'display') {
	$fields = array( 'term_id', 'name', 'description', 'slug', 'count', 'parent', 'term_group', 'term_taxonomy_id', 'object_id' );
	$do_object = is_object( $term );
	$term_id = $do_object ? $term->term_id : (isset($term['term_id']) ? $term['term_id'] : 0);
	foreach ( (array) $fields as $field ) {
		if ( $do_object ) {
			if ( isset($term->$field) )
				$term->$field = sanitize_term_field($field, $term->$field, $term_id, $taxonomy, $context);
		} else {
			if ( isset($term[$field]) )
				$term[$field] = sanitize_term_field($field, $term[$field], $term_id, $taxonomy, $context);
		}
	}
	if ( $do_object )
		$term->filter = $context;
	else
		$term['filter'] = $context;
	return $term;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/sanitize_term/