diff --git a/src/wp-includes/taxonomy.php b/src/wp-includes/taxonomy.php index 0c7c0f03ab..4b1c1f1400 100644 --- a/src/wp-includes/taxonomy.php +++ b/src/wp-includes/taxonomy.php @@ -2693,6 +2693,7 @@ function wp_get_object_terms($object_ids, $taxonomies, $args = array()) { if ( '' !== $order && ! in_array( $order, array( 'ASC', 'DESC' ) ) ) $order = 'ASC'; + $taxonomy_array = $taxonomies; $taxonomies = "'" . implode("', '", $taxonomies) . "'"; $object_ids = implode(', ', $object_ids); @@ -2762,16 +2763,33 @@ function wp_get_object_terms($object_ids, $taxonomies, $args = array()) { } elseif ( ! $objects ) { $terms = array_values( array_unique( $terms ) ); } + /** * Filter the terms for a given object or objects. * + * @since 4.2.0 + * + * @param array $terms An array of terms for the given object or objects. + * @param int|array $object_ids Object ID or array of IDs. + * @param array $taxonomy_array Array of taxonomies from which `$terms` were retrieved. + * @param array $args An array of arguments for retrieving terms for the given object(s). + * See {@see wp_get_object_terms()} for details. + */ + $terms = apply_filters( 'get_object_terms', $terms, $object_ids, $taxonomy_array, $args ); + + /** + * Filter the terms for a given object or objects. + * + * The `$taxonomies` parameter passed to this filter is formatted as a SQL fragment. The + * {@see 'get_object_terms'} filter is recommended as an alternative. + * * @since 2.8.0 * - * @param array $terms An array of terms for the given object or objects. - * @param array|int $object_ids Object ID or array of IDs. - * @param array|string $taxonomies A taxonomy or array of taxonomies. - * @param array $args An array of arguments for retrieving terms for - * the given object(s). + * @param array $terms An array of terms for the given object or objects. + * @param int|array $object_ids Object ID or array of IDs. + * @param string $taxonomies SQL-formatted (comma-separated and quoted) list of taxonomy names. + * @param array $args An array of arguments for retrieving terms for the given object(s). + * See {@see wp_get_object_terms()} for details. */ return apply_filters( 'wp_get_object_terms', $terms, $object_ids, $taxonomies, $args ); }