get_links

Source code

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', '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') * 3600)) . ')';



		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;

}