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 Description


Parameters Parameters

$terms

(array) (Required)

$post_id

(int) (Required)

$taxonomy

(string) (Required)


Top ↑

Return Return

(array)


Top ↑

Source Source

File: wp-includes/revision.php

function _wp_preview_terms_filter( $terms, $post_id, $taxonomy ) {
	$post = get_post();
	if ( ! $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();
	} else {
		$term = get_term_by( 'slug', 'post-format-' . sanitize_key( $_REQUEST['post_format'] ), 'post_format' );
		if ( $term ) {
			$terms = array( $term ); // Can only have one post format
		}
	}

	return $terms;
}

Top ↑

Changelog Changelog

Changelog
Version Description
3.6.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.