Question

get_bookmark( int|stdClass $bookmark,  string $output = OBJECT,  string $filter = 'raw' )

Retrieve Bookmark data

---

description

---

参数

$bookmark

(int|stdClass) (Required)

$output

(string) (Optional) The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to an stdClass object, an associative array, or a numeric array, respectively.

Default value: OBJECT

$filter

(string) (Optional)

Default value: 'raw'

---

返回值

(array|object|null) Type returned depends on $output value.

---

源代码

File: wp-includes/bookmark.php

function get_bookmark($bookmark, $output = OBJECT, $filter = 'raw') {
	global $wpdb;

	if ( empty($bookmark) ) {
		if ( isset($GLOBALS['link']) )
			$_bookmark = & $GLOBALS['link'];
		else
			$_bookmark = null;
	} elseif ( is_object($bookmark) ) {
		wp_cache_add($bookmark->link_id, $bookmark, 'bookmark');
		$_bookmark = $bookmark;
	} else {
		if ( isset($GLOBALS['link']) && ($GLOBALS['link']->link_id == $bookmark) ) {
			$_bookmark = & $GLOBALS['link'];
		} elseif ( ! $_bookmark = wp_cache_get($bookmark, 'bookmark') ) {
			$_bookmark = $wpdb->get_row($wpdb->prepare("SELECT * FROM $wpdb->links WHERE link_id = %d LIMIT 1", $bookmark));
			if ( $_bookmark ) {
				$_bookmark->link_category = array_unique( wp_get_object_terms( $_bookmark->link_id, 'link_category', array( 'fields' => 'ids' ) ) );
				wp_cache_add( $_bookmark->link_id, $_bookmark, 'bookmark' );
			}
		}
	}

	if ( ! $_bookmark )
		return $_bookmark;

	$_bookmark = sanitize_bookmark($_bookmark, $filter);

	if ( $output == OBJECT ) {
		return $_bookmark;
	} elseif ( $output == ARRAY_A ) {
		return get_object_vars($_bookmark);
	} elseif ( $output == ARRAY_N ) {
		return array_values(get_object_vars($_bookmark));
	} else {
		return $_bookmark;
	}
}

---

更新日志

Version	description
2.1.0	Introduced.

---

相关函数

Uses

• wp-includes/cache.php: wp_cache_add()
• wp-includes/cache.php: wp_cache_get()
• wp-includes/taxonomy.php: wp_get_object_terms()
• wp-includes/bookmark.php: sanitize_bookmark()
• wp-includes/wp-db.php: wpdb::get_row()
• wp-includes/wp-db.php: wpdb::prepare()
Show 1 more use Hide more uses

---

Used By

• wp-admin/includes/ajax-actions.php: wp_ajax_delete_link()
• wp-admin/includes/bookmark.php: get_link_to_edit()
• wp-admin/includes/bookmark.php: wp_update_link()
• wp-includes/deprecated.php: get_link()
• wp-includes/link-template.php: get_edit_bookmark_link()
• wp-includes/link-template.php: edit_bookmark_link()
• wp-includes/bookmark.php: get_bookmark_field()
Show 2 more used by Hide more used by

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Display Bookmark Name

   
   <?php 
   $bookmark = get_bookmark(5);
   echo $bookmark->link_name; 
   ?>
   

   or:

   
   <?php echo get_bookmark(5)->link_name; ?>
   

Display Bookmark as a Link

<?php  
$bookmark = get_bookmark(5);
echo '<a href="'.$bookmark->link_url.'">'.$bookmark->link_name.'</a>';
?>