| @@ -1,73 +1,51 @@ | ||
| 1 | 1 | <?php |
| 2 | -/** | |
| 3 | - * @package Polylang | |
| 4 | - */ | |
| 5 | 2 | |
| 6 | 3 | /** |
| 7 | - * Displays languages in a dropdown list | |
| 4 | + * displays languages in a dropdown list | |
| 8 | 5 | * |
| 9 | 6 | * @since 1.2 |
| 10 | 7 | */ |
| 11 | 8 | class PLL_Walker_Dropdown extends Walker { |
| 12 | - /** | |
| 13 | - * Database fields to use. | |
| 14 | - * | |
| 15 | - * @see https://developer.wordpress.org/reference/classes/walker/#properties Walker::$db_fields. | |
| 16 | - * | |
| 17 | - * @var array | |
| 18 | - */ | |
| 19 | - public $db_fields = array( 'parent' => 'parent', 'id' => 'id' ); | |
| 9 | + var $db_fields = array( 'parent' => 'parent', 'id' => 'id' ); | |
| 20 | 10 | |
| 21 | 11 | /** |
| 22 | - * Outputs one element | |
| 12 | + * outputs one element | |
| 23 | 13 | * |
| 24 | 14 | * @since 1.2 |
| 25 | 15 | * |
| 26 | - * @param string $output Passed by reference. Used to append additional content. | |
| 27 | - * @param stdClass $element The data object. | |
| 28 | - * @param int $depth Depth of the item. | |
| 29 | - * @param array $args An array of additional arguments. | |
| 30 | - * @param int $current_object_id ID of the current item. | |
| 31 | - * @return void | |
| 16 | + * @see Walker::start_el | |
| 32 | 17 | */ |
| 33 | - public function start_el( &$output, $element, $depth = 0, $args = array(), $current_object_id = 0 ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable | |
| 18 | + function start_el( &$output, $element, $depth = 0, $args = array(), $current_object_id = 0 ) { | |
| 34 | 19 | $value = $args['value']; |
| 35 | 20 | $output .= sprintf( |
| 36 | - "\t" . '<option value="%1$s"%2$s%3$s>%4$s</option>' . "\n", | |
| 21 | + "\t".'<option value="%1$s"%2$s%3$s>%4$s</option>'."\n", | |
| 37 | 22 | esc_attr( $element->$value ), |
| 38 | - method_exists( $element, 'get_locale' ) ? sprintf( ' lang="%s"', esc_attr( $element->get_locale( 'display' ) ) ) : '', | |
| 39 | - selected( isset( $args['selected'] ) && $args['selected'] === $element->$value, true, false ), | |
| 23 | + empty( $element->locale ) ? '' : sprintf( ' lang="%s"', esc_attr( $element->locale ) ), | |
| 24 | + isset( $args['selected'] ) && $args['selected'] === $element->$value ? ' selected="selected"' : '', | |
| 40 | 25 | esc_html( $element->name ) |
| 41 | 26 | ); |
| 42 | 27 | } |
| 43 | 28 | |
| 44 | 29 | /** |
| 45 | - * Overrides Walker::display_element as expects an object with a parent property | |
| 30 | + * overrides Walker::display_element as expects an object with a parent property | |
| 46 | 31 | * |
| 47 | 32 | * @since 1.2 |
| 48 | 33 | * |
| 49 | - * @param stdClass $element Data object. | |
| 50 | - * @param array $children_elements List of elements to continue traversing. | |
| 51 | - * @param int $max_depth Max depth to traverse. | |
| 52 | - * @param int $depth Depth of current element. | |
| 53 | - * @param array $args An array of arguments. | |
| 54 | - * @param string $output Passed by reference. Used to append additional content. | |
| 55 | - * @return void | |
| 34 | + * @see Walker::display_element | |
| 56 | 35 | */ |
| 57 | - public function display_element( $element, &$children_elements, $max_depth, $depth, $args, &$output ) { | |
| 58 | - $element = (object) $element; // Make sure we have an object | |
| 59 | - $element->parent = $element->id = 0; // Don't care about this | |
| 36 | + function display_element( $element, &$children_elements, $max_depth, $depth = 0, $args, &$output ) { | |
| 37 | + $element = (object) $element; // make sure we have an object | |
| 38 | + $element->parent = $element->id = 0; // don't care about this | |
| 60 | 39 | parent::display_element( $element, $children_elements, $max_depth, $depth, $args, $output ); |
| 61 | 40 | } |
| 62 | 41 | |
| 63 | 42 | /** |
| 64 | - * Starts the output of the dropdown list | |
| 43 | + * starts the output of the dropdown list | |
| 65 | 44 | * |
| 66 | 45 | * @since 1.2 |
| 67 | - * @since 2.6.7 Use $max_depth and ...$args parameters to follow the move of WP 5.3 | |
| 68 | 46 | * |
| 69 | - * List of parameters accepted in $args: | |
| 47 | + * list of parameters accepted in $args: | |
| 70 | 48 | * |
| 71 | 49 | * flag => display the selected language flag in front of the dropdown if set to 1, defaults to 0 |
| 72 | 50 | * value => the language field to use as value attribute, defaults to 'slug' |
| 73 | 51 | * selected => the selected value, mandatory |
| @@ -75,34 +53,16 @@ | ||
| 75 | 53 | * id => the select id attribute, defaults to $args['name'] |
| 76 | 54 | * class => the class attribute |
| 77 | 55 | * disabled => disables the dropdown if set to 1 |
| 78 | 56 | * |
| 79 | - * @param array $elements An array of elements. | |
| 80 | - * @param int $max_depth The maximum hierarchical depth. | |
| 81 | - * @param mixed ...$args Additional arguments. | |
| 82 | - * @return string The hierarchical item output. | |
| 57 | + * @param array $elements elements to display | |
| 58 | + * @param array $args | |
| 59 | + * @return string | |
| 83 | 60 | */ |
| 84 | - public function walk( $elements, $max_depth, ...$args ) { // // phpcs:ignore WordPressVIPMinimum.Classes.DeclarationCompatibility.DeclarationCompatibility | |
| 61 | + function walk( $elements, $args = array() ) { | |
| 85 | 62 | $output = ''; |
| 63 | + $args = wp_parse_args( $args, array( 'value' => 'slug', 'name' => 'lang_choice' ) ); | |
| 86 | 64 | |
| 87 | - if ( is_array( $max_depth ) ) { // @phpstan-ignore-line | |
| 88 | - // Backward compatibility with Polylang < 2.6.7 | |
| 89 | - if ( WP_DEBUG ) { | |
| 90 | - trigger_error( // phpcs:ignore WordPress.PHP.DevelopmentFunctions | |
| 91 | - sprintf( | |
| 92 | - '%s was called incorrectly. The method expects an integer as second parameter since Polylang 2.6.7', | |
| 93 | - __METHOD__ | |
| 94 | - ) | |
| 95 | - ); | |
| 96 | - } | |
| 97 | - $args = $max_depth; | |
| 98 | - $max_depth = -1; | |
| 99 | - } else { | |
| 100 | - $args = isset( $args[0] ) ? $args[0] : array(); | |
| 101 | - } | |
| 102 | - | |
| 103 | - $args = wp_parse_args( $args, array( 'value' => 'slug', 'name' => 'lang_choice' ) ); | |
| 104 | - | |
| 105 | 65 | if ( ! empty( $args['flag'] ) ) { |
| 106 | 66 | $current = wp_list_filter( $elements, array( $args['value'] => $args['selected'] ) ); |
| 107 | 67 | $lang = reset( $current ); |
| 108 | 68 | $output = sprintf( |
| @@ -111,14 +71,14 @@ | ||
| 111 | 71 | ); |
| 112 | 72 | } |
| 113 | 73 | |
| 114 | 74 | $output .= sprintf( |
| 115 | - '<select name="%1$s"%2$s%3$s%4$s>' . "\n" . '%5$s' . "\n" . '</select>' . "\n", | |
| 116 | - esc_attr( $args['name'] ), | |
| 117 | - isset( $args['id'] ) && ! $args['id'] ? '' : ' id="' . ( empty( $args['id'] ) ? esc_attr( $args['name'] ) : esc_attr( $args['id'] ) ) . '"', | |
| 75 | + '<select name="%1$s"%2$s%3$s%4$s>' . "\n" . '%5$s' . "\n" . '</select>'."\n", | |
| 76 | + $name = esc_attr( $args['name'] ), | |
| 77 | + isset( $args['id'] ) && ! $args['id'] ? '' : ' id="' . ( empty( $args['id'] ) ? $name : esc_attr( $args['id'] ) ) . '"', | |
| 118 | 78 | empty( $args['class'] ) ? '' : ' class="' . esc_attr( $args['class'] ) . '"', |
| 119 | - disabled( empty( $args['disabled'] ), false, false ), | |
| 120 | - parent::walk( $elements, $max_depth, $args ) | |
| 79 | + empty( $args['disabled'] ) ? '' : ' disabled="disabled"', | |
| 80 | + parent::walk( $elements, -1, $args ) | |
| 121 | 81 | ); |
| 122 | 82 | |
| 123 | 83 | return $output; |
| 124 | 84 | } |
