get_bookmarks │ filter-hook │ WP 2.1.0

Filters the returned list of bookmarks.

The first time the hook is evaluated in this file, it returns the cached bookmarks list. The second evaluation returns a cached bookmarks list if the link category is passed but does not exist. The third evaluation returns the full cached results.

Usage

add_filter( 'get_bookmarks', 'wp_kama_get_bookmarks_filter', 10, 2 );

/**
 * Function for `get_bookmarks` filter-hook.
 * 
 * @param array $bookmarks   List of the cached bookmarks.
 * @param array $parsed_args An array of bookmark query arguments.
 *
 * @return array
 */
function wp_kama_get_bookmarks_filter( $bookmarks, $parsed_args ){

	// filter...
	return $bookmarks;
}

$bookmarks(array)

List of the cached bookmarks.

$parsed_args(array)

An array of bookmark query arguments.

Changelog

Where the hook is called

return apply_filters( 'get_bookmarks', $bookmarks, $parsed_args );

return apply_filters( 'get_bookmarks', array(), $parsed_args );

return apply_filters( 'get_bookmarks', $results, $parsed_args );

Where the hook is used in WordPress