get_tags( string|array $args = '' )
Retrieves all post tags.
Parameters
- $args
-
(Optional) Arguments to retrieve tags. See get_terms() for additional options.<br>
- 'taxonomy'
(string) Taxonomy to retrieve terms for. Default 'post_tag'.<br>
Default value: ''
- 'taxonomy'
Return
(WP_Term[]|int|WP_Error) Array of 'post_tag' term objects, a count thereof, or WP_Error if any of the taxonomies do not exist.
Source
File: wp-includes/category.php
function get_tags( $args = '' ) {
$tags = get_terms( 'post_tag', $args );
if ( empty( $tags ) ) {
$return = array();
return $return;
}
/**
* Filters the array of term objects returned for the 'post_tag' taxonomy.
*
* @since WP-2.3.0
*
* @param array $tags Array of 'post_tag' term objects.
* @param array $args An array of arguments. @see get_terms()
*/
$tags = apply_filters( 'get_tags', $tags, $args );
return $tags;
}
Changelog
Version | Description |
---|---|
2.3.0 | Introduced. |