获取与类别$ cat_name关联的链接。

原型

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 )

参数

$cat_name (string) (Optional)  要使用的类别名称。如果找不到匹配则使用全部。

$before (string) (Optional)  在链接之前输出的html。

$after (string) (Optional)  链接后输出的html。

$between (string) (Optional)  要在链接/图像及其描述之间输出的html。如果没有图像或$ show_images为真,则不使用。

$show_images (bool) (Optional)  是否显示图像(如果已定义)。

$orderby (string) (Optional)  输出链接的顺序。例如。 ‘id’,‘name’,‘url’,‘description’或’rating’。或者也许是老板。如果你使用下划线开始名称,则订单将被撤消。你还可以将“rand”指定为以随机顺序返回链接的顺序。

$show_description (bool) (Optional)  是否显示描述show_images = false /未定义。

$show_rating (bool) (Optional)  显示评分星/字符。

$limit (int) (Optional)  限制为X条目。如果未指定,则显示所有条目。

$show_updated (int) (Optional)  是否显示上次更新的时间戳

源文件

路径:wp-includes/deprecated.php

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

其他

英文文档:https://developer.wordpress.org/reference/functions/get_linksbyname/