Question

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

get_links( int $category = -1,  string $before = '',  string $after = '<br />',  string $between = ' ',  bool $show_images = true,  string $orderby = 'name',  bool $show_description = true,  bool $show_rating = false,  int $limit = -1,  int $show_updated = 1,  bool $echo = true )

Gets the links associated with category by id.

---

description

---

参数

$category

(int) (Optional) The category to use. If no category supplied uses all

Default value: -1

$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 description. Not used if no image or show_images == 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', '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.

Default value: 'name'

$show_description

(bool) (Optional) whether to show the description 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

Default value: 1

$echo

(bool) (Optional) whether to echo the results, or return them instead

Default value: true

---

返回值

(null|string)

---

源代码

File: wp-includes/deprecated.php

function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );

	$order = 'ASC';
	if ( substr($orderby, 0, 1) == '_' ) {
		$order = 'DESC';
		$orderby = substr($orderby, 1);
	}

	if ( $category == -1 ) //get_bookmarks uses '' to signify all categories
		$category = '';

	$results = get_bookmarks(array('category' => $category, 'orderby' => $orderby, 'order' => $order, 'show_updated' => $show_updated, 'limit' => $limit));

	if ( !$results )
		return;

	$output = '';

	foreach ( (array) $results as $row ) {
		if ( !isset($row->recently_updated) )
			$row->recently_updated = false;
		$output .= $before;
		if ( $show_updated && $row->recently_updated )
			$output .= get_option('links_recently_updated_prepend');
		$the_link = '#';
		if ( !empty($row->link_url) )
			$the_link = esc_url($row->link_url);
		$rel = $row->link_rel;
		if ( '' != $rel )
			$rel = ' rel="' . $rel . '"';

		$desc = esc_attr(sanitize_bookmark_field('link_description', $row->link_description, $row->link_id, 'display'));
		$name = esc_attr(sanitize_bookmark_field('link_name', $row->link_name, $row->link_id, 'display'));
		$title = $desc;

		if ( $show_updated )
			if (substr($row->link_updated_f, 0, 2) != '00')
				$title .= ' ('.__('Last updated') . ' ' . date(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * HOUR_IN_SECONDS)) . ')';

		if ( '' != $title )
			$title = ' title="' . $title . '"';

		$alt = ' alt="' . $name . '"';

		$target = $row->link_target;
		if ( '' != $target )
			$target = ' target="' . $target . '"';

		$output .= '<a href="' . $the_link . '"' . $rel . $title . $target. '>';

		if ( $row->link_image != null && $show_images ) {
			if ( strpos($row->link_image, 'http') !== false )
				$output .= "<img src=\"$row->link_image\" $alt $title />";
			else // If it's a relative path
				$output .= "<img src=\"" . get_option('siteurl') . "$row->link_image\" $alt $title />";
		} else {
			$output .= $name;
		}

		$output .= '</a>';

		if ( $show_updated && $row->recently_updated )
			$output .= get_option('links_recently_updated_append');

		if ( $show_description && '' != $desc )
			$output .= $between . $desc;

		if ($show_rating) {
			$output .= $between . get_linkrating($row);
		}

		$output .= "$after\n";
	} // end while

	if ( !$echo )
		return $output;
	echo $output;
}

---

更新日志

Version	description
2.1.0	Use get_bookmarks()
0.71	Introduced.

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/formatting.php: esc_url()
• wp-includes/formatting.php: esc_attr()
• wp-includes/deprecated.php: get_linkrating()
• wp-includes/functions.php: _deprecated_function()
• wp-includes/option.php: get_option()
• wp-includes/bookmark.php: sanitize_bookmark_field()
• wp-includes/bookmark.php: get_bookmarks()
Show 3 more uses Hide more uses

---

Used By

• wp-includes/deprecated.php: get_links_list()
• wp-includes/deprecated.php: get_linksbyname()
• wp-includes/deprecated.php: get_links_withrating()

---

User Contributed Notes