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 = 0 )

Parameters

$cat_namestringoptional

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

$beforestringoptional

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

$afterstringoptional

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

$betweenstringoptional

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

$show_imagesbooloptional

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

$orderbystringoptional

The order to output the links. E.g. 'id', 'name', 'url', 'description', 'rating', or 'owner'. Default 'id'. 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_descriptionbooloptional

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

$show_ratingbooloptional

Show rating stars/chars. Default false.Default: false

$limitintoptional

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

$show_updatedintoptional

Whether to show last updated timestamp. Default 0.Default: 0

Uses · 3

• _deprecated_function()Marks a function as deprecated and inform when it has been used.
• get_term_by()Gets all term data from database by term field and data.
• get_links()Gets the links associated with category by ID.

Used by · 1

• get_linksbyname_withrating()Gets the links associated with category 'cat_name' and display rating stars/chars.

Source

View on Trac ↗View on GitHub ↗

402function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',403						$show_description = true, $show_rating = false,404						$limit = -1, $show_updated = 0) {405	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );406 407	$cat_id = -1;408	$cat = get_term_by('name', $cat_name, 'link_category');409	if ( $cat )410		$cat_id = $cat->term_id;411 412	get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated);413}

History

Introduced in 0.71. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-includes/deprecated.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.