get_taxonomies

Retrieves a list of registered taxonomy names or objects.

Description

(array) get_taxonomies( (array) $args = array(), (string) $output = 'names', (string) $operator = 'and' ); 

Returns (array)

A list of taxonomy names or objects.

Parameters (3)

0. $args — Optional. (array) => array()
An array of key => value arguments to match against the taxonomy objects. Default empty array.
1. $output — Optional. (string) => 'names'
The type of output to return in the array. Accepts either taxonomy names or objects.. Default names.
2. $operator — Optional. (string) => 'and'
The logical operation to perform. Accepts and or or.. or. means only one element from the array needs to match; and means all elements must match. Default and .

Usage

  1. if ( !function_exists( 'get_taxonomies' ) ) { 
  2.     require_once ABSPATH . WPINC . '/taxonomy.php'; 
  3. } 
  4.   
  5. // Optional. An array of `key => value` arguments to match against the taxonomy objects. 
  6. // Default empty array. 
  7. $args = array(); 
  8.   
  9. // Optional. The type of output to return in the array. Accepts either taxonomy 'names' 
  10. // or 'objects'. Default 'names'. 
  11. $output = 'names'; 
  12. $operator = 'and'; 
  13.   
  14. // NOTICE! Understand what this does before running. 
  15. $result = get_taxonomies($args, $output, $operator); 
  16.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/taxonomy.php  
  1. function get_taxonomies( $args = array(), $output = 'names', $operator = 'and' ) { 
  2.     global $wp_taxonomies; 
  3.  
  4.     $field = ('names' == $output) ? 'name' : false; 
  5.  
  6.     return wp_filter_object_list($wp_taxonomies, $args, $operator, $field); 
  7. }