get_links

函数



      get_links ( $category = -1, $before = '', $after = '
', $between = ' ', $show_images = true, $orderby = 'name', $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $display = true )

参数

(int)
$category
Optional. The category to use. If no category supplied uses all. Default 0.
Required: 否

Default: -1
(string)
$before
Optional. The HTML to output before the link. Default empty.
Required: 否

Default: (empty)
(string)
$after
Optional. The HTML to output after the link. Default ‘
‘.
Required: 否

Default: ‘
‘
(string)
$between
Optional. The HTML to output between the link/image and its description. Not used if no image or $show_images is true. Default ‘ ‘.
Required: 否

Default: ‘ ‘
(bool)
$show_images
Optional. Whether to show images (if defined). Default true.
Required: 否

Default: true
(string)
$orderby
Optional. The order to output the links. E.g. ‘id’, ‘name’, ‘url’, ‘description’, ‘rating’, or ‘owner’. Default ‘name’. 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.
Required: 否

Default: ‘name’
(bool)
$show_description
Optional. Whether to show the description if show_images=false/not defined. Default true.
Required: 否

Default: true
(bool)
$show_rating
Optional. Show rating stars/chars. Default false.
Required: 否

Default: false
(int)
$limit
Optional. Limit to X entries. If not specified, all entries are shown. Default -1.
Required: 否

Default: -1
(int)
$show_updated
Optional. Whether to show last updated timestamp. Default 1.
Required: 否

Default: 1
(bool)
$display
Whether to display the results, or return them instead.
Required: 否

Default: true

返回值

(null|string)

相关

get_bookmarks()

定义位置

wp-includes/deprecated.php
, line 945

引入: 0.71

弃用: 2.1.0

Gets the links associated with category by ID.

function get_links($category = -1, $before = '', $after = '
', $between = ' ', $show_images = true, $orderby = 'name',
			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $display = 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') . ' ' . gmdate(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 .= '';

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

		$output .= '';

		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 .= "$aftern";
	} // End while.

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