WP_REST_Response::add_link( string $rel, string $href, array $attributes = array() )

Adds a link to the response.

Parameters

$rel

(string) (Required) Link relation. Either an IANA registered type, or an absolute URL.

$href

(string) (Required) Target URI for the link.

$attributes

(array) (Optional) Link parameters to send along with the URL.

Default value: array()

Source

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

public function add_link( $rel, $href, $attributes = array() ) {
		if ( empty( $this->links[ $rel ] ) ) {
			$this->links[ $rel ] = array();
		}

		if ( isset( $attributes['href'] ) ) {
			// Remove the href attribute, as it's used for the main URL.
			unset( $attributes['href'] );
		}

		$this->links[ $rel ][] = array(
			'href'       => $href,
			'attributes' => $attributes,
		);
	}

Changelog

Version Description
4.4.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_rest_response/add_link