W3cubDocs

/WordPress

get_linksbyname( string $cat_name = "noname", string $before = '', string $after = '<br />', string $between = " ", bool $show_images = true, string $orderby = 'id', bool $show_description = true, bool $show_rating = false, int $limit = -1, int $show_updated )

This function has been deprecated. Use get_bookmarks() instead.

Gets the links associated with category $cat_name.

Description

See also

Parameters

$cat_name

(string) (Optional) The category name to use. If no match is found, uses all. Default 'noname'.

Default value: "noname"

$before

(string) (Optional) The HTML to output before the link.

Default value: ''

$after

(string) (Optional) The HTML to output after the link. Default <br />.

Default value: '<br />'

$between

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

Default value: " "

$show_images

(bool) (Optional) Whether to show images (if defined).

Default value: true

$orderby

(string) (Optional) 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 value: 'id'

$show_description

(bool) (Optional) Whether to show the description if show_images=false/not defined.

Default value: true

$show_rating

(bool) (Optional) Show rating stars/chars.

Default value: false

$limit

(int) (Optional) Limit to X entries. If not specified, all entries are shown.

Default value: -1

$show_updated

(int) (Optional) Whether to show last updated timestamp. Default 0.

Source

File: wp-includes/deprecated.php 

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);
}

Uses

Uses Description
wp-includes/deprecated.php: get_links()

Gets the links associated with category by ID.
wp-includes/functions.php: _deprecated_function()

Mark a function as deprecated and inform when it has been used.
wp-includes/taxonomy.php: get_term_by()

Get all Term data from database by Term field and data.

Used By

Used By Description
wp-includes/deprecated.php: get_linksbyname_withrating()

Gets the links associated with category ‘cat_name’ and display rating stars/chars.

Changelog

Version Description
2.1.0 Use get_bookmarks()
0.71 Introduced.

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