wordpress函数get_linksbyname()用法示例

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

get_linksbyname( string $cat_name = "noname",  string $before = '',  string $after = '<br />',  string $between = " ",  bool $show_images = true,  string $orderby = 'id',  bool $show_ 描述 = true,  bool $show_rating = false,  int $limit = -1,  int $show_updated )

Gets the links associated with category $cat_name.

描述

参数

$cat_name

(string)
(Optional)
The category name to use. If no match is found uses all.

Default value: "noname"

$before

(string)
(Optional)
The html to output before the link.

Default value: ”

$after

(string)
(Optional)
The html to output after the link.

Default value: ‘<br />’

$between

(string)
(Optional)
The html to output between the link/image and its 描述. Not used if no image or $show_images is true.

Default value: " "

$show_images

(bool)
(Optional)
Whether to show images (if defined).

Default value: true

$orderby

(string)
(Optional)
The order to output the links. E.g. ‘id’, ‘name’, ‘url’, ‘描述’ 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.

Default value: ‘id’

$show_ 描述

(bool)
(Optional)
Whether to show the 描述 if show_images=false/not defined.

Default value: true

$show_rating

(bool)
(Optional)
Show rating stars/chars.

Default value: false

$limit

(int)
(Optional)
Limit to X entries. If not specified, all entries are shown.

Default value: -1

$show_updated

(int)
(Optional)
Whether to show last updated timestamp

源代码

File: wp-includes/deprecated.php

function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
 $show_ 描述 = 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_ 描述, $show_rating, $limit, $show_updated);
}

更新日志

相关函数

Uses

• wp-includes/deprecated.php:
  get_links()
• wp-includes/functions.php:
  _deprecated_function()
• wp-includes/taxonomy.php:
  get_term_by()

Used By

• wp-includes/deprecated.php:
  get_linksbyname_withrating()