get_terms_to_edit() WordPress Function
The get_terms_to_edit() function allows you to retrieve the terms of a taxonomy that are currently being edited. This is useful for taxonomies that allow you to edit multiple terms at once.
get_terms_to_edit( int $post_id, string $taxonomy = 'post_tag' ) #
Get comma-separated list of terms available to edit for the given post ID.
Parameters
- $post_id
(int)(Required)
- $taxonomy
(string)(Optional) The taxonomy for which to retrieve terms.
Default value: 'post_tag'
Return
(string|false|WP_Error)
Source
File: wp-admin/includes/taxonomy.php
function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) { $post_id = (int) $post_id; if ( ! $post_id ) { return false; } $terms = get_object_term_cache( $post_id, $taxonomy ); if ( false === $terms ) { $terms = wp_get_object_terms( $post_id, $taxonomy ); wp_cache_add( $post_id, wp_list_pluck( $terms, 'term_id' ), $taxonomy . '_relationships' ); } if ( ! $terms ) { return false; } if ( is_wp_error( $terms ) ) { return $terms; } $term_names = array(); foreach ( $terms as $term ) { $term_names[] = $term->name; } $terms_to_edit = esc_attr( implode( ',', $term_names ) ); /** * Filters the comma-separated list of terms available to edit. * * @since 2.8.0 * * @see get_terms_to_edit() * * @param string $terms_to_edit A comma-separated list of term names. * @param string $taxonomy The taxonomy name for which to retrieve terms. */ $terms_to_edit = apply_filters( 'terms_to_edit', $terms_to_edit, $taxonomy ); return $terms_to_edit; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.8.0 | Introduced. |