<?php

/**

 * REST API functions.

 *

 * @package WordPress

 * @subpackage REST_API

 * @since 4.4.0

 */

/**

 * Version number for our API.

 *

 * @var string

 */

define( 'REST_API_VERSION', '2.0' );

/**

 * Registers a REST API route.

 *

 * Note: Do not use before the {@see 'rest_api_init'} hook.

 *

 * @since 4.4.0

 * @since 5.1.0 Added a `_doing_it_wrong()` notice when not called on or after the `rest_api_init` hook.

 * @since 5.5.0 Added a `_doing_it_wrong()` notice when the required `permission_callback` argument is not set.

 *

 * @param string $namespace The first URL segment after core prefix. Should be unique to your package/plugin.

 * @param string $route     The base URL for route you are adding.

 * @param array  $args      Optional. Either an array of options for the endpoint, or an array of arrays for

 *                          multiple methods. Default empty array.

 * @param bool   $override  Optional. If the route already exists, should we override it? True overrides,

 *                          false merges (with newer overriding if duplicate keys exist). Default false.

 * @return bool True on success, false on error.

 */

function register_rest_route( $namespace, $route, $args = array(), $override = false ) {

	if ( empty( $namespace ) ) {

		/*

		 * Non-namespaced routes are not allowed, with the exception of the main

		 * and namespace indexes. If you really need to register a

		 * non-namespaced route, call `WP_REST_Server::register_route` directly.

		 */

		_doing_it_wrong( 'register_rest_route', __( 'Routes must be namespaced with plugin or theme name and version.' ), '4.4.0' );

		return false;

	} elseif ( empty( $route ) ) {

		_doing_it_wrong( 'register_rest_route', __( 'Route must be specified.' ), '4.4.0' );

		return false;

	}

	$clean_namespace = trim( $namespace, '/' );

	if ( $clean_namespace !== $namespace ) {

		_doing_it_wrong( __FUNCTION__, __( 'Namespace must not start or end with a slash.' ), '5.4.2' );

	}

	if ( ! did_action( 'rest_api_init' ) ) {

		_doing_it_wrong(

			'register_rest_route',

			sprintf(

				/* translators: %s: rest_api_init */

				__( 'REST API routes must be registered on the %s action.' ),

				'<code>rest_api_init</code>'

			),

			'5.1.0'

		);

	}

	if ( isset( $args['args'] ) ) {

		$common_args = $args['args'];

		unset( $args['args'] );

	} else {

		$common_args = array();

	}

	if ( isset( $args['callback'] ) ) {

		// Upgrade a single set to multiple.

		$args = array( $args );

	}

	$defaults = array(

		'methods'  => 'GET',

		'callback' => null,

		'args'     => array(),

	);

	foreach ( $args as $key => &$arg_group ) {

		if ( ! is_numeric( $key ) ) {

			// Route option, skip here.

			continue;

		}

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

		$arg_group['args'] = array_merge( $common_args, $arg_group['args'] );

		if ( ! isset( $arg_group['permission_callback'] ) ) {

			_doing_it_wrong(

				__FUNCTION__,

				sprintf(

					__( 'The REST API route definition for %1$s is missing the required %2$s argument. For REST API routes that are intended to be public, use %3$s as the permission callback.' ),

					'<code>' . $clean_namespace . '/' . trim( $route, '/' ) . '</code>',

					'<code>permission_callback</code>',

					'<code>__return_true</code>'

				),

				'5.5.0'

			);

		}

	}

	$full_route = '/' . $clean_namespace . '/' . trim( $route, '/' );

	rest_get_server()->register_route( $clean_namespace, $full_route, $args, $override );

	return true;

}

/**

 * Registers a new field on an existing WordPress object type.

 *

 * @since 4.7.0

 *

 * @global array $wp_rest_additional_fields Holds registered fields, organized

 *                                          by object type.

 *

 * @param string|array $object_type Object(s) the field is being registered

 *                                  to, "post"|"term"|"comment" etc.

 * @param string       $attribute   The attribute name.

 * @param array        $args {

 *     Optional. An array of arguments used to handle the registered field.

 *

 *     @type callable|null $get_callback    Optional. The callback function used to retrieve the field value. Default is

 *                                          'null', the field will not be returned in the response. The function will

 *                                          be passed the prepared object data.

 *     @type callable|null $update_callback Optional. The callback function used to set and update the field value. Default

 *                                          is 'null', the value cannot be set or updated. The function will be passed

 *                                          the model object, like WP_Post.

 *                                          Default is 'null', no schema entry will be returned.

 * }

 */

function register_rest_field( $object_type, $attribute, $args = array() ) {

	$defaults = array(

		'get_callback'    => null,

		'update_callback' => null,

		'schema'          => null,

	);

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

	global $wp_rest_additional_fields;

	$object_types = (array) $object_type;

	foreach ( $object_types as $object_type ) {

		$wp_rest_additional_fields[ $object_type ][ $attribute ] = $args;

	}

}

/**

 *

 * @since 4.4.0

 *

 * @see rest_api_register_rewrites()

 * @global WP $wp Current WordPress environment instance.

 */

function rest_api_init() {

	rest_api_register_rewrites();

	global $wp;

	$wp->add_query_var( 'rest_route' );

}

/**

 * Adds REST rewrite rules.

 *

 * @since 4.4.0

 *

 * @see add_rewrite_rule()

 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.

 */

function rest_api_register_rewrites() {

	global $wp_rewrite;

	add_rewrite_rule( '^' . rest_get_url_prefix() . '/?$', 'index.php?rest_route=/', 'top' );

	add_rewrite_rule( '^' . rest_get_url_prefix() . '/(.*)?', 'index.php?rest_route=/$matches[1]', 'top' );

	add_rewrite_rule( '^' . $wp_rewrite->index . '/' . rest_get_url_prefix() . '/?$', 'index.php?rest_route=/', 'top' );

	add_rewrite_rule( '^' . $wp_rewrite->index . '/' . rest_get_url_prefix() . '/(.*)?', 'index.php?rest_route=/$matches[1]', 'top' );

}

/**

 * Registers the default REST API filters.

 *

 * Attached to the {@see 'rest_api_init'} action

 * to make testing and disabling these filters easier.

 *

 * @since 4.4.0

 */

function rest_api_default_filters() {

	if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) {

		// Deprecated reporting.

		add_action( 'deprecated_function_run', 'rest_handle_deprecated_function', 10, 3 );

		add_filter( 'deprecated_function_trigger_error', '__return_false' );

		add_action( 'deprecated_argument_run', 'rest_handle_deprecated_argument', 10, 3 );

		add_filter( 'deprecated_argument_trigger_error', '__return_false' );

		add_action( 'doing_it_wrong_run', 'rest_handle_doing_it_wrong', 10, 3 );

		add_filter( 'doing_it_wrong_trigger_error', '__return_false' );

	}

	// Default serving.

	add_filter( 'rest_pre_serve_request', 'rest_send_cors_headers' );

	add_filter( 'rest_post_dispatch', 'rest_send_allow_header', 10, 3 );

	add_filter( 'rest_post_dispatch', 'rest_filter_response_fields', 10, 3 );

	add_filter( 'rest_pre_dispatch', 'rest_handle_options_request', 10, 3 );

}

/**

 * Registers default REST API routes.

 *

 * @since 4.7.0

 */

function create_initial_rest_routes() {

	foreach ( get_post_types( array( 'show_in_rest' => true ), 'objects' ) as $post_type ) {

		$controller = $post_type->get_rest_controller();

		if ( ! $controller ) {

			continue;

		}

		$controller->register_routes();

		if ( post_type_supports( $post_type->name, 'revisions' ) ) {

			$revisions_controller = new WP_REST_Revisions_Controller( $post_type->name );

			$revisions_controller->register_routes();

		}

		if ( 'attachment' !== $post_type->name ) {

			$autosaves_controller = new WP_REST_Autosaves_Controller( $post_type->name );

			$autosaves_controller->register_routes();

		}

	}

	// Post types.

	$controller = new WP_REST_Post_Types_Controller;

	$controller->register_routes();

	// Post statuses.

	$controller = new WP_REST_Post_Statuses_Controller;

	$controller->register_routes();

	// Taxonomies.

	$controller = new WP_REST_Taxonomies_Controller;

	$controller->register_routes();

	// Terms.

	foreach ( get_taxonomies( array( 'show_in_rest' => true ), 'object' ) as $taxonomy ) {

		$controller = $taxonomy->get_rest_controller();

		if ( ! $controller ) {

			continue;

		}

		$controller->register_routes();

	}

	// Users.

	$controller = new WP_REST_Users_Controller;

	$controller->register_routes();

	// Comments.

	$controller = new WP_REST_Comments_Controller;

	$controller->register_routes();

	/**

	 * Filters the search handlers to use in the REST search controller.

	 *

	 * @since 5.0.0

	 *

	 * @param array $search_handlers List of search handlers to use in the controller. Each search

	 *                               handler instance must extend the `WP_REST_Search_Handler` class.

	 *                               Default is only a handler for posts.

	 */

	$controller = new WP_REST_Search_Controller( $search_handlers );

	$controller->register_routes();

	// Block Renderer.

	$controller = new WP_REST_Block_Renderer_Controller;

	$controller->register_routes();

	// Block Types.

	$controller = new WP_REST_Block_Types_Controller();

	$controller->register_routes();

	// Settings.

	$controller = new WP_REST_Settings_Controller;

	$controller->register_routes();

	// Themes.

	$controller = new WP_REST_Themes_Controller;

	$controller->register_routes();

	// Plugins.

	$controller = new WP_REST_Plugins_Controller();

	$controller->register_routes();

	// Block Directory.

	$controller = new WP_REST_Block_Directory_Controller();

	$controller->register_routes();

}

/**

 * Loads the REST API.

 *

 * @since 4.4.0

 *

 * @global WP $wp Current WordPress environment instance.

 */

function rest_api_loaded() {

	if ( empty( $GLOBALS['wp']->query_vars['rest_route'] ) ) {

		return;

	}

	/**

	 * Whether this is a REST Request.

	 *

	 * @since 4.4.0

	 * @var bool

	 */

	define( 'REST_REQUEST', true );

	// Initialize the server.

	$server = rest_get_server();

	// Fire off the request.

	$route = untrailingslashit( $GLOBALS['wp']->query_vars['rest_route'] );

	if ( empty( $route ) ) {

		$route = '/';

	}

	$server->serve_request( $route );

	// We're done.

	die();

}

/**

 * Retrieves the URL prefix for any API resource.

 *

 * @since 4.4.0

 *

 * @return string Prefix.

 */

function rest_get_url_prefix() {

	/**

	 * Filters the REST URL prefix.

	 *

	 * @since 4.4.0

	 *

	 * @param string $prefix URL prefix. Default 'wp-json'.

	 */

	return apply_filters( 'rest_url_prefix', 'wp-json' );

}

/**

 * Retrieves the URL to a REST endpoint on a site.

 *

 * Note: The returned URL is NOT escaped.

 *

 * @since 4.4.0

 *

 * @todo Check if this is even necessary

 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.

 *

 * @return string Full URL to the endpoint.

 */

function get_rest_url( $blog_id = null, $path = '/', $scheme = 'rest' ) {

	if ( empty( $path ) ) {

		$path = '/';

	}

	$path = '/' . ltrim( $path, '/' );

	if ( is_multisite() && get_blog_option( $blog_id, 'permalink_structure' ) || get_option( 'permalink_structure' ) ) {

		global $wp_rewrite;

		if ( $wp_rewrite->using_index_permalinks() ) {

			$url = get_home_url( $blog_id, $wp_rewrite->index . '/' . rest_get_url_prefix(), $scheme );

		} else {

			$url = get_home_url( $blog_id, rest_get_url_prefix(), $scheme );

		}

		$url .= $path;

	} else {

		$url = trailingslashit( get_home_url( $blog_id, '', $scheme ) );

		// nginx only allows HTTP/1.0 methods when redirecting from / to /index.php.

		// To work around this, we manually add index.php to the URL, avoiding the redirect.

		if ( 'index.php' !== substr( $url, 9 ) ) {