WP_Term_Query::populate_terms() WordPress Method
The WP_Term_Query::populate_terms() method is used to fill a given array of term objects with data from the database. This is typically used to generate an array of all available terms for a given taxonomy.
WP_Term_Query::populate_terms( Object[]|int[] $terms ) #
Creates an array of term objects from an array of term IDs.
Description
Also discards invalid term objects.
Parameters
- $terms
(Object[]|int[])(Required)List of objects or term ids.
Return
(WP_Term[]) Array of WP_Term objects.
Source
File: wp-includes/class-wp-term-query.php
protected function populate_terms( $terms ) {
$term_objects = array();
if ( ! is_array( $terms ) ) {
return $term_objects;
}
foreach ( $terms as $key => $term_data ) {
if ( is_object( $term_data ) && property_exists( $term_data, 'term_id' ) ) {
$term = get_term( $term_data->term_id );
if ( property_exists( $term_data, 'object_id' ) ) {
$term->object_id = (int) $term_data->object_id;
}
} else {
$term = get_term( $term_data );
}
if ( $term instanceof WP_Term ) {
$term_objects[ $key ] = $term;
}
}
return $term_objects;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.9.8 | Introduced. |