Ticket #31909: required-wp_dropdown_categories.31909.diff

src/wp-includes/category-template.php

@@ -331 +331 @@
  *     @type string       $taxonomy          Name of the category to retrieve. Default 'category'.
  *     @type bool         $hide_if_empty     True to skip generating markup if no categories are found.
  *                                           Default false (create select element even if no categories are found).
+ *     @type bool|int     $required              Whether the field is required or not using HTML5 'required' attribute.  Accepts 0, 1, or their bool
  * }
  * @return string HTML content only if 'echo' argument is 0.
  */
 function wp_dropdown_categories( $args = '' ) {
         $defaults = array(
-                'show_option_all' => '', 'show_option_none' => '',
-                'orderby' => 'id', 'order' => 'ASC',
+                'show_option_all' => '',
+                'show_option_none' => '',
+                'option_none_value' => -1,
+                'orderby' => 'id',
+                'order' => 'ASC',
                 'show_count' => 0,
-                'hide_empty' => 1, 'child_of' => 0,
-                'exclude' => '', 'echo' => 1,
-                'selected' => 0, 'hierarchical' => 0,
-                'name' => 'cat', 'id' => '',
-                'class' => 'postform', 'depth' => 0,
-                'tab_index' => 0, 'taxonomy' => 'category',
-                'hide_if_empty' => false, 'option_none_value' => -1,
+                'hide_empty' => 1,
+                'child_of' => 0,
+                'exclude' => '',
+                'echo' => 1,
+                'selected' => 0,
+                'hierarchical' => 0,
+                'name' => 'cat',
+                'id' => '',
+                'class' => 'postform',
+                'depth' => 0,
+                'tab_index' => 0,
+                'taxonomy' => 'category',
+                'hide_if_empty' => false,
                 'value_field' => 'term_id',
+                'required' => false
         );
 
         $defaults['selected'] = ( is_category() ) ? get_query_var( 'cat' ) : 0;
@@ -379 +390 @@
         $name = esc_attr( $r['name'] );
         $class = esc_attr( $r['class'] );
         $id = $r['id'] ? esc_attr( $r['id'] ) : $name;
+        $required = $r['required'] ? 'required' : '';
 
         if ( ! $r['hide_if_empty'] || ! empty( $categories ) ) {
-                $output = "<select name='$name' id='$id' class='$class' $tab_index_attribute>\n";
+                $output = "<select $required name='$name' id='$id' class='$class' $tab_index_attribute>\n";
         } else {
                 $output = '';
         }