Changeset 48356 for trunk/src/wp-includes/class-wp-taxonomy.php

Timestamp:

07/07/2020 12:53:41 AM (5 years ago)

Author:

whyisjake

Message:

Taxonomy: Add support for default terms for custom taxonomies.

The new default_term argument is added to register_taxonomy() allowing a user to define the default term name and optionally slug and description.

Fixes #43517.

Props enrico.sorcinelli, SergeyBiryukov, desrosj, davidbaumwald, whyisjake.

File:

• trunk/src/wp-includes/class-wp-taxonomy.php (modified) (3 diffs)

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

@@ -209 +209 @@
      */
     public $rest_controller_class;
+
+    /**
+     * The default term name for this taxonomy. If you pass an array you have
+     * to set 'name' and optionally 'slug' and 'description'.
+     *
+     * @since 5.5.0
+     * @var array|string
+     */
+    public $default_term;
 
     /**
@@ -289 +298 @@
             'rest_base'             => false,
             'rest_controller_class' => false,
+            'default_term'          => null,
             '_builtin'              => false,
         );
@@ -387 +397 @@
         }
 
+        // Default taxonomy term.
+        if ( ! empty( $args['default_term'] ) ) {
+            if ( ! is_array( $args['default_term'] ) ) {
+                $args['default_term'] = array( 'name' => $args['default_term'] );
+            }
+            $args['default_term'] = wp_parse_args(
+                $args['default_term'],
+                array(
+                    'name'        => '',
+                    'slug'        => '',
+                    'description' => '',
+                )
+            );
+        }
+
         foreach ( $args as $property_name => $property_value ) {
             $this->$property_name = $property_value;