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 ): array
Filters terms lookup to set the post format.
Parameters
-
$termsarray Required -
-
$post_idint Required -
-
$taxonomystring Required -
Return
array
Source
File: wp-includes/revision.php.
View all references
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;
}
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |