WordPress.org

Function Reference/get taxonomies

Description

Get a list of registered taxonomy objects.

Usage

<?php get_taxonomies( $args, $output, $operator ) ?>

Parameters

$args

(array) (optional) An array of key -> value arguments to match against the taxonomies. Only taxonomies having attributes that match all arguments are returned.

Default: None

name
object_type (array)
label
singular_label
show_ui
show_tagcloud
public
update_count_callback
rewrite
query_var
manage_cap
edit_cap
delete_cap
assign_cap
_builtin

$output

(string) (optional) The type of output to return, either taxonomy 'names' or 'objects'.

Default: 'names'

$operator

(string) (optional) Operator (and/or) to use with multiple $args.

Default: and

Return Value

array: A list of taxonomy names or objects.

Examples

Default Usage

The call to get_taxonomies returns the registered taxonomies.

<?php $taxonomies=get_taxonomies(); ?>

Output a list all registered taxonomies

<?php 
$taxonomies=get_taxonomies('','names'); 
foreach ($taxonomies as $taxonomy ) {
  echo '<p>'. $taxonomy. '</p>';
}
?>

Output a list of all public custom taxonomies

This return all custom (not builtin) taxonomies.

<?php 
$args=array(
  'public'   => true,
  '_builtin' => false
  
); 
$output = 'names'; // or objects
$operator = 'and'; // 'and' or 'or'
$taxonomies=get_taxonomies($args,$output,$operator); 
if  ($taxonomies) {
  foreach ($taxonomies  as $taxonomy ) {
    echo '<p>'. $taxonomy. '</p>';
  }
}
?>

Output a named taxonomy

This example uses the 'object' output to retrieve and display the taxonomy called 'genre':

<?php 
$args=array(
  'name' => 'genre'
);
$output = 'objects'; // or objects
$taxonomies=get_taxonomies($args,$output); 
if  ($taxonomies) {
  foreach ($taxonomies  as $taxonomy ) {
    echo '<p>' . $taxonomy->name . '</p>';
  }
}  
?>

Source File

get_taxonomies() is located in wp-includes/taxonomy.php.

Change Log

Since: 3.0.0