taxonomy_parent_dropdown_args │ filter-hook │ WP 3.7.0

Filters the taxonomy parent drop-down on the Edit Term page.

Usage

add_filter( 'taxonomy_parent_dropdown_args', 'wp_kama_taxonomy_parent_dropdown_args_filter', 10, 3 );

/**
 * Function for `taxonomy_parent_dropdown_args` filter-hook.
 * 
 * @param array  $dropdown_args An array of taxonomy parent drop-down arguments.
 * @param string $taxonomy      The taxonomy slug.
 * @param string $context       Filter context. Accepts 'new' or 'edit'.
 *
 * @return array
 */
function wp_kama_taxonomy_parent_dropdown_args_filter( $dropdown_args, $taxonomy, $context ){

	// filter...
	return $dropdown_args;
}

$dropdown_args(array)

An array of taxonomy parent drop-down arguments.

• hide_empty(int|true|false)
  Whether to hide terms not attached to any posts.

• hide_if_empty(true|false)
  Whether to hide the drop-down if no terms exist.
  Default: false

• taxonomy(string)
  The taxonomy slug.

• name(string)
  Value of the name attribute to use for the drop-down select element.
  Default: 'parent'

• orderby(string)
  The field to order by.
  Default: 'name'

• hierarchical(true|false)
  Whether the taxonomy is hierarchical.
  Default: true

• show_option_none(string)
  Label to display if there are no terms.
  Default: 'None'

$taxonomy(string)

The taxonomy slug.

$context(string)

Filter context. Accepts 'new' or 'edit'.

Changelog

Where the hook is called

$dropdown_args = apply_filters( 'taxonomy_parent_dropdown_args', $dropdown_args, $taxonomy, 'new' );

$dropdown_args = apply_filters( 'taxonomy_parent_dropdown_args', $dropdown_args, $taxonomy, 'edit' );

Where the hook is used in WordPress