函数原型
get_links_withrating( int $category = -1, string $before = ”, string $after = ‘<br />’, string $between = " ", bool $show_images = true, string $orderby = ‘id’, bool $show_description = true, int $limit = -1, int $show_updated )
函数描述
Gets the links associated with category n and display rating stars/chars.
是否弃用
Warning: This function has been deprecated. Use get_bookmarks() instead.
函数参数
-
$category
int
Optional - The category to use. If no category supplied, uses all.
Default 0.Default:
-1 -
$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 -
$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.
函数返回值
无
函数位置
File: wp-includes/deprecated.php.
函数源码
function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
$orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
}
源码链接
变更日志
| Version | Description |
|---|---|
| 2.1.0 | Use get_bookmarks() |
| 0.71 | Introduced. |

