# betterlinks/trunk/includes/API/Terms.php

BetterLinks – Link Shortener, Link Cloaking, Redirects, Affiliate Link Manager & MCP, version trunk. 360 lines.

- Page: https://pluginprobe.com/plugins/betterlinks/trunk/code/includes/API/Terms.php
- Raw: https://pluginprobe.com/plugins/betterlinks/trunk/raw/includes/API/Terms.php
- Modified: 2026-08-10T11:09:02+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/betterlinks/trunk/code/includes/API/Terms.php#L10-L20`.

```php
<?php

namespace BetterLinks\API;
if ( ! defined( 'ABSPATH' ) ) { exit; }

use BetterLinks\Traits\ArgumentSchema;
use BetterLinks\Helper;

class Terms extends Controller
{

	use \BetterLinks\Traits\Terms;
	use ArgumentSchema;

	/**
	 * Initialize hooks and option name
	 */
	public function __construct()
	{
		add_action('rest_api_init', array($this, 'register_routes'));
	}

	/**
	 * Register the routes for the objects of the controller.
	 */
	public function register_routes()
	{
		$endpoint = '/terms/';
		register_rest_route(
			$this->namespace,
			$endpoint,
			array(
				array(
					'methods'             => \WP_REST_Server::READABLE,
					'callback'            => array($this, 'get_items'),
					'permission_callback' => array($this, 'get_items_permissions_check'),
					'args'                => $this->get_terms_schema(),
				),
			)
		);
		register_rest_route(
			$this->namespace,
			$endpoint . 'tags',
			array(
				array(
					'methods'             => \WP_REST_Server::READABLE,
					'callback'            => array($this, 'get_tags'),
					'permission_callback' => array($this, 'get_items_permissions_check'),
					'args'                => $this->get_terms_schema(),
				),
			)
		);

		register_rest_route(
			$this->namespace,
			$endpoint . 'categories',
			array(
				array(
					'methods'             => \WP_REST_Server::READABLE,
					'callback'            => array($this, 'get_categories'),
					'permission_callback' => array($this, 'get_items_permissions_check'),
					'args'                => $this->get_terms_schema(),
				),
			)
		);

		register_rest_route(
			$this->namespace,
			$endpoint,
			array(
				array(
					'methods'             => \WP_REST_Server::CREATABLE,
					'callback'            => array($this, 'create_item'),
					'permission_callback' => array($this, 'permissions_check'),
					'args'                => $this->get_terms_schema(),
				),
			)
		);

		register_rest_route(
			$this->namespace,
			$endpoint,
			array(
				array(
					'methods'             => \WP_REST_Server::EDITABLE,
					'callback'            => array($this, 'update_item'),
					'permission_callback' => array($this, 'permissions_check'),
					'args'                => $this->get_terms_schema(),
				),
			)
		);

		register_rest_route(
			$this->namespace,
			$endpoint,
			array(
				array(
					'methods'             => \WP_REST_Server::DELETABLE,
					'callback'            => array($this, 'delete_item'),
					'permission_callback' => array($this, 'permissions_check'),
					'args'                => $this->get_terms_schema(),
				),
			)
		);
	}

	public function get_tags()
	{
		$results = $this->get_all_tags();

		// Force refresh analytics data
		$analytic = $this->tags_analytic(true);

		return new \WP_REST_Response(
			array(
				'success' => true,
				'data'    => array(
					'results' => $results,
					'analytic' => $analytic
				),
			),
			200
		);
	}

	public function get_categories()
	{
		$results = $this->get_all_categories();

		// Force refresh analytics data
		$analytic = $this->categories_analytic(true);

		return new \WP_REST_Response(
			array(
				'success' => true,
				'data'    => array(
					'results' => $results,
					'analytic' => $analytic
				),
			),
			200
		);
	}
	/**
	 * Get betterlinks
	 *
	 * @param WP_REST_Request $request Full data about the request.
	 * @return WP_Error|WP_REST_Request
	 */
	public function get_items($request)
	{
		$query_params = $request->get_query_params();
		$results      = $this->get_all_terms_data($query_params);

		if (count($results) <= 0) {
			$_term = array(
				'term_name' => 'Uncategorized',
				'term_slug' => 'uncategorized',
				'term_type' => 'category',
			);
			$id    = Helper::insert_term($_term);
			if ($id) {
				$_term['ID']         = $id;
				$_term['term_order'] = 0;
			}
			$results = array($_term);
		}

		return new \WP_REST_Response(
			array(
				'success' => true,
				'data'    => $results,
			),
			200
		);
	}

	/**
	 * Create OR Update betterlinks
	 *
	 * @param WP_REST_Request $request Full data about the request.
	 * @return WP_Error|WP_REST_Request
	 */
	public function create_item($request)
	{
		delete_transient(BETTERLINKS_CACHE_LINKS_NAME);
		$request = $request->get_params();

		$args    = array(
			'ID'        => (isset($request['params']['ID']) ? absint(sanitize_text_field($request['params']['ID'])) : 0),
			'term_name' => (isset($request['params']['term_name']) ? sanitize_text_field($request['params']['term_name']) : ''),
			'term_slug' => (isset($request['params']['term_slug']) ? sanitize_text_field($request['params']['term_slug']) : ''),
			'term_type' => (isset($request['params']['term_type']) ? sanitize_text_field($request['params']['term_type']) : ''),
		);
		$is_update = \BetterLinks\Helper::is_term_exists($args['ID'], $args['term_type']);

		if (empty($args['term_slug'])) return;

		if ($is_update) {
			if ($args['term_type'] === 'category') {
				// For categories, convert to the format expected by update_term
				$category_args = array(
					'cat_id' => $args['ID'],
					'cat_name' => $args['term_name'],
					'cat_slug' => $args['term_slug'],
				);
				$results = $this->update_term($category_args);
			} else {
				// For tags, use the existing update_tag method
				$results = $this->update_tag($args);
			}
			return new \WP_REST_Response(
				array(
					'success' => true,
					'update' => true,
					'data'    => $results,
				),
				200
			);
		}
		$results = $this->create_term($args);
		return new \WP_REST_Response(
			array(
				'success' => true,
				'data'    => $results,
			),
			200
		);
	}

	/**
	 * Create OR Update betterlinks
	 *
	 * @param WP_REST_Request $request Full data about the request.
	 * @return WP_Error|WP_REST_Request
	 */
	public function update_item($request)
	{
		delete_transient(BETTERLINKS_CACHE_LINKS_NAME);
		$request = $request->get_params();
		$args    = array(
			'cat_id'   => (isset($request['params']['ID']) ? absint(sanitize_text_field($request['params']['ID'])) : 0),
			'cat_name' => (isset($request['params']['term_name']) ? sanitize_text_field($request['params']['term_name']) : ''),
			'cat_slug' => (isset($request['params']['term_slug']) ? sanitize_text_field($request['params']['term_slug']) : ''),
		);

		// Protected categories (e.g. "Uncategorized", "Link in Bio") cannot be renamed.
		$protected = array_map('intval', (array) apply_filters('betterlinks/protected_term_ids', array(1)));
		if ($args['cat_id'] && in_array((int) $args['cat_id'], $protected, true)) {
			return new \WP_REST_Response(
				array(
					'success' => false,
					'data'    => array(
						'message' => __('This category is protected and cannot be edited.', 'betterlinks'),
						'term_id' => $args['cat_id'],
					),
				),
				403
			);
		}

		$this->update_term($args);

		// `success` must report the outcome of the rename. This used to be
		// is_bool($request['params']['ID']) — ID is an integer, so every successful
		// rename answered success:false and clients showed a failure toast.
		return new \WP_REST_Response(
			array(
				'success' => true,
				'update'  => true,
				'data'    => $request['params'],
			),
			200
		);
	}

	/**
	 * Delete betterlinks
	 *
	 * @param WP_REST_Request $request Full data about the request.
	 * @return WP_Error|WP_REST_Request
	 */
	public function delete_item($request)
	{
		delete_transient(BETTERLINKS_CACHE_LINKS_NAME);
		$request = $request->get_params();

		// Check if trying to delete the default 'Uncategorized' category (ID: 1)
		// This can come as either cat_id or tag_id parameter
		$term_id_to_delete = null;
		if (isset($request['cat_id'])) {
			$term_id_to_delete = $request['cat_id'];
		} elseif (isset($request['tag_id'])) {
			$term_id_to_delete = $request['tag_id'];
		}

		// No term id means nothing can be deleted. Answering 200/success:true here let a
		// client that sent an undefined id show "Deleted" toasts while the row stayed put,
		// which is how a stale admin bundle looked like a broken delete feature.
		if (!$term_id_to_delete) {
			return new \WP_REST_Response(
				array(
					'success' => false,
					'data'    => array(
						'message' => __('No category or tag ID was supplied.', 'betterlinks'),
					),
				),
				400
			);
		}

		$protected = array_map('intval', (array) apply_filters('betterlinks/protected_term_ids', array(1)));
		if ($term_id_to_delete && in_array((int) $term_id_to_delete, $protected, true)) {
			return new \WP_REST_Response(
				array(
					'success' => false,
					'data'    => array(
						'message' => __('This category is protected and cannot be deleted.', 'betterlinks'),
						'term_id' => $term_id_to_delete,
					),
				),
				403 // Forbidden status code
			);
		}

		$this->delete_term($request);
		return new \WP_REST_Response(
			array(
				'success' => true,
				'data'    => array(
					'cat_id' => $term_id_to_delete,
				),
			),
			200
		);
	}

	/**
	 * Check if a given request has access to update a setting
	 *
	 * @param WP_REST_Request $request Full data about the request.
	 * @return WP_Error|bool
	 */
	public function get_items_permissions_check($request)
	{
		return apply_filters('betterlinks/api/terms_get_items_permissions_check', current_user_can('manage_options'));
	}

	/**
	 * Check if a given request has access to update a setting
	 *
	 * @param WP_REST_Request $request Full data about the request.
	 * @return WP_Error|bool
	 */
	public function permissions_check($request)
	{
		return apply_filters('betterlinks/api/terms_manage_permissions_check', current_user_can('manage_options'));
	}
}

```