Changeset 50116

Timestamp:

01/31/2021 11:13:50 PM (6 years ago)

Author:

johnbillion

Message:

Taxonomy: Declare and document the sort and args properties of the WP_Taxonomy class.

These properties have been in use since 2.5 and 2.6 but were never added as actual properties on the class. This fixes that.

Props gunnard, SergeyBiryukov

Fixes #52142

Location:

trunk/src/wp-includes

Files:

• class-wp-taxonomy.php (modified) (2 diffs)
• taxonomy.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-taxonomy.php

@@ -228 +228 @@
          */
         public $rest_controller;
+
+        /**
+         * Whether terms in this taxonomy should be sorted in the order they are provided to `wp_set_object_terms()`.
+         *
+         * Use this in combination with `'orderby' => 'term_order'` when fetching terms.
+         *
+         * @since 2.5.0
+         * @var bool|null
+         */
+        public $sort = null;
+
+        /**
+         * Array of arguments to automatically use inside `wp_get_object_terms()` for this taxonomy.
+         *
+         * @since 2.6.0
+         * @var array|null
+         */
+        public $args = null;
 
         /**
@@ -305 +323 @@
                         'default_term'          => null,
                         '_builtin'              => false,
+                        'sort'                  => null,
+                        'args'                  => null,
                 );
 

trunk/src/wp-includes/taxonomy.php

@@ -415 +415 @@
  *         @type string $description  Description for default term. Default empty.
  *     }
+ *     @type bool          $sort                  Whether terms in this taxonomy should be sorted in the order they are
+ *                                                provided to `wp_set_object_terms()`. Default null which equates to false.
+ *     @type array         $args                  Array of arguments to automatically use inside `wp_get_object_terms()`
+ *                                                for this taxonomy.
  *     @type bool          $_builtin              This taxonomy is a "built-in" taxonomy. INTERNAL USE ONLY!
  *                                                Default false.