enmi-conf.org: wp/wp-includes/class-walker-category-dropdown.php@3d72ae0968f4 (annotated)

7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	1	<?php
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	2	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	3	* Taxonomy API: Walker_CategoryDropdown class
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	4	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	5	* @package WordPress
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	6	* @subpackage Template
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	7	* @since 4.4.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	8	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	9
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	10	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	11	* Core class used to create an HTML dropdown list of Categories.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	12	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	13	* @since 2.1.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	14	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	15	* @see Walker
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	16	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	17	class Walker_CategoryDropdown extends Walker {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	18
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	19	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	20	* What the class handles.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	21	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	22	* @since 2.1.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	23	* @var string
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	24	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	25	* @see Walker::$tree_type
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	26	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	27	public $tree_type = 'category';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	28
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	29	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	30	* Database fields to use.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	31	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	32	* @since 2.1.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	33	* @todo Decouple this
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	34	* @var string[]
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	35	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	36	* @see Walker::$db_fields
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	37	*/
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	38	public $db_fields = array(
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	39	'parent' => 'parent',
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	40	'id' => 'term_id',
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	41	);
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	42
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	43	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	44	* Starts the element output.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	45	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	46	* @since 2.1.0
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	47	* @since 5.9.0 Renamed `$category` to `$data_object` and `$id` to `$current_object_id`
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	48	* to match parent class for PHP 8 named parameter support.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	49	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	50	* @see Walker::start_el()
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	51	*
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	52	* @param string $output Used to append additional content (passed by reference).
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	53	* @param WP_Term $data_object Category data object.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	54	* @param int $depth Depth of category. Used for padding.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	55	* @param array $args Uses 'selected', 'show_count', and 'value_field' keys, if they exist.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	56	* See wp_dropdown_categories().
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	57	* @param int $current_object_id Optional. ID of the current category. Default 0.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	58	*/
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	59	public function start_el( &$output, $data_object, $depth = 0, $args = array(), $current_object_id = 0 ) {
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	60	// Restores the more descriptive, specific name for use within this method.
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	61	$category = $data_object;
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	62	$pad = str_repeat( ' ', $depth * 3 );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	63
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	64	/** This filter is documented in wp-includes/category-template.php */
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	65	$cat_name = apply_filters( 'list_cats', $category->name, $category );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	66
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	67	if ( isset( $args['value_field'] ) && isset( $category->{$args['value_field']} ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	68	$value_field = $args['value_field'];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	69	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	70	$value_field = 'term_id';
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	71	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	72
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	73	$output .= "\t<option class=\"level-$depth\" value=\"" . esc_attr( $category->{$value_field} ) . '"';
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	74
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	75	// Type-juggling causes false matches, so we force everything to a string.
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	76	if ( (string) $category->{$value_field} === (string) $args['selected'] ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	77	$output .= ' selected="selected"';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	78	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	79	$output .= '>';
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	80	$output .= $pad . $cat_name;
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	81	if ( $args['show_count'] ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	82	$output .= '  (' . number_format_i18n( $category->count ) . ')';
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	83	}
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	84	$output .= "</option>\n";
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	85	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	86	}

author	ymh <ymh.work@gmail.com>
	Tue, 27 Sep 2022 16:37:53 +0200
changeset 19	3d72ae0968f4
parent 18	be944660c56a
child 21	48c4eec2b7e6
permissions	-rw-r--r--