WordPress开发者和主题制作者的搜索引擎



get_linkobjectsbyname ›

Since1.0.1
已弃用2.1.0
get_linkobjectsbyname ( $cat_name = "noname", $orderby = 'name', $limit = -1 )
参数: (3)
  • (string) $cat_name The category name to use. If no match is found uses all.
    Required: No
    默认: "noname"
  • (string) $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. Or maybe owner. If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a random order.
    Required: No
    默认: 'name'
  • (int) $limit Limit to X entries. If not specified, all entries are shown.
    Required: No
    默认: -1
查看:
返回:
  • (array)
定义在:
文档:

Gets an array of link objects associated with category $cat_name.

$links = get_linkobjectsbyname( 'fred' ); foreach ( $links as $link ) { echo '

  • ' . $link->link_name . '
  • '; }



    源码

    function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
    	_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;
    
    	return get_linkobjects($cat_id, $orderby, $limit);
    }