<h2>File Contents: /home/planet5/www/yogitonics.com/wp-includes/class-wp-taxonomy.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yogitonics.com/wp-includes/class-wp-taxonomy.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Taxonomy API: WP_Taxonomy class
 *
 * @package WordPress
 * @subpackage Taxonomy
 * @since 4.7.0
 */

/**
 * Core class used for interacting with taxonomies.
 *
 * @since 4.7.0
 */
#[AllowDynamicProperties]
final class WP_Taxonomy {
	/**
	 * Taxonomy key.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $name;

	/**
	 * Name of the taxonomy shown in the menu. Usually plural.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $label;

	/**
	 * Labels object for this taxonomy.
	 *
	 * If not set, tag labels are inherited for non-hierarchical types
	 * and category labels for hierarchical ones.
	 *
	 * @see get_taxonomy_labels()
	 *
	 * @since 4.7.0
	 * @var stdClass
	 */
	public $labels;

	/**
	 * Default labels.
	 *
	 * @since 6.0.0
	 * @var (string|null)[][] $default_labels
	 */
	protected static $default_labels = array();

	/**
	 * A short descriptive summary of what the taxonomy is for.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $description = &#039;&#039;;

	/**
	 * Whether a taxonomy is intended for use publicly either via the admin interface or by front-end users.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $public = true;

	/**
	 * Whether the taxonomy is publicly queryable.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $publicly_queryable = true;

	/**
	 * Whether the taxonomy is hierarchical.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $hierarchical = false;

	/**
	 * Whether to generate and allow a UI for managing terms in this taxonomy in the admin.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $show_ui = true;

	/**
	 * Whether to show the taxonomy in the admin menu.
	 *
	 * If true, the taxonomy is shown as a submenu of the object type menu. If false, no menu is shown.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $show_in_menu = true;

	/**
	 * Whether the taxonomy is available for selection in navigation menus.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $show_in_nav_menus = true;

	/**
	 * Whether to list the taxonomy in the tag cloud widget controls.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $show_tagcloud = true;

	/**
	 * Whether to show the taxonomy in the quick/bulk edit panel.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $show_in_quick_edit = true;

	/**
	 * Whether to display a column for the taxonomy on its post type listing screens.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $show_admin_column = false;

	/**
	 * The callback function for the meta box display.
	 *
	 * @since 4.7.0
	 * @var bool|callable
	 */
	public $meta_box_cb = null;

	/**
	 * The callback function for sanitizing taxonomy data saved from a meta box.
	 *
	 * @since 5.1.0
	 * @var callable
	 */
	public $meta_box_sanitize_cb = null;

	/**
	 * An array of object types this taxonomy is registered for.
	 *
	 * @since 4.7.0
	 * @var string[]
	 */
	public $object_type = null;

	/**
	 * Capabilities for this taxonomy.
	 *
	 * @since 4.7.0
	 * @var stdClass
	 */
	public $cap;

	/**
	 * Rewrites information for this taxonomy.
	 *
	 * @since 4.7.0
	 * @var array|false
	 */
	public $rewrite;

	/**
	 * Query var string for this taxonomy.
	 *
	 * @since 4.7.0
	 * @var string|false
	 */
	public $query_var;

	/**
	 * Function that will be called when the count is updated.
	 *
	 * @since 4.7.0
	 * @var callable
	 */
	public $update_count_callback;

	/**
	 * Whether this taxonomy should appear in the REST API.
	 *
	 * Default false. If true, standard endpoints will be registered with
	 * respect to $rest_base and $rest_controller_class.
	 *
	 * @since 4.7.4
	 * @var bool $show_in_rest
	 */
	public $show_in_rest;

	/**
	 * The base path for this taxonomy&#039;s REST API endpoints.
	 *
	 * @since 4.7.4
	 * @var string|bool $rest_base
	 */
	public $rest_base;

	/**
	 * The namespace for this taxonomy&#039;s REST API endpoints.
	 *
	 * @since 5.9.0
	 * @var string|bool $rest_namespace
	 */
	public $rest_namespace;

	/**
	 * The controller for this taxonomy&#039;s REST API endpoints.
	 *
	 * Custom controllers must extend WP_REST_Controller.
	 *
	 * @since 4.7.4
	 * @var string|bool $rest_controller_class
	 */
	public $rest_controller_class;

	/**
	 * The controller instance for this taxonomy&#039;s REST API endpoints.
	 *
	 * Lazily computed. Should be accessed using {@see WP_Taxonomy::get_rest_controller()}.
	 *
	 * @since 5.5.0
	 * @var WP_REST_Controller $rest_controller
	 */
	public $rest_controller;

	/**
	 * The default term name for this taxonomy. If you pass an array you have
	 * to set &#039;name&#039; and optionally &#039;slug&#039; and &#039;description&#039;.
	 *
	 * @since 5.5.0
	 * @var array|string
	 */
	public $default_term;

	/**
	 * Whether terms in this taxonomy should be sorted in the order they are provided to `wp_set_object_terms()`.
	 *
	 * Use this in combination with `&#039;orderby&#039; =&gt; &#039;term_order&#039;` 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;

	/**
	 * Whether it is a built-in taxonomy.
	 *
	 * @since 4.7.0
	 * @var bool
	 */
	public $_builtin;

	/**
	 * Constructor.
	 *
	 * See the register_taxonomy() function for accepted arguments for `$args`.
	 *
	 * @since 4.7.0
	 *
	 * @param string       $taxonomy    Taxonomy key, must not exceed 32 characters.
	 * @param array|string $object_type Name of the object type for the taxonomy object.
	 * @param array|string $args        Optional. Array or query string of arguments for registering a taxonomy.
	 *                                  See register_taxonomy() for information on accepted arguments.
	 *                                  Default empty array.
	 */
	public function __construct( $taxonomy, $object_type, $args = array() ) {
		$this-&gt;name = $taxonomy;

		$this-&gt;set_props( $object_type, $args );
	}

	/**
	 * Sets taxonomy properties.
	 *
	 * See the register_taxonomy() function for accepted arguments for `$args`.
	 *
	 * @since 4.7.0
	 *
	 * @param string|string[] $object_type Name or array of names of the object types for the taxonomy.
	 * @param array|string    $args        Array or query string of arguments for registering a taxonomy.
	 */
	public function set_props( $object_type, $args ) {
		$args = wp_parse_args( $args );

		/**
		 * Filters the arguments for registering a taxonomy.
		 *
		 * @since 4.4.0
		 *
		 * @param array    $args        Array of arguments for registering a taxonomy.
		 *                              See the register_taxonomy() function for accepted arguments.
		 * @param string   $taxonomy    Taxonomy key.
		 * @param string[] $object_type Array of names of object types for the taxonomy.
		 */
		$args = apply_filters( &#039;register_taxonomy_args&#039;, $args, $this-&gt;name, (array) $object_type );

		$taxonomy = $this-&gt;name;

		/**
		 * Filters the arguments for registering a specific taxonomy.
		 *
		 * The dynamic portion of the filter name, `$taxonomy`, refers to the taxonomy key.
		 *
		 * Possible hook names include:
		 *
		 *  - `register_category_taxonomy_args`
		 *  - `register_post_tag_taxonomy_args`
		 *
		 * @since 6.0.0
		 *
		 * @param array    $args        Array of arguments for registering a taxonomy.
		 *                              See the register_taxonomy() function for accepted arguments.
		 * @param string   $taxonomy    Taxonomy key.
		 * @param string[] $object_type Array of names of object types for the taxonomy.
		 */
		$args = apply_filters( &quot;register_{$taxonomy}_taxonomy_args&quot;, $args, $this-&gt;name, (array) $object_type );

		$defaults = array(
			&#039;labels&#039;                =&gt; array(),
			&#039;description&#039;           =&gt; &#039;&#039;,
			&#039;public&#039;                =&gt; true,
			&#039;publicly_queryable&#039;    =&gt; null,
			&#039;hierarchical&#039;          =&gt; false,
			&#039;show_ui&#039;               =&gt; null,
			&#039;show_in_menu&#039;          =&gt; null,
			&#039;show_in_nav_menus&#039;     =&gt; null,
			&#039;show_tagcloud&#039;         =&gt; null,
			&#039;show_in_quick_edit&#039;    =&gt; null,
			&#039;show_admin_column&#039;     =&gt; false,
			&#039;meta_box_cb&#039;           =&gt; null,
			&#039;meta_box_sanitize_cb&#039;  =&gt; null,
			&#039;capabilities&#039;          =&gt; array(),
			&#039;rewrite&#039;               =&gt; true,
			&#039;query_var&#039;             =&gt; $this-&gt;name,
			&#039;update_count_callback&#039; =&gt; &#039;&#039;,
			&#039;show_in_rest&#039;          =&gt; false,
			&#039;rest_base&#039;             =&gt; false,
			&#039;rest_namespace&#039;        =&gt; false,
			&#039;rest_controller_class&#039; =&gt; false,
			&#039;default_term&#039;          =&gt; null,
			&#039;sort&#039;                  =&gt; null,
			&#039;args&#039;                  =&gt; null,
			&#039;_builtin&#039;              =&gt; false,
		);

		$args = array_merge( $defaults, $args );

		// If not set, default to the setting for &#039;public&#039;.
		if ( null === $args[&#039;publicly_queryable&#039;] ) {
			$args[&#039;publicly_queryable&#039;] = $args[&#039;public&#039;];
		}

		if ( false !== $args[&#039;query_var&#039;] &amp;&amp; ( is_admin() || false !== $args[&#039;publicly_queryable&#039;] ) ) {
			if ( true === $args[&#039;query_var&#039;] ) {
				$args[&#039;query_var&#039;] = $this-&gt;name;
			} else {
				$args[&#039;query_var&#039;] = sanitize_title_with_dashes( $args[&#039;query_var&#039;] );
			}
		} else {
			// Force &#039;query_var&#039; to false for non-public taxonomies.
			$args[&#039;query_var&#039;] = false;
		}

		if ( false !== $args[&#039;rewrite&#039;] &amp;&amp; ( is_admin() || get_option( &#039;permalink_structure&#039; ) ) ) {
			$args[&#039;rewrite&#039;] = wp_parse_args(
				$args[&#039;rewrite&#039;],
				array(
					&#039;with_front&#039;   =&gt; true,
					&#039;hierarchical&#039; =&gt; false,
					&#039;ep_mask&#039;      =&gt; EP_NONE,
				)
			);

			if ( empty( $args[&#039;rewrite&#039;][&#039;slug&#039;] ) ) {
				$args[&#039;rewrite&#039;][&#039;slug&#039;] = sanitize_title_with_dashes( $this-&gt;name );
			}
		}

		// If not set, default to the setting for &#039;public&#039;.
		if ( null === $args[&#039;show_ui&#039;] ) {
			$args[&#039;show_ui&#039;] = $args[&#039;public&#039;];
		}

		// If not set, default to the setting for &#039;show_ui&#039;.
		if ( null === $args[&#039;show_in_menu&#039;] || ! $args[&#039;show_ui&#039;] ) {
			$args[&#039;show_in_menu&#039;] = $args[&#039;show_ui&#039;];
		}

		// If not set, default to the setting for &#039;public&#039;.
		if ( null === $args[&#039;show_in_nav_menus&#039;] ) {
			$args[&#039;show_in_nav_menus&#039;] = $args[&#039;public&#039;];
		}

		// If not set, default to the setting for &#039;show_ui&#039;.
		if ( null === $args[&#039;show_tagcloud&#039;] ) {
			$args[&#039;show_tagcloud&#039;] = $args[&#039;show_ui&#039;];
		}

		// If not set, default to the setting for &#039;show_ui&#039;.
		if ( null === $args[&#039;show_in_quick_edit&#039;] ) {
			$args[&#039;show_in_quick_edit&#039;] = $args[&#039;show_ui&#039;];
		}

		// If not set, default rest_namespace to wp/v2 if show_in_rest is true.
		if ( false === $args[&#039;rest_namespace&#039;] &amp;&amp; ! empty( $args[&#039;show_in_rest&#039;] ) ) {
			$args[&#039;rest_namespace&#039;] = &#039;wp/v2&#039;;
		}

		$default_caps = array(
			&#039;manage_terms&#039; =&gt; &#039;manage_categories&#039;,
			&#039;edit_terms&#039;   =&gt; &#039;manage_categories&#039;,
			&#039;delete_terms&#039; =&gt; &#039;manage_categories&#039;,
			&#039;assign_terms&#039; =&gt; &#039;edit_posts&#039;,
		);

		$args[&#039;cap&#039;] = (object) array_merge( $default_caps, $args[&#039;capabilities&#039;] );
		unset( $args[&#039;capabilities&#039;] );

		$args[&#039;object_type&#039;] = array_unique( (array) $object_type );

		// If not set, use the default meta box.
		if ( null === $args[&#039;meta_box_cb&#039;] ) {
			if ( $args[&#039;hierarchical&#039;] ) {
				$args[&#039;meta_box_cb&#039;] = &#039;post_categories_meta_box&#039;;
			} else {
				$args[&#039;meta_box_cb&#039;] = &#039;post_tags_meta_box&#039;;
			}
		}

		$args[&#039;name&#039;] = $this-&gt;name;

		// Default meta box sanitization callback depends on the value of &#039;meta_box_cb&#039;.
		if ( null === $args[&#039;meta_box_sanitize_cb&#039;] ) {
			switch ( $args[&#039;meta_box_cb&#039;] ) {
				case &#039;post_categories_meta_box&#039;:
					$args[&#039;meta_box_sanitize_cb&#039;] = &#039;taxonomy_meta_box_sanitize_cb_checkboxes&#039;;
					break;

				case &#039;post_tags_meta_box&#039;:
				default:
					$args[&#039;meta_box_sanitize_cb&#039;] = &#039;taxonomy_meta_box_sanitize_cb_input&#039;;
					break;
			}
		}

		// Default taxonomy term.
		if ( ! empty( $args[&#039;default_term&#039;] ) ) {
			if ( ! is_array( $args[&#039;default_term&#039;] ) ) {
				$args[&#039;default_term&#039;] = array( &#039;name&#039; =&gt; $args[&#039;default_term&#039;] );
			}
			$args[&#039;default_term&#039;] = wp_parse_args(
				$args[&#039;default_term&#039;],
				array(
					&#039;name&#039;        =&gt; &#039;&#039;,
					&#039;slug&#039;        =&gt; &#039;&#039;,
					&#039;description&#039; =&gt; &#039;&#039;,
				)
			);
		}

		foreach ( $args as $property_name =&gt; $property_value ) {
			$this-&gt;$property_name = $property_value;
		}

		$this-&gt;labels = get_taxonomy_labels( $this );
		$this-&gt;label  = $this-&gt;labels-&gt;name;
	}

	/**
	 * Adds the necessary rewrite rules for the taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @global WP $wp Current WordPress environment instance.
	 */
	public function add_rewrite_rules() {
		/* @var WP $wp */
		global $wp;

		// Non-publicly queryable taxonomies should not register query vars, except in the admin.
		if ( false !== $this-&gt;query_var &amp;&amp; $wp ) {
			$wp-&gt;add_query_var( $this-&gt;query_var );
		}

		if ( false !== $this-&gt;rewrite &amp;&amp; ( is_admin() || get_option( &#039;permalink_structure&#039; ) ) ) {
			if ( $this-&gt;hierarchical &amp;&amp; $this-&gt;rewrite[&#039;hierarchical&#039;] ) {
				$tag = &#039;(.+?)&#039;;
			} else {
				$tag = &#039;([^/]+)&#039;;
			}

			add_rewrite_tag( &quot;%$this-&gt;name%&quot;, $tag, $this-&gt;query_var ? &quot;{$this-&gt;query_var}=&quot; : &quot;taxonomy=$this-&gt;name&amp;term=&quot; );
			add_permastruct( $this-&gt;name, &quot;{$this-&gt;rewrite[&#039;slug&#039;]}/%$this-&gt;name%&quot;, $this-&gt;rewrite );
		}
	}

	/**
	 * Removes any rewrite rules, permastructs, and rules for the taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @global WP $wp Current WordPress environment instance.
	 */
	public function remove_rewrite_rules() {
		/* @var WP $wp */
		global $wp;

		// Remove query var.
		if ( false !== $this-&gt;query_var ) {
			$wp-&gt;remove_query_var( $this-&gt;query_var );
		}

		// Remove rewrite tags and permastructs.
		if ( false !== $this-&gt;rewrite ) {
			remove_rewrite_tag( &quot;%$this-&gt;name%&quot; );
			remove_permastruct( $this-&gt;name );
		}
	}

	/**
	 * Registers the ajax callback for the meta box.
	 *
	 * @since 4.7.0
	 */
	public function add_hooks() {
		add_filter( &#039;wp_ajax_add-&#039; . $this-&gt;name, &#039;_wp_ajax_add_hierarchical_term&#039; );
	}

	/**
	 * Removes the ajax callback for the meta box.
	 *
	 * @since 4.7.0
	 */
	public function remove_hooks() {
		remove_filter( &#039;wp_ajax_add-&#039; . $this-&gt;name, &#039;_wp_ajax_add_hierarchical_term&#039; );
	}

	/**
	 * Gets the REST API controller for this taxonomy.
	 *
	 * Will only instantiate the controller class once per request.
	 *
	 * @since 5.5.0
	 *
	 * @return WP_REST_Controller|null The controller instance, or null if the taxonomy
	 *                                 is set not to show in rest.
	 */
	public function get_rest_controller() {
		if ( ! $this-&gt;show_in_rest ) {
			return null;
		}

		$class = $this-&gt;rest_controller_class ? $this-&gt;rest_controller_class : WP_REST_Terms_Controller::class;

		if ( ! class_exists( $class ) ) {
			return null;
		}

		if ( ! is_subclass_of( $class, WP_REST_Controller::class ) ) {
			return null;
		}

		if ( ! $this-&gt;rest_controller ) {
			$this-&gt;rest_controller = new $class( $this-&gt;name );
		}

		if ( ! ( $this-&gt;rest_controller instanceof $class ) ) {
			return null;
		}

		return $this-&gt;rest_controller;
	}

	/**
	 * Returns the default labels for taxonomies.
	 *
	 * @since 6.0.0
	 *
	 * @return (string|null)[][] The default labels for taxonomies.
	 */
	public static function get_default_labels() {
		if ( ! empty( self::$default_labels ) ) {
			return self::$default_labels;
		}

		$name_field_description   = __( &#039;The name is how it appears on your site.&#039; );
		$slug_field_description   = __( &#039;The &amp;#8220;slug&amp;#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.&#039; );
		$parent_field_description = __( &#039;Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.&#039; );
		$desc_field_description   = __( &#039;The description is not prominent by default; however, some themes may show it.&#039; );

		self::$default_labels = array(
			&#039;name&#039;                       =&gt; array( _x( &#039;Tags&#039;, &#039;taxonomy general name&#039; ), _x( &#039;Categories&#039;, &#039;taxonomy general name&#039; ) ),
			&#039;singular_name&#039;              =&gt; array( _x( &#039;Tag&#039;, &#039;taxonomy singular name&#039; ), _x( &#039;Category&#039;, &#039;taxonomy singular name&#039; ) ),
			&#039;search_items&#039;               =&gt; array( __( &#039;Search Tags&#039; ), __( &#039;Search Categories&#039; ) ),
			&#039;popular_items&#039;              =&gt; array( __( &#039;Popular Tags&#039; ), null ),
			&#039;all_items&#039;                  =&gt; array( __( &#039;All Tags&#039; ), __( &#039;All Categories&#039; ) ),
			&#039;parent_item&#039;                =&gt; array( null, __( &#039;Parent Category&#039; ) ),
			&#039;parent_item_colon&#039;          =&gt; array( null, __( &#039;Parent Category:&#039; ) ),
			&#039;name_field_description&#039;     =&gt; array( $name_field_description, $name_field_description ),
			&#039;slug_field_description&#039;     =&gt; array( $slug_field_description, $slug_field_description ),
			&#039;parent_field_description&#039;   =&gt; array( null, $parent_field_description ),
			&#039;desc_field_description&#039;     =&gt; array( $desc_field_description, $desc_field_description ),
			&#039;edit_item&#039;                  =&gt; array( __( &#039;Edit Tag&#039; ), __( &#039;Edit Category&#039; ) ),
			&#039;view_item&#039;                  =&gt; array( __( &#039;View Tag&#039; ), __( &#039;View Category&#039; ) ),
			&#039;update_item&#039;                =&gt; array( __( &#039;Update Tag&#039; ), __( &#039;Update Category&#039; ) ),
			&#039;add_new_item&#039;               =&gt; array( __( &#039;Add Tag&#039; ), __( &#039;Add Category&#039; ) ),
			&#039;new_item_name&#039;              =&gt; array( __( &#039;New Tag Name&#039; ), __( &#039;New Category Name&#039; ) ),
			&#039;separate_items_with_commas&#039; =&gt; array( __( &#039;Separate tags with commas&#039; ), null ),
			&#039;add_or_remove_items&#039;        =&gt; array( __( &#039;Add or remove tags&#039; ), null ),
			&#039;choose_from_most_used&#039;      =&gt; array( __( &#039;Choose from the most used tags&#039; ), null ),
			&#039;not_found&#039;                  =&gt; array( __( &#039;No tags found.&#039; ), __( &#039;No categories found.&#039; ) ),
			&#039;no_terms&#039;                   =&gt; array( __( &#039;No tags&#039; ), __( &#039;No categories&#039; ) ),
			&#039;filter_by_item&#039;             =&gt; array( null, __( &#039;Filter by category&#039; ) ),
			&#039;items_list_navigation&#039;      =&gt; array( __( &#039;Tags list navigation&#039; ), __( &#039;Categories list navigation&#039; ) ),
			&#039;items_list&#039;                 =&gt; array( __( &#039;Tags list&#039; ), __( &#039;Categories list&#039; ) ),
			/* translators: Tab heading when selecting from the most used terms. */
			&#039;most_used&#039;                  =&gt; array( _x( &#039;Most Used&#039;, &#039;tags&#039; ), _x( &#039;Most Used&#039;, &#039;categories&#039; ) ),
			&#039;back_to_items&#039;              =&gt; array( __( &#039;&amp;larr; Go to Tags&#039; ), __( &#039;&amp;larr; Go to Categories&#039; ) ),
			&#039;item_link&#039;                  =&gt; array(
				_x( &#039;Tag Link&#039;, &#039;navigation link block title&#039; ),
				_x( &#039;Category Link&#039;, &#039;navigation link block title&#039; ),
			),
			&#039;item_link_description&#039;      =&gt; array(
				_x( &#039;A link to a tag.&#039;, &#039;navigation link block description&#039; ),
				_x( &#039;A link to a category.&#039;, &#039;navigation link block description&#039; ),
			),
		);

		return self::$default_labels;
	}

	/**
	 * Resets the cache for the default labels.
	 *
	 * @since 6.0.0
	 */
	public static function reset_default_labels() {
		self::$default_labels = array();
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyogitonics.com%2Fwp-includes'>⬅ Back to Directory</a>