WP_REST_Request::set_param() WordPress Method

The WP_REST_Request::set_param() method allows you to set a parameter for a request. This is useful if you need to set a parameter that is not directly available in the request URL.

WP_REST_Request::set_param( string $key, mixed $value ) #

Sets a parameter on the request.


Description

If the given parameter key exists in any parameter type an update will take place, otherwise a new param will be created in the first parameter type (respecting get_parameter_order()).


Top ↑

Parameters

$key

(string)(Required)Parameter name.

$value

(mixed)(Required)Parameter value.


Top ↑

Source

File: wp-includes/rest-api/class-wp-rest-request.php

	public function set_param( $key, $value ) {
		$order     = $this->get_parameter_order();
		$found_key = false;

		foreach ( $order as $type ) {
			if ( 'defaults' !== $type && is_array( $this->params[ $type ] ) && array_key_exists( $key, $this->params[ $type ] ) ) {
				$this->params[ $type ][ $key ] = $value;
				$found_key                     = true;
			}
		}

		if ( ! $found_key ) {
			$this->params[ $order[0] ][ $key ] = $value;
		}
	}


Top ↑

Changelog

Changelog
VersionDescription
4.4.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.