获取与id类别关联的链接。

原型

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 )

参数

$category (int) (Optional) 要使用的类别。如果没有提供的类别全部使用

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

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

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

$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) 是否显示上次更新的时间戳

$echo (bool) (Optional) 是否回显结果,或返回它们

返回值

(null|string)  

源文件

路径:wp-includes/deprecated.php

<?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 .= "$aftern";
	} // end while
	if ( !$echo )
		return $output;
	echo $output;
}
...
?>

其他

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