2016-10-07 19:12:29 +02:00
< ? 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
*/
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 ;
/**
2019-11-18 08:58:59 +01:00
* 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 ()
2016-10-07 19:12:29 +02:00
*
* @ since 4.7 . 0
2020-12-11 00:59:03 +01:00
* @ var stdClass
2016-10-07 19:12:29 +02:00
*/
2019-11-18 08:58:59 +01:00
public $labels ;
2016-10-07 19:12:29 +02:00
Posts, Post Types; Taxonomy: Translate default labels once.
Improve the translation of post type and taxonomy labels by caching the translations during runtime. To account for internationalisation plugins, the runtime cache is cleared as the post types/taxonomies are reinitiated on `change_local` hook.
The same property and methods are added to both `WP_Post_Type` and `WP_Taxonomy`:
* `$default_labels`: for storing the translated strings at runtime
* `get_default_labels()`: for getting the default labels, these are translated on the first run and stored in the new property.
* `reset_default_labels()`: to clear the runtime cache and force a re-translation of the default labels
Props Chouby, nacin, SergeyBiryukov, Rarst, chriscct7, ocean90, audrasjb, costdev.
Fixes #26746.
Built from https://develop.svn.wordpress.org/trunk@53058
git-svn-id: http://core.svn.wordpress.org/trunk@52647 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-04 05:50:07 +02:00
/**
* Default labels .
*
* @ since 6.0 . 0
* @ var ( string | null )[][] $default_labels
*/
protected static $default_labels = array ();
2016-10-07 19:12:29 +02:00
/**
* A short descriptive summary of what the taxonomy is for .
*
* @ since 4.7 . 0
* @ var string
*/
public $description = '' ;
/**
* 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 ;
2017-11-21 04:15:50 +01:00
/**
* The callback function for sanitizing taxonomy data saved from a meta box .
*
2019-01-09 16:11:48 +01:00
* @ since 5.1 . 0
2017-11-21 04:15:50 +01:00
* @ var callable
*/
public $meta_box_sanitize_cb = null ;
2016-10-07 19:12:29 +02:00
/**
* An array of object types this taxonomy is registered for .
*
* @ since 4.7 . 0
2022-01-30 20:25:03 +01:00
* @ var string []
2016-10-07 19:12:29 +02:00
*/
public $object_type = null ;
/**
* Capabilities for this taxonomy .
*
* @ since 4.7 . 0
2020-12-11 00:59:03 +01:00
* @ var stdClass
2016-10-07 19:12:29 +02:00
*/
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 ;
2017-03-18 16:25:43 +01:00
/**
* 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 ' s REST API endpoints .
*
* @ since 4.7 . 4
* @ var string | bool $rest_base
*/
public $rest_base ;
2021-11-01 04:27:55 +01:00
/**
* The namespace for this taxonomy ' s REST API endpoints .
*
2021-11-01 15:31:00 +01:00
* @ since 5.9 . 0
2021-11-01 04:27:55 +01:00
* @ var string | bool $rest_namespace
*/
public $rest_namespace ;
2017-03-18 16:25:43 +01:00
/**
* The controller for this taxonomy ' 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 ;
2020-07-02 07:57:01 +02:00
/**
* The controller instance for this taxonomy ' 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 ;
2021-02-01 12:55:00 +01:00
/**
* 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 ;
2021-02-01 00:14:59 +01:00
/**
* 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 ;
2016-10-07 19:12:29 +02:00
/**
* Whether it is a built - in taxonomy .
*
* @ since 4.7 . 0
* @ var bool
*/
public $_builtin ;
/**
* Constructor .
*
2020-12-11 00:59:03 +01:00
* See the register_taxonomy () function for accepted arguments for `$args` .
*
2016-10-07 19:12:29 +02:00
* @ since 4.7 . 0
*
2019-08-04 03:28:55 +02:00
* @ global WP $wp Current WordPress environment instance .
2016-10-07 19:12:29 +02:00
*
* @ 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 .
* Default empty array .
*/
public function __construct ( $taxonomy , $object_type , $args = array () ) {
$this -> name = $taxonomy ;
$this -> set_props ( $object_type , $args );
}
/**
* Sets taxonomy properties .
*
2020-12-11 00:59:03 +01:00
* See the register_taxonomy () function for accepted arguments for `$args` .
*
2016-10-07 19:12:29 +02:00
* @ since 4.7 . 0
*
2022-01-30 20:25:03 +01:00
* @ 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 .
2016-10-07 19:12:29 +02:00
*/
public function set_props ( $object_type , $args ) {
$args = wp_parse_args ( $args );
/**
* Filters the arguments for registering a taxonomy .
*
* @ since 4.4 . 0
*
2018-03-25 21:33:31 +02:00
* @ param array $args Array of arguments for registering a taxonomy .
2020-12-11 00:59:03 +01:00
* See the register_taxonomy () function for accepted arguments .
2018-03-25 21:33:31 +02:00
* @ param string $taxonomy Taxonomy key .
* @ param string [] $object_type Array of names of object types for the taxonomy .
2016-10-07 19:12:29 +02:00
*/
$args = apply_filters ( 'register_taxonomy_args' , $args , $this -> name , ( array ) $object_type );
2022-04-11 07:11:02 +02:00
$taxonomy = $this -> name ;
/**
* Filters the arguments for registering a specific taxonomy .
*
* The dynamic portion of the filter name , `$this->name` , refers to the taxonomy key .
*
* @ 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 ( " register_ { $taxonomy } _taxonomy_args " , $args , $this -> name , ( array ) $object_type );
2016-10-07 19:12:29 +02:00
$defaults = array (
2020-10-30 05:59:08 +01:00
'labels' => array (),
'description' => '' ,
'public' => true ,
'publicly_queryable' => null ,
'hierarchical' => false ,
'show_ui' => null ,
'show_in_menu' => null ,
'show_in_nav_menus' => null ,
'show_tagcloud' => null ,
'show_in_quick_edit' => null ,
'show_admin_column' => false ,
'meta_box_cb' => null ,
'meta_box_sanitize_cb' => null ,
'capabilities' => array (),
'rewrite' => true ,
'query_var' => $this -> name ,
'update_count_callback' => '' ,
'show_in_rest' => false ,
'rest_base' => false ,
2021-11-01 04:27:55 +01:00
'rest_namespace' => false ,
2020-10-30 05:59:08 +01:00
'rest_controller_class' => false ,
'default_term' => null ,
2021-02-01 00:14:59 +01:00
'sort' => null ,
'args' => null ,
2021-02-01 12:55:00 +01:00
'_builtin' => false ,
2016-10-07 19:12:29 +02:00
);
$args = array_merge ( $defaults , $args );
2020-01-29 01:45:18 +01:00
// If not set, default to the setting for 'public'.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'publicly_queryable' ] ) {
$args [ 'publicly_queryable' ] = $args [ 'public' ];
}
if ( false !== $args [ 'query_var' ] && ( is_admin () || false !== $args [ 'publicly_queryable' ] ) ) {
if ( true === $args [ 'query_var' ] ) {
$args [ 'query_var' ] = $this -> name ;
} else {
$args [ 'query_var' ] = sanitize_title_with_dashes ( $args [ 'query_var' ] );
}
} else {
2020-01-29 01:45:18 +01:00
// Force 'query_var' to false for non-public taxonomies.
2016-10-07 19:12:29 +02:00
$args [ 'query_var' ] = false ;
}
2020-05-16 20:42:12 +02:00
if ( false !== $args [ 'rewrite' ] && ( is_admin () || get_option ( 'permalink_structure' ) ) ) {
2017-12-01 00:11:00 +01:00
$args [ 'rewrite' ] = wp_parse_args (
2018-08-17 03:51:36 +02:00
$args [ 'rewrite' ],
array (
2017-12-01 00:11:00 +01:00
'with_front' => true ,
'hierarchical' => false ,
'ep_mask' => EP_NONE ,
)
);
2016-10-07 19:12:29 +02:00
if ( empty ( $args [ 'rewrite' ][ 'slug' ] ) ) {
$args [ 'rewrite' ][ 'slug' ] = sanitize_title_with_dashes ( $this -> name );
}
}
2020-01-29 01:45:18 +01:00
// If not set, default to the setting for 'public'.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'show_ui' ] ) {
$args [ 'show_ui' ] = $args [ 'public' ];
}
2020-01-29 01:45:18 +01:00
// If not set, default to the setting for 'show_ui'.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'show_in_menu' ] || ! $args [ 'show_ui' ] ) {
$args [ 'show_in_menu' ] = $args [ 'show_ui' ];
}
2020-01-29 01:45:18 +01:00
// If not set, default to the setting for 'public'.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'show_in_nav_menus' ] ) {
$args [ 'show_in_nav_menus' ] = $args [ 'public' ];
}
2020-01-29 01:45:18 +01:00
// If not set, default to the setting for 'show_ui'.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'show_tagcloud' ] ) {
$args [ 'show_tagcloud' ] = $args [ 'show_ui' ];
}
2020-01-29 01:45:18 +01:00
// If not set, default to the setting for 'show_ui'.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'show_in_quick_edit' ] ) {
$args [ 'show_in_quick_edit' ] = $args [ 'show_ui' ];
}
2021-11-01 04:27:55 +01:00
// If not set, default rest_namespace to wp/v2 if show_in_rest is true.
if ( false === $args [ 'rest_namespace' ] && ! empty ( $args [ 'show_in_rest' ] ) ) {
$args [ 'rest_namespace' ] = 'wp/v2' ;
}
2016-10-07 19:12:29 +02:00
$default_caps = array (
'manage_terms' => 'manage_categories' ,
'edit_terms' => 'manage_categories' ,
'delete_terms' => 'manage_categories' ,
'assign_terms' => 'edit_posts' ,
);
$args [ 'cap' ] = ( object ) array_merge ( $default_caps , $args [ 'capabilities' ] );
unset ( $args [ 'capabilities' ] );
$args [ 'object_type' ] = array_unique ( ( array ) $object_type );
2020-01-29 01:45:18 +01:00
// If not set, use the default meta box.
2016-10-07 19:12:29 +02:00
if ( null === $args [ 'meta_box_cb' ] ) {
if ( $args [ 'hierarchical' ] ) {
$args [ 'meta_box_cb' ] = 'post_categories_meta_box' ;
} else {
$args [ 'meta_box_cb' ] = 'post_tags_meta_box' ;
}
}
2017-02-06 20:39:42 +01:00
$args [ 'name' ] = $this -> name ;
2016-10-07 19:12:29 +02:00
2017-11-21 04:15:50 +01:00
// Default meta box sanitization callback depends on the value of 'meta_box_cb'.
if ( null === $args [ 'meta_box_sanitize_cb' ] ) {
switch ( $args [ 'meta_box_cb' ] ) {
2017-12-01 00:11:00 +01:00
case 'post_categories_meta_box' :
2017-11-21 04:15:50 +01:00
$args [ 'meta_box_sanitize_cb' ] = 'taxonomy_meta_box_sanitize_cb_checkboxes' ;
2017-12-01 00:11:00 +01:00
break ;
2017-11-21 04:15:50 +01:00
2017-12-01 00:11:00 +01:00
case 'post_tags_meta_box' :
default :
2017-11-21 04:15:50 +01:00
$args [ 'meta_box_sanitize_cb' ] = 'taxonomy_meta_box_sanitize_cb_input' ;
2017-12-01 00:11:00 +01:00
break ;
2017-11-21 04:15:50 +01:00
}
}
2020-07-07 02:55:03 +02:00
// 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' => '' ,
)
);
}
2016-10-07 19:12:29 +02:00
foreach ( $args as $property_name => $property_value ) {
$this -> $property_name = $property_value ;
}
$this -> labels = get_taxonomy_labels ( $this );
2017-12-01 00:11:00 +01:00
$this -> label = $this -> labels -> name ;
2016-10-07 19:12:29 +02:00
}
/**
* 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 -> query_var && $wp ) {
$wp -> add_query_var ( $this -> query_var );
}
2020-05-16 20:42:12 +02:00
if ( false !== $this -> rewrite && ( is_admin () || get_option ( 'permalink_structure' ) ) ) {
2016-10-07 19:12:29 +02:00
if ( $this -> hierarchical && $this -> rewrite [ 'hierarchical' ] ) {
$tag = '(.+?)' ;
} else {
$tag = '([^/]+)' ;
}
add_rewrite_tag ( " % $this->name % " , $tag , $this -> query_var ? " { $this -> query_var } = " : " taxonomy= $this->name &term= " );
add_permastruct ( $this -> name , " { $this -> rewrite [ 'slug' ] } /% $this->name % " , $this -> 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 -> query_var ) {
$wp -> remove_query_var ( $this -> query_var );
}
// Remove rewrite tags and permastructs.
if ( false !== $this -> rewrite ) {
remove_rewrite_tag ( " % $this->name % " );
remove_permastruct ( $this -> name );
}
}
/**
* Registers the ajax callback for the meta box .
*
* @ since 4.7 . 0
*/
public function add_hooks () {
add_filter ( 'wp_ajax_add-' . $this -> name , '_wp_ajax_add_hierarchical_term' );
}
/**
* Removes the ajax callback for the meta box .
*
* @ since 4.7 . 0
*/
public function remove_hooks () {
remove_filter ( 'wp_ajax_add-' . $this -> name , '_wp_ajax_add_hierarchical_term' );
}
2020-07-02 07:57:01 +02:00
/**
* 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 -> show_in_rest ) {
return null ;
}
$class = $this -> rest_controller_class ? $this -> 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 -> rest_controller ) {
$this -> rest_controller = new $class ( $this -> name );
}
if ( ! ( $this -> rest_controller instanceof $class ) ) {
return null ;
}
return $this -> rest_controller ;
}
Posts, Post Types; Taxonomy: Translate default labels once.
Improve the translation of post type and taxonomy labels by caching the translations during runtime. To account for internationalisation plugins, the runtime cache is cleared as the post types/taxonomies are reinitiated on `change_local` hook.
The same property and methods are added to both `WP_Post_Type` and `WP_Taxonomy`:
* `$default_labels`: for storing the translated strings at runtime
* `get_default_labels()`: for getting the default labels, these are translated on the first run and stored in the new property.
* `reset_default_labels()`: to clear the runtime cache and force a re-translation of the default labels
Props Chouby, nacin, SergeyBiryukov, Rarst, chriscct7, ocean90, audrasjb, costdev.
Fixes #26746.
Built from https://develop.svn.wordpress.org/trunk@53058
git-svn-id: http://core.svn.wordpress.org/trunk@52647 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-04 05:50:07 +02:00
/**
* 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 = __ ( 'The name is how it appears on your site.' );
$slug_field_description = __ ( 'The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' );
$parent_field_description = __ ( 'Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.' );
$desc_field_description = __ ( 'The description is not prominent by default; however, some themes may show it.' );
self :: $default_labels = array (
'name' => array ( _x ( 'Tags' , 'taxonomy general name' ), _x ( 'Categories' , 'taxonomy general name' ) ),
'singular_name' => array ( _x ( 'Tag' , 'taxonomy singular name' ), _x ( 'Category' , 'taxonomy singular name' ) ),
'search_items' => array ( __ ( 'Search Tags' ), __ ( 'Search Categories' ) ),
'popular_items' => array ( __ ( 'Popular Tags' ), null ),
'all_items' => array ( __ ( 'All Tags' ), __ ( 'All Categories' ) ),
'parent_item' => array ( null , __ ( 'Parent Category' ) ),
'parent_item_colon' => array ( null , __ ( 'Parent Category:' ) ),
'name_field_description' => array ( $name_field_description , $name_field_description ),
'slug_field_description' => array ( $slug_field_description , $slug_field_description ),
'parent_field_description' => array ( null , $parent_field_description ),
'desc_field_description' => array ( $desc_field_description , $desc_field_description ),
'edit_item' => array ( __ ( 'Edit Tag' ), __ ( 'Edit Category' ) ),
'view_item' => array ( __ ( 'View Tag' ), __ ( 'View Category' ) ),
'update_item' => array ( __ ( 'Update Tag' ), __ ( 'Update Category' ) ),
'add_new_item' => array ( __ ( 'Add New Tag' ), __ ( 'Add New Category' ) ),
'new_item_name' => array ( __ ( 'New Tag Name' ), __ ( 'New Category Name' ) ),
'separate_items_with_commas' => array ( __ ( 'Separate tags with commas' ), null ),
'add_or_remove_items' => array ( __ ( 'Add or remove tags' ), null ),
'choose_from_most_used' => array ( __ ( 'Choose from the most used tags' ), null ),
'not_found' => array ( __ ( 'No tags found.' ), __ ( 'No categories found.' ) ),
'no_terms' => array ( __ ( 'No tags' ), __ ( 'No categories' ) ),
'filter_by_item' => array ( null , __ ( 'Filter by category' ) ),
'items_list_navigation' => array ( __ ( 'Tags list navigation' ), __ ( 'Categories list navigation' ) ),
'items_list' => array ( __ ( 'Tags list' ), __ ( 'Categories list' ) ),
/* translators: Tab heading when selecting from the most used terms. */
'most_used' => array ( _x ( 'Most Used' , 'tags' ), _x ( 'Most Used' , 'categories' ) ),
'back_to_items' => array ( __ ( '← Go to Tags' ), __ ( '← Go to Categories' ) ),
'item_link' => array (
_x ( 'Tag Link' , 'navigation link block title' ),
_x ( 'Category Link' , 'navigation link block title' ),
),
'item_link_description' => array (
_x ( 'A link to a tag.' , 'navigation link block description' ),
_x ( 'A link to a category.' , 'navigation link block description' ),
),
);
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 ();
}
2016-10-07 19:12:29 +02:00
}