get_bookmark_field( string $field, int $bookmark, string $context = 'display' )

Retrieve single bookmark data item or field.

Parameters

$field

(string) (Required) The name of the data field to return.

$bookmark

(int) (Required) The bookmark ID to get field.

$context

(string) (Optional) The context of how the field will be used.

Default value: 'display'

Return

(string|WP_Error)

Source

File: wp-includes/bookmark.php

function get_bookmark_field( $field, $bookmark, $context = 'display' ) {
	$bookmark = (int) $bookmark;
	$bookmark = get_bookmark( $bookmark );

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

	if ( ! is_object( $bookmark ) ) {
		return '';
	}

	if ( ! isset( $bookmark->$field ) ) {
		return '';
	}

	return sanitize_bookmark_field( $field, $bookmark->$field, $bookmark->link_id, $context );
}

Changelog

Version Description
2.3.0 Introduced.

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