Ticket #41350: 41350.4.diff

src/wp-includes/class-wp-term-query.php

@@ -99 +99 @@
          *                                                'slug', 'term_group', 'term_id', 'id', 'description', 'parent'),
          *                                                'count' for term taxonomy count, 'include' to match the
          *                                                'order' of the $include param, 'meta_value', 'meta_value_num',
-         *                                                the value of `$meta_key`, the array keys of `$meta_query`, or
-         *                                                'none' to omit the ORDER BY clause. Defaults to 'name'.
+         *                                                the value of `$meta_key`, the array keys of `$meta_query`, 'rand'
+         *                                                for a random selection, or 'none' to omit the ORDER BY clause.
+         *                                                Defaults to 'name'.
          *     @type string       $order                  Whether to order terms in ascending or descending order.
          *                                                Accepts 'ASC' (ascending) or 'DESC' (descending).
          *                                                Default 'ASC'.
@@ -834 +835 @@
                         $orderby = '';
                 } elseif ( empty( $_orderby ) || 'id' == $_orderby || 'term_id' === $_orderby ) {
                         $orderby = 't.term_id';
+                } elseif ( 'rand' === $_orderby ) {
+                        $orderby = 'rand()';
                 } else {
                         $orderby = 't.name';
 

tests/phpunit/tests/term/query.php

@@ -144 +144 @@
         }
 
         /**
+        * @ticket 41350
+        */
+        public function test_order_by_rand() {
+                $q = new WP_Term_Query( array(
+                        'taxonomy' => array( 'wptests_tax' ),
+                        'orderby' => 'rand',
+                        'hide_empty' => false,
+                ) );
+                $this->assertContains( 'ORDER BY rand()', $q->request );
+        }
+
+        /**
          * @ticket 37198
          */
         public function test_order_by_term_order_should_fall_back_on_term_id_when_relationship_table_is_not_being_joined() {