<h2>File Contents: /home/planet5/www/4xpips.net/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/4xpips.net/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * REST API: WP_REST_Terms_Controller class
 *
 * @package WordPress
 * @subpackage REST_API
 * @since 4.7.0
 */

/**
 * Core class used to managed terms associated with a taxonomy via the REST API.
 *
 * @since 4.7.0
 *
 * @see WP_REST_Controller
 */
class WP_REST_Terms_Controller extends WP_REST_Controller {

	/**
	 * Taxonomy key.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	protected $taxonomy;

	/**
	 * Instance of a term meta fields object.
	 *
	 * @since 4.7.0
	 * @var WP_REST_Term_Meta_Fields
	 */
	protected $meta;

	/**
	 * Column to have the terms be sorted by.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	protected $sort_column;

	/**
	 * Number of terms that were found.
	 *
	 * @since 4.7.0
	 * @var int
	 */
	protected $total_terms;

	/**
	 * Whether the controller supports batching.
	 *
	 * @since 5.9.0
	 * @var array
	 */
	protected $allow_batch = array( &#039;v1&#039; =&gt; true );

	/**
	 * Constructor.
	 *
	 * @since 4.7.0
	 *
	 * @param string $taxonomy Taxonomy key.
	 */
	public function __construct( $taxonomy ) {
		$this-&gt;taxonomy  = $taxonomy;
		$tax_obj         = get_taxonomy( $taxonomy );
		$this-&gt;rest_base = ! empty( $tax_obj-&gt;rest_base ) ? $tax_obj-&gt;rest_base : $tax_obj-&gt;name;
		$this-&gt;namespace = ! empty( $tax_obj-&gt;rest_namespace ) ? $tax_obj-&gt;rest_namespace : &#039;wp/v2&#039;;

		$this-&gt;meta = new WP_REST_Term_Meta_Fields( $taxonomy );
	}

	/**
	 * Registers the routes for terms.
	 *
	 * @since 4.7.0
	 *
	 * @see register_rest_route()
	 */
	public function register_routes() {

		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;rest_base,
			array(
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_items&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_items_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;get_collection_params(),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::CREATABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;create_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;create_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;get_endpoint_args_for_item_schema( WP_REST_Server::CREATABLE ),
				),
				&#039;allow_batch&#039; =&gt; $this-&gt;allow_batch,
				&#039;schema&#039;      =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);

		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;rest_base . &#039;/(?P&lt;id&gt;[\d]+)&#039;,
			array(
				&#039;args&#039;        =&gt; array(
					&#039;id&#039; =&gt; array(
						&#039;description&#039; =&gt; __( &#039;Unique identifier for the term.&#039; ),
						&#039;type&#039;        =&gt; &#039;integer&#039;,
					),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; array(
						&#039;context&#039; =&gt; $this-&gt;get_context_param( array( &#039;default&#039; =&gt; &#039;view&#039; ) ),
					),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::EDITABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;update_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;update_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;get_endpoint_args_for_item_schema( WP_REST_Server::EDITABLE ),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::DELETABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;delete_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;delete_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; array(
						&#039;force&#039; =&gt; array(
							&#039;type&#039;        =&gt; &#039;boolean&#039;,
							&#039;default&#039;     =&gt; false,
							&#039;description&#039; =&gt; __( &#039;Required to be true, as terms do not support trashing.&#039; ),
						),
					),
				),
				&#039;allow_batch&#039; =&gt; $this-&gt;allow_batch,
				&#039;schema&#039;      =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);
	}

	/**
	 * Checks if the terms for a post can be read.
	 *
	 * @since 6.0.3
	 *
	 * @param WP_Post         $post    Post object.
	 * @param WP_REST_Request $request Full details about the request.
	 * @return bool Whether the terms for the post can be read.
	 */
	public function check_read_terms_permission_for_post( $post, $request ) {
		// If the requested post isn&#039;t associated with this taxonomy, deny access.
		if ( ! is_object_in_taxonomy( $post-&gt;post_type, $this-&gt;taxonomy ) ) {
			return false;
		}

		// Grant access if the post is publicly viewable.
		if ( is_post_publicly_viewable( $post ) ) {
			return true;
		}

		// Otherwise grant access if the post is readable by the logged in user.
		if ( current_user_can( &#039;read_post&#039;, $post-&gt;ID ) ) {
			return true;
		}

		// Otherwise, deny access.
		return false;
	}

	/**
	 * Checks if a request has access to read terms in the specified taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return bool|WP_Error True if the request has read access, otherwise false or WP_Error object.
	 */
	public function get_items_permissions_check( $request ) {
		$tax_obj = get_taxonomy( $this-&gt;taxonomy );

		if ( ! $tax_obj || ! $this-&gt;check_is_taxonomy_allowed( $this-&gt;taxonomy ) ) {
			return false;
		}

		if ( &#039;edit&#039; === $request[&#039;context&#039;] &amp;&amp; ! current_user_can( $tax_obj-&gt;cap-&gt;edit_terms ) ) {
			return new WP_Error(
				&#039;rest_forbidden_context&#039;,
				__( &#039;Sorry, you are not allowed to edit terms in this taxonomy.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		if ( ! empty( $request[&#039;post&#039;] ) ) {
			$post = get_post( $request[&#039;post&#039;] );

			if ( ! $post ) {
				return new WP_Error(
					&#039;rest_post_invalid_id&#039;,
					__( &#039;Invalid post ID.&#039; ),
					array(
						&#039;status&#039; =&gt; 400,
					)
				);
			}

			if ( ! $this-&gt;check_read_terms_permission_for_post( $post, $request ) ) {
				return new WP_Error(
					&#039;rest_forbidden_context&#039;,
					__( &#039;Sorry, you are not allowed to view terms for this post.&#039; ),
					array(
						&#039;status&#039; =&gt; rest_authorization_required_code(),
					)
				);
			}
		}

		return true;
	}

	/**
	 * Retrieves terms associated with a taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_items( $request ) {

		// Retrieve the list of registered collection query parameters.
		$registered = $this-&gt;get_collection_params();

		/*
		 * This array defines mappings between public API query parameters whose
		 * values are accepted as-passed, and their internal WP_Query parameter
		 * name equivalents (some are the same). Only values which are also
		 * present in $registered will be set.
		 */
		$parameter_mappings = array(
			&#039;exclude&#039;    =&gt; &#039;exclude&#039;,
			&#039;include&#039;    =&gt; &#039;include&#039;,
			&#039;order&#039;      =&gt; &#039;order&#039;,
			&#039;orderby&#039;    =&gt; &#039;orderby&#039;,
			&#039;post&#039;       =&gt; &#039;post&#039;,
			&#039;hide_empty&#039; =&gt; &#039;hide_empty&#039;,
			&#039;per_page&#039;   =&gt; &#039;number&#039;,
			&#039;search&#039;     =&gt; &#039;search&#039;,
			&#039;slug&#039;       =&gt; &#039;slug&#039;,
		);

		$prepared_args = array( &#039;taxonomy&#039; =&gt; $this-&gt;taxonomy );

		/*
		 * For each known parameter which is both registered and present in the request,
		 * set the parameter&#039;s value on the query $prepared_args.
		 */
		foreach ( $parameter_mappings as $api_param =&gt; $wp_param ) {
			if ( isset( $registered[ $api_param ], $request[ $api_param ] ) ) {
				$prepared_args[ $wp_param ] = $request[ $api_param ];
			}
		}

		if ( isset( $prepared_args[&#039;orderby&#039;] ) &amp;&amp; isset( $request[&#039;orderby&#039;] ) ) {
			$orderby_mappings = array(
				&#039;include_slugs&#039; =&gt; &#039;slug__in&#039;,
			);

			if ( isset( $orderby_mappings[ $request[&#039;orderby&#039;] ] ) ) {
				$prepared_args[&#039;orderby&#039;] = $orderby_mappings[ $request[&#039;orderby&#039;] ];
			}
		}

		if ( isset( $registered[&#039;offset&#039;] ) &amp;&amp; ! empty( $request[&#039;offset&#039;] ) ) {
			$prepared_args[&#039;offset&#039;] = $request[&#039;offset&#039;];
		} else {
			$prepared_args[&#039;offset&#039;] = ( $request[&#039;page&#039;] - 1 ) * $prepared_args[&#039;number&#039;];
		}

		$taxonomy_obj = get_taxonomy( $this-&gt;taxonomy );

		if ( $taxonomy_obj-&gt;hierarchical &amp;&amp; isset( $registered[&#039;parent&#039;], $request[&#039;parent&#039;] ) ) {
			if ( 0 === $request[&#039;parent&#039;] ) {
				// Only query top-level terms.
				$prepared_args[&#039;parent&#039;] = 0;
			} else {
				if ( $request[&#039;parent&#039;] ) {
					$prepared_args[&#039;parent&#039;] = $request[&#039;parent&#039;];
				}
			}
		}

		/**
		 * Filters get_terms() arguments when querying terms via the REST API.
		 *
		 * The dynamic portion of the hook name, `$this-&gt;taxonomy`, refers to the taxonomy slug.
		 *
		 * Possible hook names include:
		 *
		 *  - `rest_category_query`
		 *  - `rest_post_tag_query`
		 *
		 * Enables adding extra arguments or setting defaults for a terms
		 * collection request.
		 *
		 * @since 4.7.0
		 *
		 * @link https://developer.wordpress.org/reference/functions/get_terms/
		 *
		 * @param array           $prepared_args Array of arguments for get_terms().
		 * @param WP_REST_Request $request       The REST API request.
		 */
		$prepared_args = apply_filters( &quot;rest_{$this-&gt;taxonomy}_query&quot;, $prepared_args, $request );

		if ( ! empty( $prepared_args[&#039;post&#039;] ) ) {
			$query_result = wp_get_object_terms( $prepared_args[&#039;post&#039;], $this-&gt;taxonomy, $prepared_args );

			// Used when calling wp_count_terms() below.
			$prepared_args[&#039;object_ids&#039;] = $prepared_args[&#039;post&#039;];
		} else {
			$query_result = get_terms( $prepared_args );
		}

		$count_args = $prepared_args;

		unset( $count_args[&#039;number&#039;], $count_args[&#039;offset&#039;] );

		$total_terms = wp_count_terms( $count_args );

		// wp_count_terms() can return a falsey value when the term has no children.
		if ( ! $total_terms ) {
			$total_terms = 0;
		}

		$response = array();

		foreach ( $query_result as $term ) {
			$data       = $this-&gt;prepare_item_for_response( $term, $request );
			$response[] = $this-&gt;prepare_response_for_collection( $data );
		}

		$response = rest_ensure_response( $response );

		// Store pagination values for headers.
		$per_page = (int) $prepared_args[&#039;number&#039;];
		$page     = ceil( ( ( (int) $prepared_args[&#039;offset&#039;] ) / $per_page ) + 1 );

		$response-&gt;header( &#039;X-WP-Total&#039;, (int) $total_terms );

		$max_pages = ceil( $total_terms / $per_page );

		$response-&gt;header( &#039;X-WP-TotalPages&#039;, (int) $max_pages );

		$request_params = $request-&gt;get_query_params();
		$collection_url = rest_url( rest_get_route_for_taxonomy_items( $this-&gt;taxonomy ) );
		$base           = add_query_arg( urlencode_deep( $request_params ), $collection_url );

		if ( $page &gt; 1 ) {
			$prev_page = $page - 1;

			if ( $prev_page &gt; $max_pages ) {
				$prev_page = $max_pages;
			}

			$prev_link = add_query_arg( &#039;page&#039;, $prev_page, $base );
			$response-&gt;link_header( &#039;prev&#039;, $prev_link );
		}
		if ( $max_pages &gt; $page ) {
			$next_page = $page + 1;
			$next_link = add_query_arg( &#039;page&#039;, $next_page, $base );

			$response-&gt;link_header( &#039;next&#039;, $next_link );
		}

		return $response;
	}

	/**
	 * Get the term, if the ID is valid.
	 *
	 * @since 4.7.2
	 *
	 * @param int $id Supplied ID.
	 * @return WP_Term|WP_Error Term object if ID is valid, WP_Error otherwise.
	 */
	protected function get_term( $id ) {
		$error = new WP_Error(
			&#039;rest_term_invalid&#039;,
			__( &#039;Term does not exist.&#039; ),
			array( &#039;status&#039; =&gt; 404 )
		);

		if ( ! $this-&gt;check_is_taxonomy_allowed( $this-&gt;taxonomy ) ) {
			return $error;
		}

		if ( (int) $id &lt;= 0 ) {
			return $error;
		}

		$term = get_term( (int) $id, $this-&gt;taxonomy );
		if ( empty( $term ) || $term-&gt;taxonomy !== $this-&gt;taxonomy ) {
			return $error;
		}

		return $term;
	}

	/**
	 * Checks if a request has access to read or edit the specified term.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has read access for the item, otherwise WP_Error object.
	 */
	public function get_item_permissions_check( $request ) {
		$term = $this-&gt;get_term( $request[&#039;id&#039;] );

		if ( is_wp_error( $term ) ) {
			return $term;
		}

		if ( &#039;edit&#039; === $request[&#039;context&#039;] &amp;&amp; ! current_user_can( &#039;edit_term&#039;, $term-&gt;term_id ) ) {
			return new WP_Error(
				&#039;rest_forbidden_context&#039;,
				__( &#039;Sorry, you are not allowed to edit this term.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		return true;
	}

	/**
	 * Gets a single term from a taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_item( $request ) {
		$term = $this-&gt;get_term( $request[&#039;id&#039;] );
		if ( is_wp_error( $term ) ) {
			return $term;
		}

		$response = $this-&gt;prepare_item_for_response( $term, $request );

		return rest_ensure_response( $response );
	}

	/**
	 * Checks if a request has access to create a term.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has access to create items, false or WP_Error object otherwise.
	 */
	public function create_item_permissions_check( $request ) {

		if ( ! $this-&gt;check_is_taxonomy_allowed( $this-&gt;taxonomy ) ) {
			return false;
		}

		$taxonomy_obj = get_taxonomy( $this-&gt;taxonomy );

		if ( ( is_taxonomy_hierarchical( $this-&gt;taxonomy )
				&amp;&amp; ! current_user_can( $taxonomy_obj-&gt;cap-&gt;edit_terms ) )
			|| ( ! is_taxonomy_hierarchical( $this-&gt;taxonomy )
				&amp;&amp; ! current_user_can( $taxonomy_obj-&gt;cap-&gt;assign_terms ) ) ) {
			return new WP_Error(
				&#039;rest_cannot_create&#039;,
				__( &#039;Sorry, you are not allowed to create terms in this taxonomy.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		return true;
	}

	/**
	 * Creates a single term in a taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function create_item( $request ) {
		if ( isset( $request[&#039;parent&#039;] ) ) {
			if ( ! is_taxonomy_hierarchical( $this-&gt;taxonomy ) ) {
				return new WP_Error(
					&#039;rest_taxonomy_not_hierarchical&#039;,
					__( &#039;Cannot set parent term, taxonomy is not hierarchical.&#039; ),
					array( &#039;status&#039; =&gt; 400 )
				);
			}

			$parent = get_term( (int) $request[&#039;parent&#039;], $this-&gt;taxonomy );

			if ( ! $parent ) {
				return new WP_Error(
					&#039;rest_term_invalid&#039;,
					__( &#039;Parent term does not exist.&#039; ),
					array( &#039;status&#039; =&gt; 400 )
				);
			}
		}

		$prepared_term = $this-&gt;prepare_item_for_database( $request );

		$term = wp_insert_term( wp_slash( $prepared_term-&gt;name ), $this-&gt;taxonomy, wp_slash( (array) $prepared_term ) );
		if ( is_wp_error( $term ) ) {
			/*
			 * If we&#039;re going to inform the client that the term already exists,
			 * give them the identifier for future use.
			 */
			$term_id = $term-&gt;get_error_data( &#039;term_exists&#039; );
			if ( $term_id ) {
				$existing_term = get_term( $term_id, $this-&gt;taxonomy );
				$term-&gt;add_data( $existing_term-&gt;term_id, &#039;term_exists&#039; );
				$term-&gt;add_data(
					array(
						&#039;status&#039;  =&gt; 400,
						&#039;term_id&#039; =&gt; $term_id,
					)
				);
			}

			return $term;
		}

		$term = get_term( $term[&#039;term_id&#039;], $this-&gt;taxonomy );

		/**
		 * Fires after a single term is created or updated via the REST API.
		 *
		 * The dynamic portion of the hook name, `$this-&gt;taxonomy`, refers to the taxonomy slug.
		 *
		 * Possible hook names include:
		 *
		 *  - `rest_insert_category`
		 *  - `rest_insert_post_tag`
		 *
		 * @since 4.7.0
		 *
		 * @param WP_Term         $term     Inserted or updated term object.
		 * @param WP_REST_Request $request  Request object.
		 * @param bool            $creating True when creating a term, false when updating.
		 */
		do_action( &quot;rest_insert_{$this-&gt;taxonomy}&quot;, $term, $request, true );

		$schema = $this-&gt;get_item_schema();
		if ( ! empty( $schema[&#039;properties&#039;][&#039;meta&#039;] ) &amp;&amp; isset( $request[&#039;meta&#039;] ) ) {
			$meta_update = $this-&gt;meta-&gt;update_value( $request[&#039;meta&#039;], $term-&gt;term_id );

			if ( is_wp_error( $meta_update ) ) {
				return $meta_update;
			}
		}

		$fields_update = $this-&gt;update_additional_fields_for_object( $term, $request );

		if ( is_wp_error( $fields_update ) ) {
			return $fields_update;
		}

		$request-&gt;set_param( &#039;context&#039;, &#039;edit&#039; );

		/**
		 * Fires after a single term is completely created or updated via the REST API.
		 *
		 * The dynamic portion of the hook name, `$this-&gt;taxonomy`, refers to the taxonomy slug.
		 *
		 * Possible hook names include:
		 *
		 *  - `rest_after_insert_category`
		 *  - `rest_after_insert_post_tag`
		 *
		 * @since 5.0.0
		 *
		 * @param WP_Term         $term     Inserted or updated term object.
		 * @param WP_REST_Request $request  Request object.
		 * @param bool            $creating True when creating a term, false when updating.
		 */
		do_action( &quot;rest_after_insert_{$this-&gt;taxonomy}&quot;, $term, $request, true );

		$response = $this-&gt;prepare_item_for_response( $term, $request );
		$response = rest_ensure_response( $response );

		$response-&gt;set_status( 201 );
		$response-&gt;header( &#039;Location&#039;, rest_url( $this-&gt;namespace . &#039;/&#039; . $this-&gt;rest_base . &#039;/&#039; . $term-&gt;term_id ) );

		return $response;
	}

	/**
	 * Checks if a request has access to update the specified term.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has access to update the item, false or WP_Error object otherwise.
	 */
	public function update_item_permissions_check( $request ) {
		$term = $this-&gt;get_term( $request[&#039;id&#039;] );

		if ( is_wp_error( $term ) ) {
			return $term;
		}

		if ( ! current_user_can( &#039;edit_term&#039;, $term-&gt;term_id ) ) {
			return new WP_Error(
				&#039;rest_cannot_update&#039;,
				__( &#039;Sorry, you are not allowed to edit this term.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		return true;
	}

	/**
	 * Updates a single term from a taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function update_item( $request ) {
		$term = $this-&gt;get_term( $request[&#039;id&#039;] );
		if ( is_wp_error( $term ) ) {
			return $term;
		}

		if ( isset( $request[&#039;parent&#039;] ) ) {
			if ( ! is_taxonomy_hierarchical( $this-&gt;taxonomy ) ) {
				return new WP_Error(
					&#039;rest_taxonomy_not_hierarchical&#039;,
					__( &#039;Cannot set parent term, taxonomy is not hierarchical.&#039; ),
					array( &#039;status&#039; =&gt; 400 )
				);
			}

			$parent = get_term( (int) $request[&#039;parent&#039;], $this-&gt;taxonomy );

			if ( ! $parent ) {
				return new WP_Error(
					&#039;rest_term_invalid&#039;,
					__( &#039;Parent term does not exist.&#039; ),
					array( &#039;status&#039; =&gt; 400 )
				);
			}
		}

		$prepared_term = $this-&gt;prepare_item_for_database( $request );

		// Only update the term if we have something to update.
		if ( ! empty( $prepared_term ) ) {
			$update = wp_update_term( $term-&gt;term_id, $term-&gt;taxonomy, wp_slash( (array) $prepared_term ) );

			if ( is_wp_error( $update ) ) {
				return $update;
			}
		}

		$term = get_term( $term-&gt;term_id, $this-&gt;taxonomy );

		/** This action is documented in wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php */
		do_action( &quot;rest_insert_{$this-&gt;taxonomy}&quot;, $term, $request, false );

		$schema = $this-&gt;get_item_schema();
		if ( ! empty( $schema[&#039;properties&#039;][&#039;meta&#039;] ) &amp;&amp; isset( $request[&#039;meta&#039;] ) ) {
			$meta_update = $this-&gt;meta-&gt;update_value( $request[&#039;meta&#039;], $term-&gt;term_id );

			if ( is_wp_error( $meta_update ) ) {
				return $meta_update;
			}
		}

		$fields_update = $this-&gt;update_additional_fields_for_object( $term, $request );

		if ( is_wp_error( $fields_update ) ) {
			return $fields_update;
		}

		$request-&gt;set_param( &#039;context&#039;, &#039;edit&#039; );

		/** This action is documented in wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php */
		do_action( &quot;rest_after_insert_{$this-&gt;taxonomy}&quot;, $term, $request, false );

		$response = $this-&gt;prepare_item_for_response( $term, $request );

		return rest_ensure_response( $response );
	}

	/**
	 * Checks if a request has access to delete the specified term.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has access to delete the item, otherwise false or WP_Error object.
	 */
	public function delete_item_permissions_check( $request ) {
		$term = $this-&gt;get_term( $request[&#039;id&#039;] );

		if ( is_wp_error( $term ) ) {
			return $term;
		}

		if ( ! current_user_can( &#039;delete_term&#039;, $term-&gt;term_id ) ) {
			return new WP_Error(
				&#039;rest_cannot_delete&#039;,
				__( &#039;Sorry, you are not allowed to delete this term.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		return true;
	}

	/**
	 * Deletes a single term from a taxonomy.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function delete_item( $request ) {
		$term = $this-&gt;get_term( $request[&#039;id&#039;] );
		if ( is_wp_error( $term ) ) {
			return $term;
		}

		$force = isset( $request[&#039;force&#039;] ) ? (bool) $request[&#039;force&#039;] : false;

		// We don&#039;t support trashing for terms.
		if ( ! $force ) {
			return new WP_Error(
				&#039;rest_trash_not_supported&#039;,
				/* translators: %s: force=true */
				sprintf( __( &quot;Terms do not support trashing. Set &#039;%s&#039; to delete.&quot; ), &#039;force=true&#039; ),
				array( &#039;status&#039; =&gt; 501 )
			);
		}

		$request-&gt;set_param( &#039;context&#039;, &#039;view&#039; );

		$previous = $this-&gt;prepare_item_for_response( $term, $request );

		$retval = wp_delete_term( $term-&gt;term_id, $term-&gt;taxonomy );

		if ( ! $retval ) {
			return new WP_Error(
				&#039;rest_cannot_delete&#039;,
				__( &#039;The term cannot be deleted.&#039; ),
				array( &#039;status&#039; =&gt; 500 )
			);
		}

		$response = new WP_REST_Response();
		$response-&gt;set_data(
			array(
				&#039;deleted&#039;  =&gt; true,
				&#039;previous&#039; =&gt; $previous-&gt;get_data(),
			)
		);

		/**
		 * Fires after a single term is deleted via the REST API.
		 *
		 * The dynamic portion of the hook name, `$this-&gt;taxonomy`, refers to the taxonomy slug.
		 *
		 * Possible hook names include:
		 *
		 *  - `rest_delete_category`
		 *  - `rest_delete_post_tag`
		 *
		 * @since 4.7.0
		 *
		 * @param WP_Term          $term     The deleted term.
		 * @param WP_REST_Response $response The response data.
		 * @param WP_REST_Request  $request  The request sent to the API.
		 */
		do_action( &quot;rest_delete_{$this-&gt;taxonomy}&quot;, $term, $response, $request );

		return $response;
	}

	/**
	 * Prepares a single term for create or update.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_REST_Request $request Request object.
	 * @return object Term object.
	 */
	public function prepare_item_for_database( $request ) {
		$prepared_term = new stdClass();

		$schema = $this-&gt;get_item_schema();
		if ( isset( $request[&#039;name&#039;] ) &amp;&amp; ! empty( $schema[&#039;properties&#039;][&#039;name&#039;] ) ) {
			$prepared_term-&gt;name = $request[&#039;name&#039;];
		}

		if ( isset( $request[&#039;slug&#039;] ) &amp;&amp; ! empty( $schema[&#039;properties&#039;][&#039;slug&#039;] ) ) {
			$prepared_term-&gt;slug = $request[&#039;slug&#039;];
		}

		if ( isset( $request[&#039;taxonomy&#039;] ) &amp;&amp; ! empty( $schema[&#039;properties&#039;][&#039;taxonomy&#039;] ) ) {
			$prepared_term-&gt;taxonomy = $request[&#039;taxonomy&#039;];
		}

		if ( isset( $request[&#039;description&#039;] ) &amp;&amp; ! empty( $schema[&#039;properties&#039;][&#039;description&#039;] ) ) {
			$prepared_term-&gt;description = $request[&#039;description&#039;];
		}

		if ( isset( $request[&#039;parent&#039;] ) &amp;&amp; ! empty( $schema[&#039;properties&#039;][&#039;parent&#039;] ) ) {
			$parent_term_id   = 0;
			$requested_parent = (int) $request[&#039;parent&#039;];

			if ( $requested_parent ) {
				$parent_term = get_term( $requested_parent, $this-&gt;taxonomy );

				if ( $parent_term instanceof WP_Term ) {
					$parent_term_id = $parent_term-&gt;term_id;
				}
			}

			$prepared_term-&gt;parent = $parent_term_id;
		}

		/**
		 * Filters term data before inserting term via the REST API.
		 *
		 * The dynamic portion of the hook name, `$this-&gt;taxonomy`, refers to the taxonomy slug.
		 *
		 * Possible hook names include:
		 *
		 *  - `rest_pre_insert_category`
		 *  - `rest_pre_insert_post_tag`
		 *
		 * @since 4.7.0
		 *
		 * @param object          $prepared_term Term object.
		 * @param WP_REST_Request $request       Request object.
		 */
		return apply_filters( &quot;rest_pre_insert_{$this-&gt;taxonomy}&quot;, $prepared_term, $request );
	}

	/**
	 * Prepares a single term output for response.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_Term         $item    Term object.
	 * @param WP_REST_Request $request Request object.
	 * @return WP_REST_Response Response object.
	 */
	public function prepare_item_for_response( $item, $request ) {

		$fields = $this-&gt;get_fields_for_response( $request );
		$data   = array();

		if ( in_array( &#039;id&#039;, $fields, true ) ) {
			$data[&#039;id&#039;] = (int) $item-&gt;term_id;
		}

		if ( in_array( &#039;count&#039;, $fields, true ) ) {
			$data[&#039;count&#039;] = (int) $item-&gt;count;
		}

		if ( in_array( &#039;description&#039;, $fields, true ) ) {
			$data[&#039;description&#039;] = $item-&gt;description;
		}

		if ( in_array( &#039;link&#039;, $fields, true ) ) {
			$data[&#039;link&#039;] = get_term_link( $item );
		}

		if ( in_array( &#039;name&#039;, $fields, true ) ) {
			$data[&#039;name&#039;] = $item-&gt;name;
		}

		if ( in_array( &#039;slug&#039;, $fields, true ) ) {
			$data[&#039;slug&#039;] = $item-&gt;slug;
		}

		if ( in_array( &#039;taxonomy&#039;, $fields, true ) ) {
			$data[&#039;taxonomy&#039;] = $item-&gt;taxonomy;
		}

		if ( in_array( &#039;parent&#039;, $fields, true ) ) {
			$data[&#039;parent&#039;] = (int) $item-&gt;parent;
		}

		if ( in_array( &#039;meta&#039;, $fields, true ) ) {
			$data[&#039;meta&#039;] = $this-&gt;meta-&gt;get_value( $item-&gt;term_id, $request );
		}

		$context = ! empty( $request[&#039;context&#039;] ) ? $request[&#039;context&#039;] : &#039;view&#039;;
		$data    = $this-&gt;add_additional_fields_to_object( $data, $request );
		$data    = $this-&gt;filter_response_by_context( $data, $context );

		$response = rest_ensure_response( $data );

		if ( rest_is_field_included( &#039;_links&#039;, $fields ) || rest_is_field_included( &#039;_embedded&#039;, $fields ) ) {
			$response-&gt;add_links( $this-&gt;prepare_links( $item ) );
		}

		/**
		 * Filters the term data for a REST API response.
		 *
		 * The dynamic portion of the hook name, `$this-&gt;taxonomy`, refers to the taxonomy slug.
		 *
		 * Possible hook names include:
		 *
		 *  - `rest_prepare_category`
		 *  - `rest_prepare_post_tag`
		 *
		 * Allows modification of the term data right before it is returned.
		 *
		 * @since 4.7.0
		 *
		 * @param WP_REST_Response  $response  The response object.
		 * @param WP_Term           $item      The original term object.
		 * @param WP_REST_Request   $request   Request used to generate the response.
		 */
		return apply_filters( &quot;rest_prepare_{$this-&gt;taxonomy}&quot;, $response, $item, $request );
	}

	/**
	 * Prepares links for the request.
	 *
	 * @since 4.7.0
	 *
	 * @param WP_Term $term Term object.
	 * @return array Links for the given term.
	 */
	protected function prepare_links( $term ) {
		$links = array(
			&#039;self&#039;       =&gt; array(
				&#039;href&#039; =&gt; rest_url( rest_get_route_for_term( $term ) ),
			),
			&#039;collection&#039; =&gt; array(
				&#039;href&#039; =&gt; rest_url( rest_get_route_for_taxonomy_items( $this-&gt;taxonomy ) ),
			),
			&#039;about&#039;      =&gt; array(
				&#039;href&#039; =&gt; rest_url( sprintf( &#039;wp/v2/taxonomies/%s&#039;, $this-&gt;taxonomy ) ),
			),
		);

		if ( $term-&gt;parent ) {
			$parent_term = get_term( (int) $term-&gt;parent, $term-&gt;taxonomy );

			if ( $parent_term ) {
				$links[&#039;up&#039;] = array(
					&#039;href&#039;       =&gt; rest_url( rest_get_route_for_term( $parent_term ) ),
					&#039;embeddable&#039; =&gt; true,
				);
			}
		}

		$taxonomy_obj = get_taxonomy( $term-&gt;taxonomy );

		if ( empty( $taxonomy_obj-&gt;object_type ) ) {
			return $links;
		}

		$post_type_links = array();

		foreach ( $taxonomy_obj-&gt;object_type as $type ) {
			$rest_path = rest_get_route_for_post_type_items( $type );

			if ( empty( $rest_path ) ) {
				continue;
			}

			$post_type_links[] = array(
				&#039;href&#039; =&gt; add_query_arg( $this-&gt;rest_base, $term-&gt;term_id, rest_url( $rest_path ) ),
			);
		}

		if ( ! empty( $post_type_links ) ) {
			$links[&#039;https://api.w.org/post_type&#039;] = $post_type_links;
		}

		return $links;
	}

	/**
	 * Retrieves the term&#039;s schema, conforming to JSON Schema.
	 *
	 * @since 4.7.0
	 *
	 * @return array Item schema data.
	 */
	public function get_item_schema() {
		if ( $this-&gt;schema ) {
			return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
		}

		$schema = array(
			&#039;$schema&#039;    =&gt; &#039;http://json-schema.org/draft-04/schema#&#039;,
			&#039;title&#039;      =&gt; &#039;post_tag&#039; === $this-&gt;taxonomy ? &#039;tag&#039; : $this-&gt;taxonomy,
			&#039;type&#039;       =&gt; &#039;object&#039;,
			&#039;properties&#039; =&gt; array(
				&#039;id&#039;          =&gt; array(
					&#039;description&#039; =&gt; __( &#039;Unique identifier for the term.&#039; ),
					&#039;type&#039;        =&gt; &#039;integer&#039;,
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;embed&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;count&#039;       =&gt; array(
					&#039;description&#039; =&gt; __( &#039;Number of published posts for the term.&#039; ),
					&#039;type&#039;        =&gt; &#039;integer&#039;,
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;description&#039; =&gt; array(
					&#039;description&#039; =&gt; __( &#039;HTML description of the term.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;edit&#039; ),
				),
				&#039;link&#039;        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;URL of the term.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;format&#039;      =&gt; &#039;uri&#039;,
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;embed&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;name&#039;        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;HTML title for the term.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;embed&#039;, &#039;edit&#039; ),
					&#039;arg_options&#039; =&gt; array(
						&#039;sanitize_callback&#039; =&gt; &#039;sanitize_text_field&#039;,
					),
					&#039;required&#039;    =&gt; true,
				),
				&#039;slug&#039;        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;An alphanumeric identifier for the term unique to its type.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;embed&#039;, &#039;edit&#039; ),
					&#039;arg_options&#039; =&gt; array(
						&#039;sanitize_callback&#039; =&gt; array( $this, &#039;sanitize_slug&#039; ),
					),
				),
				&#039;taxonomy&#039;    =&gt; array(
					&#039;description&#039; =&gt; __( &#039;Type attribution for the term.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;enum&#039;        =&gt; array( $this-&gt;taxonomy ),
					&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;embed&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
			),
		);

		$taxonomy = get_taxonomy( $this-&gt;taxonomy );

		if ( $taxonomy-&gt;hierarchical ) {
			$schema[&#039;properties&#039;][&#039;parent&#039;] = array(
				&#039;description&#039; =&gt; __( &#039;The parent term ID.&#039; ),
				&#039;type&#039;        =&gt; &#039;integer&#039;,
				&#039;context&#039;     =&gt; array( &#039;view&#039;, &#039;edit&#039; ),
			);
		}

		$schema[&#039;properties&#039;][&#039;meta&#039;] = $this-&gt;meta-&gt;get_field_schema();

		$this-&gt;schema = $schema;

		return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
	}

	/**
	 * Retrieves the query params for collections.
	 *
	 * @since 4.7.0
	 *
	 * @return array Collection parameters.
	 */
	public function get_collection_params() {
		$query_params = parent::get_collection_params();
		$taxonomy     = get_taxonomy( $this-&gt;taxonomy );

		$query_params[&#039;context&#039;][&#039;default&#039;] = &#039;view&#039;;

		$query_params[&#039;exclude&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Ensure result set excludes specific IDs.&#039; ),
			&#039;type&#039;        =&gt; &#039;array&#039;,
			&#039;items&#039;       =&gt; array(
				&#039;type&#039; =&gt; &#039;integer&#039;,
			),
			&#039;default&#039;     =&gt; array(),
		);

		$query_params[&#039;include&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Limit result set to specific IDs.&#039; ),
			&#039;type&#039;        =&gt; &#039;array&#039;,
			&#039;items&#039;       =&gt; array(
				&#039;type&#039; =&gt; &#039;integer&#039;,
			),
			&#039;default&#039;     =&gt; array(),
		);

		if ( ! $taxonomy-&gt;hierarchical ) {
			$query_params[&#039;offset&#039;] = array(
				&#039;description&#039; =&gt; __( &#039;Offset the result set by a specific number of items.&#039; ),
				&#039;type&#039;        =&gt; &#039;integer&#039;,
			);
		}

		$query_params[&#039;order&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Order sort attribute ascending or descending.&#039; ),
			&#039;type&#039;        =&gt; &#039;string&#039;,
			&#039;default&#039;     =&gt; &#039;asc&#039;,
			&#039;enum&#039;        =&gt; array(
				&#039;asc&#039;,
				&#039;desc&#039;,
			),
		);

		$query_params[&#039;orderby&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Sort collection by term attribute.&#039; ),
			&#039;type&#039;        =&gt; &#039;string&#039;,
			&#039;default&#039;     =&gt; &#039;name&#039;,
			&#039;enum&#039;        =&gt; array(
				&#039;id&#039;,
				&#039;include&#039;,
				&#039;name&#039;,
				&#039;slug&#039;,
				&#039;include_slugs&#039;,
				&#039;term_group&#039;,
				&#039;description&#039;,
				&#039;count&#039;,
			),
		);

		$query_params[&#039;hide_empty&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Whether to hide terms not assigned to any posts.&#039; ),
			&#039;type&#039;        =&gt; &#039;boolean&#039;,
			&#039;default&#039;     =&gt; false,
		);

		if ( $taxonomy-&gt;hierarchical ) {
			$query_params[&#039;parent&#039;] = array(
				&#039;description&#039; =&gt; __( &#039;Limit result set to terms assigned to a specific parent.&#039; ),
				&#039;type&#039;        =&gt; &#039;integer&#039;,
			);
		}

		$query_params[&#039;post&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Limit result set to terms assigned to a specific post.&#039; ),
			&#039;type&#039;        =&gt; &#039;integer&#039;,
			&#039;default&#039;     =&gt; null,
		);

		$query_params[&#039;slug&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Limit result set to terms with one or more specific slugs.&#039; ),
			&#039;type&#039;        =&gt; &#039;array&#039;,
			&#039;items&#039;       =&gt; array(
				&#039;type&#039; =&gt; &#039;string&#039;,
			),
		);

		/**
		 * Filters collection parameters for the terms controller.
		 *
		 * The dynamic part of the filter `$this-&gt;taxonomy` refers to the taxonomy
		 * slug for the controller.
		 *
		 * This filter registers the collection parameter, but does not map the
		 * collection parameter to an internal WP_Term_Query parameter.  Use the
		 * `rest_{$this-&gt;taxonomy}_query` filter to set WP_Term_Query parameters.
		 *
		 * @since 4.7.0
		 *
		 * @param array       $query_params JSON Schema-formatted collection parameters.
		 * @param WP_Taxonomy $taxonomy     Taxonomy object.
		 */
		return apply_filters( &quot;rest_{$this-&gt;taxonomy}_collection_params&quot;, $query_params, $taxonomy );
	}

	/**
	 * Checks that the taxonomy is valid.
	 *
	 * @since 4.7.0
	 *
	 * @param string $taxonomy Taxonomy to check.
	 * @return bool Whether the taxonomy is allowed for REST management.
	 */
	protected function check_is_taxonomy_allowed( $taxonomy ) {
		$taxonomy_obj = get_taxonomy( $taxonomy );
		if ( $taxonomy_obj &amp;&amp; ! empty( $taxonomy_obj-&gt;show_in_rest ) ) {
			return true;
		}
		return false;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2F4xpips.net%2Fwp-includes%2Frest-api%2Fendpoints'>⬅ Back to Directory</a>