WordPress开发手册:get_linksbyname()

函数原型

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 )

函数描述

是否弃用

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

函数参数

$cat_name
string
Optional

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

Default: "noname"

$before
string
Optional

The HTML to output before the link.

Default: ''

$after
string
Optional

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

Default: '<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: " "

$show_images
bool
Optional

Whether to show images (if defined).

Default: true

$orderby
string
Optional

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_description
bool
Optional

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

Default: true

$show_rating
bool
Optional

Show rating stars/chars.

Default: false

$limit
int
Optional

Limit to X entries. If not specified, all entries are shown.

Default: -1

$show_updated
int
Optional

Whether to show last updated timestamp. Default 0.

函数返回值

函数位置

函数源码

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

源码链接

WordPress
Github

变更日志