get_linksbyname() │ WP 0.71

Gets the links associated with category $cat_name.

No Hooks.

Returns

null. Nothing (null).

Usage

get_linksbyname( $cat_name, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated );

$cat_name(string)

The category name to use. If no match is found, uses all.
Default: 'noname'

$before(string)

The HTML to output before the link.
Default: ''

$after(string)

The HTML to output after the link.
Default: '<br />'

$between(string)

The HTML to output between the link/image and its description. Not used if no image or $show_images is true.
Default: ' '

$show_images(true|false)

Whether to show images (if defined).
Default: true

$orderby(string)

The order to output the links. E.g. 'id', 'name', 'url', 'description', 'rating', or 'owner'. If you start the name with an underscore, the order will be reversed. Specifying 'rand' as the order will return links in a random order.
Default: 'id'

$show_description(true|false)

Whether to show the description if show_images=false/not defined.
Default: true

$show_rating(true|false)

Show rating stars/chars.
Default: false

$limit(int)

Limit to X entries. If not specified, all entries are shown.
Default: -1

$show_updated(int)

Whether to show last updated timestamp.

Notes

• See: get_bookmarks()

Changelog

get_linksbyname() get linksbyname code ^{WP 6.9.1}

function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
						$show_description = true, $show_rating = false,
						$limit = -1, $show_updated = 0) {
	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );

	$cat_id = -1;
	$cat = get_term_by('name', $cat_name, 'link_category');
	if ( $cat )
		$cat_id = $cat->term_id;

	get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated);
}