Walker_CategoryDropdown::start_el( string $output, WP_Term $data_object, int $depth, array $args = array(), int $current_object_id )

Starts the element output.

Description
- See also
Parameters
Source
Hooks
Related
- Uses
Changelog
User Contributed Notes

Description

Top ↑

Parameters

$output string Required

Used to append additional content (passed by reference).

$data_object WP_Term Required

Category data object.

$depth int Required

Depth of category. Used for padding.

$args array Optional

Uses 'selected', 'show_count', and 'value_field' keys, if they exist.
See wp_dropdown_categories() .

More Arguments from wp_dropdown_categories( ... $args )

Array or query string of term query parameters.

taxonomy string|string[]
Taxonomy name, or array of taxonomy names, to which results should be limited.
object_ids int|int[]
Object ID, or array of object IDs. Results will be limited to terms associated with these objects.
orderby string
Field(s) to order terms by. Accepts:
- Term fields ('name', 'slug', 'term_group', 'term_id', 'id', 'description', 'parent', 'term_order'). Unless $object_ids is not empty, 'term_order' is treated the same as 'term_id'.
- 'count' to use the number of objects associated with the term.
- 'include' to match the 'order' of the $include param.
- 'slug__in' to match the 'order' of the $slug param.
- 'meta_value'
- 'meta_value_num'.
- The value of $meta_key.
- The array keys of $meta_query.
- 'none' to omit the ORDER BY clause.
Default 'name'.
order string
Whether to order terms in ascending or descending order.
Accepts 'ASC' (ascending) or 'DESC' (descending).
Default 'ASC'.
hide_empty bool|int
Whether to hide terms not assigned to any posts. Accepts 1|true or 0|false. Default 1|true.
include int[]|string
Array or comma/space-separated string of term IDs to include.
Default empty array.
exclude int[]|string
Array or comma/space-separated string of term IDs to exclude.
If $include is non-empty, $exclude is ignored.
Default empty array.
exclude_tree int[]|string
Array or comma/space-separated string of term IDs to exclude along with all of their descendant terms. If $include is non-empty, $exclude_tree is ignored. Default empty array.
number int|string
Maximum number of terms to return. Accepts ''|0 (all) or any positive number. Default ''|0 (all). Note that $number may not return accurate results when coupled with $object_ids.
See #41796 for details.
offset int
The number by which to offset the terms query.
fields string
Term fields to query for. Accepts:
- 'all' Returns an array of complete term objects (WP_Term[]).
- 'all_with_object_id' Returns an array of term objects with the 'object_id' param (WP_Term[]). Works only when the $object_ids parameter is populated.
- 'ids' Returns an array of term IDs (int[]).
- 'tt_ids' Returns an array of term taxonomy IDs (int[]).
- 'names' Returns an array of term names (string[]).
- 'slugs' Returns an array of term slugs (string[]).
- 'count' Returns the number of matching terms (int).
- 'id=>parent' Returns an associative array of parent term IDs, keyed by term ID (int[]).
- 'id=>name' Returns an associative array of term names, keyed by term ID (string[]).
- 'id=>slug' Returns an associative array of term slugs, keyed by term ID (string[]).
Default 'all'.
count bool
Whether to return a term count. If true, will take precedence over $fields. Default false.
name string|string[]
Name or array of names to return term(s) for.
slug string|string[]
Slug or array of slugs to return term(s) for.
term_taxonomy_id int|int[]
Term taxonomy ID, or array of term taxonomy IDs, to match when querying terms.
hierarchical bool
Whether to include terms that have non-empty descendants (even if $hide_empty is set to true). Default true.
search string
Search criteria to match terms. Will be SQL-formatted with wildcards before and after.
name__like string
Retrieve terms with criteria by which a term is LIKE $name__like.
description__like string
Retrieve terms where the description is LIKE $description__like.
pad_counts bool
Whether to pad the quantity of a term's children in the quantity of each term's "count" object variable. Default false.
get string
Whether to return terms regardless of ancestry or whether the terms are empty. Accepts 'all' or '' (disabled). Default ''.
child_of int
Term ID to retrieve child terms of. If multiple taxonomies are passed, $child_of is ignored. Default 0.
parent int
Parent term ID to retrieve direct-child terms of.
childless bool
True to limit results to terms that have no children.
This parameter has no effect on non-hierarchical taxonomies.
Default false.
cache_domain string
Unique cache key to be produced when this query is stored in an object cache. Default 'core'.
cache_results bool
Whether to cache term information. Default true.
update_term_meta_cache bool
Whether to prime meta caches for matched terms. Default true.
meta_key string|string[]
Meta key or keys to filter by.
meta_value string|string[]
Meta value or values to filter by.
meta_compare string
MySQL operator used for comparing the meta value.
See WP_Meta_Query::__construct() for accepted values and default value.
meta_compare_key string
MySQL operator used for comparing the meta key.
See WP_Meta_Query::__construct() for accepted values and default value.
meta_type string
MySQL data type that the meta_value column will be CAST to for comparisons.
See WP_Meta_Query::__construct() for accepted values and default value.
meta_type_key string
MySQL data type that the meta_key column will be CAST to for comparisons.
See WP_Meta_Query::__construct() for accepted values and default value.
meta_query array
An associative array of WP_Meta_Query arguments.
See WP_Meta_Query::__construct() for accepted values.

Default: array()

$current_object_id int Optional

ID of the current category. Default 0.

Top ↑

Source

File: wp-includes/class-walker-category-dropdown.php. View all references

public function start_el( &$output, $data_object, $depth = 0, $args = array(), $current_object_id = 0 ) {
	// Restores the more descriptive, specific name for use within this method.
	$category = $data_object;

	$pad = str_repeat( '&nbsp;', $depth * 3 );

	/** This filter is documented in wp-includes/category-template.php */
	$cat_name = apply_filters( 'list_cats', $category->name, $category );

	if ( isset( $args['value_field'] ) && isset( $category->{$args['value_field']} ) ) {
		$value_field = $args['value_field'];
	} else {
		$value_field = 'term_id';
	}

	$output .= "\t<option class=\"level-$depth\" value=\"" . esc_attr( $category->{$value_field} ) . '"';

	// Type-juggling causes false matches, so we force everything to a string.
	if ( (string) $category->{$value_field} === (string) $args['selected'] ) {
		$output .= ' selected="selected"';
	}
	$output .= '>';
	$output .= $pad . $cat_name;
	if ( $args['show_count'] ) {
		$output .= '&nbsp;&nbsp;(' . number_format_i18n( $category->count ) . ')';
	}
	$output .= "</option>\n";
}

View on Trac View on GitHub

Top ↑

Hooks

apply_filters( 'list_cats', string $element, WP_Term|null $category )

Filters a taxonomy drop-down display element.

Top ↑

Uses

Uses
Uses	Description
esc_attr() wp-includes/formatting.php	Escaping for HTML attributes.
number_format_i18n() wp-includes/functions.php	Converts float number to format based on the locale.
apply_filters() wp-includes/plugin.php	Calls the callback functions that have been added to a filter hook.

Show 1 more use Hide more uses

Top ↑

Changelog

Changelog
Version	Description
5.9.0	Renamed `$category` to `$data_object` and `$id` to `$current_object_id` to match parent class for PHP 8 named parameter support.
2.1.0	Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.

Walker_CategoryDropdown::start_el( string $output, WP_Term $data_object, int $depth, array $args = array(), int $current_object_id )

Contents