Changeset 50116

Timestamp:

01/31/2021 11:13:50 PM (2 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.