Question

Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_wp_preview_terms_filter( array $terms,  int $post_id,  string $taxonomy )

Filters terms lookup to set the post format.

---

description

---

参数

$terms

(array) (Required)

$post_id

(int) (Required)

$taxonomy

(string) (Required)

---

返回值

(array)

---

源代码

File: wp-includes/revision.php

function _wp_preview_terms_filter( $terms, $post_id, $taxonomy ) {
	if ( ! $post = get_post() )
		return $terms;

	if ( empty( $_REQUEST['post_format'] ) || $post->ID != $post_id || 'post_format' != $taxonomy || 'revision' == $post->post_type )
		return $terms;

	if ( 'standard' == $_REQUEST['post_format'] )
		$terms = array();
	elseif ( $term = get_term_by( 'slug', 'post-format-' . sanitize_key( $_REQUEST['post_format'] ), 'post_format' ) )
		$terms = array( $term ); // Can only have one post format

	return $terms;
}

---

更新日志

Version	description
3.6.0	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: sanitize_key()
• wp-includes/taxonomy.php: get_term_by()
• wp-includes/post.php: get_post()

---

User Contributed Notes